ドキュメントを人間ではなくAIに向けて書く
人間はどうせ ドキュメント を読まないので、最初からAIに向けてドキュメントを整備する、という心構えが重要なのではないか
- AIはドキュメントを律儀に読んでくれる
- 読ませたdocsを参照して作業できる
- 開発者向けdocも、人間よりもAIと考えたほうが自然
- ハーネスエンジニアリング に近い
- docs / tests / 各種作業手順 / ディレクトリ構造
- ドキュメントを最新化しつづけることが今までより重要
- 人間は古いdocsを無視できる
- AIは古いdocsに引っ張られてしまう
関連: vibe coding AGENTS.md AI LLM
