ドキュメントを人間ではなくAIに向けて書く

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