こだわりのAGENTS.mdの紹介 / A Tour of My Opinionated AGENTS.md

社内AI勉強会#2 LT の発表資料

Transcript

1. / A Tour of My Opinionated AGENTS.md こだわりのAGENTS.md の紹介 ADPF Team 坪井俊憲 / Toshinori TSUBOI
2. 私の ~/.codex/AGENTS.md の「こだわり」を抜粋紹介 / A quick look at selected principles from my AGENTS.md 発表概要 / Presentation Overview 発表対象 / Presentation Target: 発表対象 / Presentation Target: ~/.codex/AGENTS.md (gist) ~/.codex/AGENTS.md (gist) 2
3. 1. 余計なことを書かない / Do Not Write Unnecessary Rules コンテキスト節約と暴走抑制のため変なことを書かない / Keep instructions lean to save context and prevent overreach grepすればわかる情報 / Anything discoverable with a quick grep 言語別スタイルガイド（SKILL/docsに書くべき） / Language-specific style guidance (belongs in SKILL/docs) SWE常識 / SWE Trivial Knowledge 3
4. SRP（単一責務原則）に強く従わせる指示 / Hard instructions that force strict SRP compliance 気になる挙動を補正する短い指示 / A short nudge to correct the behavior you actually care about 失敗例：SWE常識を与える / Pitfall: Over-Explaining SWE Trivial Knowledge 4
5. 2. 環境によって挙動を変える / Adapt Behavior to Each Environment ローカル環境固有のルールをリポジトリを汚さず追加 / Add machine-specific rules without polluting the repository 5
6. AGENTS.local.mdに書くとよいことの例 / Examples for AGENTS.local.md ローカル専用リソースでのテスト依頼 / Ask for tests that use local-only resources コミットごとのrelease build実行 / Run a release build after every commit 6
7. 3. コミット後の改善ループを回す / Post-commit Improvement Loop コミット起点の振り返り / Retrospectives triggered by each commit バグ疑いの指摘 / Flag likely bug smells 7
8. 1. 余計なことを書かない / Do not write unnecessary rules 2. 環境によって挙動を変える / Adapt behavior to each environment 3. コミット後の改善ループを回す / Keep a post-commit improvement loop running まとめ / Summary 8