AGENTS.md

見出し、箇条書き、強調などを「#」「-」「*」といった簡単な記号で表す軽量マークアップ言語のMarkdownで書かれたテキストファイル。人が読み書きしやすく、AIも解釈しやすいため、AI駆動開発では仕様書や、AIエージェントへの指示・プロジェクトの規約を記したファイルに使われる。

作りたいものを自然言語で生成AIに伝え、生成されたコードの中身を細かく読まずに、動作を見ながら指示を重ねてソフトウェアを作る開発のやり方。2025年にアンドレイ・カルパシーが名付けた。試作は速いが、品質や脆弱性、保守性の確認が抜け落ちやすい。

AIエージェントが、開発者から与えられた目標に向けて自律的に計画を立て、複数のファイルの読み書き、コマンドの実行、テストの実行と修正を繰り返して開発作業を進めるやり方。人は目標と権限の範囲を設定し、成果物をレビューする役割を担う。

生成AIを使った開発で、先に要件、設計、作業手順などの仕様をMarkdownなどの文書として明確に書き、その仕様を基にAIにコードを生成させ、仕様と照らして検証する開発手法。思いつきの指示で進めるバイブコーディングに比べ、意図のずれや手戻りを減らせる。

フローチャート、シーケンス図、クラス図、ガントチャートなどを、テキストで記述して図として描画するための記法。Markdownの中に書けてバージョン管理しやすく、生成AIにも読み書きさせやすいため、設計文書の図の作成に使われる。