# 6言語に警告ゼロの基準を設定

Go、TypeScript、SQL、Python、Shell、Markdownの6言語に警告ゼロの品質基準を設け、pre‑commitフックで適用した。

2025

状況. 積み重なる警告は徐々に基準を損なう。指摘を無視するたび少しずつ基準が下がり、ビルドが40件出すようになると誰も読まず、本当の問題も背景の雑音の中に埋もれる。多言語コードでは、その雑音の発生源がさらに多かった。

課題. 各言語に共通する妥協のない基準を設け、問題を蓄積せず直す必要があった。

行動. 忙しい週には個人の注意に頼る方針は破れるため、ツールが適用する警告ゼロ方針を導入した。全指摘をエラーとし、逃げ込める警告区分を置かなかった。Goはgolangci‑lint、TypeScriptはESLint、SQLはSQLFluff、PythonはRuff、ShellはShellCheck、Markdownはmarkdownlintで、全体に同じ基準を設けた。行内抑制を禁じ、隠すのでなく修正を必須にした。pre‑commit・pre‑pushで静的検査とテストを実行し、対象の規則やテストで失敗した場合は、それぞれコミットまたはpushを止めるようにした。読みやすさを超えて膨張しないよう、関数・ファイル長の制限も設けた。

結果. 未消化の課題へ先送りせず発生源で修正し、ときどきの大掃除でなく、通常状態としてコードを整えた。言語によらず同じ基準を、意志力でなくツールが守るため、実際に維持できた。

役割: エンジニアリング責任者
=> /ja/categories/devops/ カテゴリー: DevOps
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/testing/ カテゴリー: テスト・品質保証
=> /ja/categories/technical-leadership/ カテゴリー: 技術面の統率
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/devops-cicd/ サービス: DevOps・CI/CD自動化
=> /ja/services/technical-leadership/ サービス: 技術面の統率・コンサルティング

=> https://engineer.company/ja/portfolio/set-a-zero-warnings-bar-across-six-languages/ このページのウェブ版
