01 / DECIDE
Architecture decision
contributor と agent が同じ repository-specific instruction を繰り返し必要とするときに使う。
durable guidance は architecture boundary、command、convention、verification を示し、current task の代わりにはしない。 input、output、state、side effect を一つの観測可能な経路にしてから、repository の真実を AGENTS.md に残す の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。contributor と agent が同じ repository-specific instruction を繰り返し必要とするときに使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。durable guidance は architecture boundary、command、convention、verification を示し、current task の代わりにはしない。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。newcomer が private context なしで documented check を実行し同じ repository interpretation を得られる。
03 / BOUND
Production boundary
instruction は scoped、executable、current、secret-free とし、nested file は subtree のみ特化する。
04 / PROVE
Acceptance evidence
newcomer が private context なしで documented check を実行し同じ repository interpretation を得られる。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://learn.chatgpt.com/docs/agent-configuration/agents-md' | sed -n '1,5p'