コンテキストファイルを書く(AGENTS.md)

最もレバレッジの高い唯一のことは、AIが自動的に読むコンテキストファイルを書くことだ。ツールによって探す名前は異なる——AGENTS.md、CLAUDE.md、.cursorrules、あるいは .github/copilot-instructions.md——だが考え方は同一だ。あなたのプロジェクトがどう動き、あなたがどう振る舞ってほしいかをAIに伝える、生きたドキュメントである。

それがなければ、AIは推測する。それがあれば、AIはあなたのコードを再フォーマットするのをやめ、使っていないライブラリを発明するのをやめ、すでに下した決定を再説明するのをやめる。これを、優秀だがセッションの合間に完全な記憶喪失に陥る新しいチームメイトのためのオンボーディング資料だと考えよう——彼らが生産的になるために必要なものはすべて、彼らが毎回読む場所になければならない。

実践的な出発点となるファイル。

# Project: Invoice Manager

## What this is
A small web app for freelancers to create and track invoices.

## Tech stack
- TypeScript + React (Vite)
- Tailwind for styling
- SQLite via Prisma
- Vitest for tests

## Commands
- Install: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`

## Conventions
- Use functional components and hooks; no class components.
- Keep components small; one component per file.
- Write a test for every new function in `src/lib`.
- Never edit files in `src/generated/` — they are auto-generated.

## Don'ts
- Don't add new dependencies without flagging it first.
- Don't commit secrets; use environment variables.

短く保ち、最新に保つこと。千行まで膨らんだコンテキストファイルは——あなたにとってもモデルにとっても——もはや注意深く読まれなくなるので、足すのと同じくらい攻撃的に刈り込もう。AIが同じ間違った前提を繰り返し置くなら、それは一行追加すべきというサインだ。ルールがもはや現実と合わなくなったら、それがエージェントを能動的に誤らせ始める前に消そう。

機能するコンテキストファイルと無視されるそれとを分ける、いくつかのパターンがある。

• 具体的かつ明確に書く。 「我々の規約を使え」は役に立たない。「検証には zod を使え。我々は yup を使わない」は、AIが実際に従えるルールだ。
• やるなを、やれと同じくらい大きな声で言う。 モデルは手伝いたくてうずうずしている。つまり、止めない限り喜んで依存関係を足したり設定を書き換えたりする。
• 例を指し示す。 「src/features/invoices のスタイルに合わせろ」は、解釈すべき曖昧な指示の代わりに、真似すべき具体的な手本をAIに与える。

コンテキストファイルを、さもなければ繰り返し説明しなければならないあらゆる教訓の記録として扱おう。それはこの章全体で最も安く、最も長持ちする投資だ。