チャット履歴に消えていく判断を、Markdownに残すというAI協働の作法

AIエージェントに指示を出すたび、同じ前提や制約を毎回説明し直していないだろうか。その説明の多くはチャットのログの中に埋もれ、数日後には自分でも探し出せなくなる。この「消えていく判断」を、そもそも構造化されたドキュメントとして残しておくという発想のワークフローがある。

個人開発者のDiego Guridi氏が、AIエージェントと人間が同じMarkdownドキュメントを介して協働する「スペック駆動開発」の実践手順を公開した。TODO.mdやnotes/といったフォルダ構成を用意し、ワークスペースのルールを定めるAGENTS.mdを作成した上で、MCP経由でエージェントをプロジェクトの「メンバー」として招待する手順を具体的に示している。プログラマーの貢献の8〜9割はコードそのものではなく要件の理解や意思決定にあるという考えに基づき、その過程をチャットのやり取りではなく、後から読み返せる文書として残すことを狙いとしている。TODO.mdには今取り組んでいるタスクの一覧を、notes/以下には機能ごとの背景や検討過程を短いファイルとして積み上げていき、AGENTS.mdにはプロジェクト全体で守るべき制約(依存ライブラリの方針やコーディング規約など)をまとめておく、という三層構成が骨格になっている。

なぜ今、こうした「文書ベースの協働」が改めて注目されているのか。AIエージェントとのやり取りは便利な反面、セッションが終わればコンテキストが失われ、なぜその実装方針を選んだのかという判断の経緯がチャットログの奥に埋もれてしまいがちだ。特に個人開発や小規模チームでは、数週間後に自分自身が「なぜこう作ったのか」を思い出せなくなることも珍しくない。Guridi氏の手法は、AIエージェントを一時的な会話相手としてではなく、プロジェクトのドキュメント体系に組み込まれた協働者として位置づけ直すことで、判断の経緯そのものを資産として蓄積しようとする試みだと言える。

同種の「仕様をまず文書化してからAIに実装させる」という考え方自体は、いわゆるスペック駆動開発のツール群がここ数か月で急速に広まったことと軌を一にしている。ただしGuridi氏の手法が特徴的なのは、専用ツールや独自フォーマットを導入するのではなく、あくまで素のMarkdownファイルとフォルダ構成だけで完結させている点だ。特別なランタイムやプラグインを必要としないため、Gitリポジトリさえあれば誰でもすぐに始められ、しかもファイル自体が人間にとってもそのまま読みやすいドキュメントになる。この「専用ツール不要」というシンプルさが、個人開発者にとっての導入しやすさに直結している。エディタもAIツールも変える必要がなく、既存のGitワークフローにそのまま乗せられる点は、日々の作業を止めたくない個人開発者にとって地味に大きい。この発想は、コードを書く以外の作業――企画メモ、構成案、取材ログなど――を大量に生み出す個人クリエイターの仕事の進め方とも、実は相性がよい。