問題
正直に認めましょう。私たちはもうコードを読みたくありません。エージェントの行動をいちいち確認することも、プロジェクトの技術的な細部をすべて頭に入れておくことも望んでいません。
しかし、誰もエージェントを制御しなければ、どんなプロジェクトも、人間にもエージェントにも手に負えない保守不能な混沌と化します。それは時間の問題にすぎません。
アイデア
HUMAN-INTENT.md はリポジトリのルートに置く1つのファイルです。そこにはあなたの意図——プロジェクトのアーキテクチャ、開発ルール、プロダクトの意思決定——が記されます。
これはコードのドキュメントではありません。コードが従うべき法律です。
ルール
-
書くのはあなた——あなただけ
エージェントは決してこのファイルを編集しません。そこにある一行一行が、人間の下した決定です。
-
その指示はエージェントにとって法律
HUMAN-INTENT.md に書かれていることは、他の何よりも優先されます。コードがファイルと矛盾するなら、間違っているのはコードです。
-
アーキテクチャ、ルール、プロダクトを定める
レシピではなく意図を。エージェントはあらゆるパターンをすでに知っています。あなたの仕事は、何が守られるべきか——そしてなぜかを定めることです。
なぜ機能するのか
エージェントに付き合いきれる人はいません。誰も読みたくないほどの量のコードが生まれていくからです。1行ずつ管理するのは不可能でも、意図を管理することはできます。
HUMAN-INTENT.md は管理を一段上へ引き上げます。何千行ものコードではなく、自分の決定を記した1つのファイルだけを見ればいい。このファイルが法律であるかぎり、誰もコードを読まなくても、プロジェクトはあなたの意図どおりに進みます。
始め方
- リポジトリのルートに HUMAN-INTENT.md を作成する。
- すでに下した決定を書き出す：アーキテクチャ、開発ルール、プロダクト。
- エージェントにこのファイルを読んで法律として扱うよう指示する——AGENTS.md や CLAUDE.md から参照させる。
- 新しい決定を下すたびにファイルへ追記する。エージェントには決して書き込ませない。
- コードではなく、このファイルをレビューする。