6言語に警告ゼロの基準を設定
Go、TypeScript、SQL、Python、Shell、Markdownの6言語に警告ゼロの品質基準を設け、pre‑commitフックで適用した。
実施時期: 2025
6言語に適用する警告ゼロの基準
状況. 積み重なる警告は徐々に基準を損なう。指摘を無視するたび少しずつ基準が下がり、ビルドが40件出すようになると誰も読まず、本当の問題も背景の雑音の中に埋もれる。多言語コードでは、その雑音の発生源がさらに多かった。
課題. 各言語に共通する妥協のない基準を設け、問題を蓄積せず直す必要があった。
行動. 忙しい週には個人の注意に頼る方針は破れるため、ツールが適用する警告ゼロ方針を導入した。全指摘をエラーとし、逃げ込める警告区分を置かなかった。Goはgolangci‑lint、TypeScriptはESLint、SQLはSQLFluff、PythonはRuff、ShellはShellCheck、Markdownはmarkdownlintで、全体に同じ基準を設けた。行内抑制を禁じ、隠すのでなく修正を必須にした。pre‑commit・pre‑pushで静的検査とテストを実行し、対象の規則やテストで失敗した場合は、それぞれコミットまたはpushを止めるようにした。読みやすさを超えて膨張しないよう、関数・ファイル長の制限も設けた。
結果. 未消化の課題へ先送りせず発生源で修正し、ときどきの大掃除でなく、通常状態としてコードを整えた。言語によらず同じ基準を、意志力でなくツールが守るため、実際に維持できた。

写真: Simedblack / Pixabay 
写真: MiGallery23 / Pixabay
次に読む: プラットフォームの基礎技術方針を策定. すべての実績はこちら: 実績紹介.

