Slide 1

Slide 1 text

/ A Tour of My Opinionated AGENTS.md こだわりのAGENTS.md の紹介 ADPF Team 坪井俊憲 / Toshinori TSUBOI

Slide 2

Slide 2 text

私の ~/.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

Slide 3

Slide 3 text

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

Slide 4

Slide 4 text

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

Slide 5

Slide 5 text

2. 環境によって挙動を変える / Adapt Behavior to Each Environment ローカル環境固有のルールをリポジトリを汚さず追加 / Add machine-specific rules without polluting the repository 5

Slide 6

Slide 6 text

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

Slide 7

Slide 7 text

3. コミット後の改善ループを回す / Post-commit Improvement Loop コミット起点の振り返り / Retrospectives triggered by each commit バグ疑いの指摘 / Flag likely bug smells 7

Slide 8

Slide 8 text

1. 余計なことを書かない / Do not write unnecessary rules 2. 環境によって挙動を変える / Adapt behavior to each environment 3. コミット後の改善ループを回す / Keep a post-commit improvement loop running まとめ / Summary 8