はじめに
最近 Zenn のトレンドで「たった数行でコード品質がグッと上がる、CLAUDE.md / AGENTS.md にいつも追記してるやつ」が話題になっていました。
うちのチームでも全プロジェクトの CLAUDE.md に 絶対に入れている鉄板5行 があります。
この5行を入れるだけで、Claude Code（や Codex）の出力品質が体感30〜50%変わります。
この記事では、その5行と「なぜそれを入れるか」の理由を共有します。
鉄板5行（コピペ用）
## 鉄則
- 動かす前に「何をやろうとしているか」を1行で宣言してから着手する
- 既存のコード規約・命名・依存関係を必ず先に確認してから書く
- エラーハンドリングが書けない時は、エラー時にどうするかを聞き返す
- 完了したら「やったこと」「変更したファイル」「次に確認すべきこと」を報告する
- 不明な前提があれば、推測で進めず必ず質問する
これを CLAUDE.md の冒頭か、あるいは ## 鉄則 セクションに入れます。
各行の意図を順に説明します。
1行目: 「何をやろうとしているか」を宣言してから着手
- 動かす前に「何をやろうとしているか」を1行で宣言してから着手する
狙い: AI が「思いつきで実装を始める」のを防ぐ。
複雑なタスクを依頼した時、AI が手順を整理せずいきなり編集を始めると、後で「あれ、何を意図してた？」がブレます。
宣言を強制することで、自分も AI も「これから何をやるか」の合意ができてから着手するフローになります。
2行目: 既存のコード規約・命名・依存関係を先に確認
- 既存のコード規約・命名・依存関係を必ず先に確認してから書く
狙い: 新しい命名規則・新しいライブラリを勝手に持ち込まれるのを防ぐ。
AI は「ベストプラクティス」を持ってきます。でもそれが既存コードと整合しないことが多い。
「existing/auth.ts のパターンに合わせて」と毎回書くのは面倒なので、CLAUDE.md で 常時ルール化 します。
3行目: エラーハンドリングが書けない時は聞き返す
- エラーハンドリングが書けない時は、エラー時にどうするかを聞き返す
狙い: AI が「雑な try/catch でエラーを握りつぶす」のを防ぐ。
エラー処理は実装者の意図が分からないと書けません。AI が独断で catch (e) { console.log(e) } するのを防ぐために、「分からなかったら聞いて」 と先に教えておく。
これだけで、本番障害になりやすいエラー隠蔽が劇的に減ります。
4行目: 完了報告のフォーマットを固定
- 完了したら「やったこと」「変更したファイル」「次に確認すべきこと」を報告する
狙い: AI が「できました」とだけ報告して中身がブラックボックスになるのを防ぐ。
毎回「やったこと・変更ファイル・次の確認事項」をセットで出させると、レビュー時に何を見ればいいかが明確になります。
うちのチームでは、これを徹底することで人間レビューの時間が半分になりました。
5行目: 不明な前提は推測で進めず質問
- 不明な前提があれば、推測で進めず必ず質問する
狙い: AI が「それっぽい推測でコードを書く」のを防ぐ。
これが最も重要です。
AI は推測でコードを生成する能力が高いので、本来は人間に確認すべき前提も「たぶんこうだろう」で進めてしまいます。
「わからなかったら聞いて」を明示しておくと、AI が立ち止まって質問するようになり、無駄な実装ややり直しが激減します。
効果測定
うちのチームで、この5行を入れた後の変化（体感ベース）：
| 項目 | 5行なし | 5行あり |
|---|---|---|
| 1タスクあたりのレビュー時間 | 30分 | 15分 |
| 既存規約から外れる頻度 | 週3〜5回 | 週0〜1回 |
| 「動いたが意図不明」のPR | 月5〜10件 | 月1〜2件 |
| AI への追加質問回数 | 1タスク3〜5回 | 1タスク1〜2回 |
数字はあくまで体感ですが、最も効果が出る投資対効果の高いコード品質改善 だと思います。
応用: AGENTS.md / .cursorrules でも同じ思想
これは Claude Code の CLAUDE.md だけでなく、
- Cursor の
.cursorrules - Windsurf の
AGENTS.md - GitHub Copilot の
.github/copilot-instructions.md
など、AI ツール全般で同じ思想で書けます。
ツールが変わっても、「AI に動かしてほしい鉄則」を5行で宣言する という設計思想は使い回せます。
まとめ: 5行で品質を底上げする
CLAUDE.md / AGENTS.md は長く書きすぎても効果が薄れます。
最も効くのはこの鉄板5行：
- 着手前に宣言
- 既存規約を先に確認
- エラー処理は聞き返す
- 完了報告のフォーマット固定
- 不明な前提は質問
これを入れるだけで、AI 出力の品質が体感30〜50%改善します。
ぜひ自分のプロジェクトの CLAUDE.md にも追記してみてください。
関連: 教材で手を動かして学ぶ
- まず無料で試したい方: 教材の体験版を GitHub で配布中（
git cloneしてすぐ動かせます） → https://github.com/ayies128/next-ai-camp-trial - 全20セッション完全版＋メンタリング → https://menta.work/plan/20251
- YouTubeチャンネル → https://www.youtube.com/channel/UC1rXVD9WYsQPQEWZyd-A1KA/