AIエージェントと働くための
開発ドキュメント体系

コーディングエージェントとの開発では、ドキュメントの役割が変わります。人間向けの文書は「読んで理解してもらう」ためのものですが、エージェント向けの文書は「次のセッションの自分が読んで、同じ品質で実行する」ためのものです。弊社がコーポレートサイトの運用で実際に使っている5種の文書体系を紹介します。

5種の文書とそれぞれの役割

運用ルール: 常に読み込まれる恒久ルール。ブランチ運用・本番反映の条件・表記規約など、破ってはいけないこと
手順書: 定型作業の実行手順。記事の追加、画像の生成と検品など、「この通りやれば完了する」粒度で書く
設計書: 個別タスクの仕様。画像生成なら構図・品質・禁止事項・チェックリストまでを1ファイルに固定する
ログ: 実行の記録。何を・どの方式で・いくら消費して作ったか。様式を決めて機械的に追記する
引き継ぎ書: 新しい仕組みを導入したときの背景・判断・全体像。将来のセッションが「なぜこうなっているか」を再構築できる

設計原則: 文脈は文書に、判断は様式に

エージェントのセッションは有限で、記憶は持ち越されません。だからこそ、作業中に得た文脈や判断は、その場で文書に書き戻します。とくに効くのは、フィードバックを受けたら手順書やルールに一行追記する習慣です。同じ指摘が二度と繰り返されなくなり、文書は運用のたびに賢くなっていきます。逆に、文書化されていない暗黙の了解は、次のセッションでは存在しないのと同じです。

複数端末・複数セッションでの効き方

この体系のもうひとつの利点は、作業する端末や担当するセッションが変わっても品質が揺れないことです。文書がすべてリポジトリ内にあるため、どの環境から始めても同じルール・同じ手順・同じ様式に到達します。属人化の解消という古典的なテーマは、エージェントとの協働では「属セッション化の解消」として、より切実に、そしてより解きやすくなっています。