まとめと実践

重要なポイント

• よい作業環境は AI にコンテキスト、速いフィードバックループ、安価なやり直しを与える — セットアップこそが乗数であり、しばしばモデルそのものより効く。
• コンテキストファイル（AGENTS.md / CLAUDE.md）は書ける中で最もレバレッジが高い。具体的なルール、大きな声の禁止事項、例へのポインタを入れよう。
• バージョン管理を反射にしよう — 小さくコミットし、差分を読み、危険な作業はブランチで — そうすれば AI のすることに本当に取り返しのつかないものはなくなる。
• ループをタイトに保ち、エージェント自身に閉じさせよう: 編集、実行、失敗を読む、修正。診断（LSP、リント、型チェック）を AI に返そう。
• すべての有料 API をハードな上限とスロットルで囲い、シークレットをリポジトリの外に置き、ハーネスを使って安全チェックを AI が飛ばせないものにしよう。

やってみよう

作業中のプロジェクトを開く（または空のものをスキャフォールドする）か、AGENTS.md の初稿を手で書こう: プロジェクトが何か、技術スタック、dev/test/lint を実行する正確なコマンド、実際のコンベンション三つ、そして少なくとも二つの大きな声の禁止事項（例: 「.env を決して読んだり出力したりしない」「先に知らせずに依存を追加しない」）。それから AI ツールに些細な変更を頼み、ファイルを尊重するか観察しよう。望まないことをするたびに一行を追加するか研ぎ澄まそう。コードだけでなく、部屋をチューニングしているのだ。

この章のプロンプト

Read my project and help me write a concise AGENTS.md context file for it.

First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is

Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.