はじめに
この記事の前提
なぜ AGENTS.md / CLAUDE.md が問題になるのか
巨大な指示ファイルが起こす問題
Claude Code の場合
Claude Code の実務手順
worktree セッションのすり抜けに注意する
.claude/settings.local.json はGit管理しない
設定ファイルのパスがずれていないか確認する
Claude Code 側で確認する
元に戻す（プロジェクトの CLAUDE.md を再び有効にする）
自分用の最小 ~/.claude/CLAUDE.md を置く
除外した指示ファイルは「参照資料」として活かす
Claude Code のまとめ
Codex の場合
Codex の指示ファイル読み込み順
Codex の実務手順
.codex/config.toml はGit管理しない
Codex 用の最小 ~/.codex/AGENTS.md を置く
AGENTS.override.md に注意する
Codex 側で確認する
Codex のまとめ
AIエージェントに渡すべき指示とは何か
現場で起きがちな属人化
リポジトリを直せない場合は、自分の環境を守る
最小ルールの完成形
よくある疑問
- AGENTS.md / CLAUDE.md は全部不要なのか
- チームルール違反にならないのか
- 設定したのに CLAUDE.md が外れないのはなぜか
- worktree のセッションで CLAUDE.md が復活するのはなぜか
- **/CLAUDE.md ではダメなのか
- project_doc_max_bytes = 0 は必ず効くのか
- AGENTS.override.md は確認すべきか
- fallback filenames とは何か
まとめ
このシリーズの歩き方