Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

AI Agentのための仕様駆動開発(SDD)を正しく行う:管理された成果物としての仕様

By Boyu Wang

Updated: November 3, 2026

Published: July 2, 2026

仕様駆動開発(Spec-Driven Development; SDD)は、明確な証跡を持つ数少ないバズワードの1つです。これには基調講演(Sean Grove氏による「The New Code」、AI Engineer World's Fair 2025)、2大巨頭による主力ツール(GitHubのSpec Kit、AWSのKiro)、ラジカルな派閥(Tesslのspec-as-source)、そして 野心のレベルを分類したThoughtworksによる客観的な分類体系が存在します。この核となるアイディアは、1年間にわたる厳しい精査にも耐え抜いてきました。なぜなら、それが本質的な真実を捉えているからです。Agentがコードを書く時代において、人間の意図が実際に存在するのはプロンプトでもコードでもなく「仕様」であり、したがって仕様は最初に書かれ、保持され、信頼できる単一の情報源(Source of Truth)として扱われるべきです。この運動がまだ完全に解決できていないのは、仕様自体が拡散して収拾がつかなくなったフリート規模で何が起きるかという点です。何十もの仕様ファイル、競合するAGENTS.mdのバリエーション、そしてどの仕様がどのデプロイされた振る舞いを生み出したのかという記録の不在。これこそが本記事で扱うテーマです。なぜなら、仕様とはスキャフォールド(足場)であり、スキャフォールドとはガバナンス管理が可能なものだからです。

要点

  • 仕様駆動開発(SDD)とは、AIがコードを書く前に構造化された仕様を記述し、人間とAgentの両方にとっての信頼できる単一の情報源として仕様を保持することを意味します。ThoughtworksのBirgitta Böckeler氏による流動的な定義のフレームワークでは「ドキュメントファースト」と表現されています。
  • 知的火花としてよく引用されるのがOpenAIのSean Grove氏の講演(「The New Code」、2025年)です。プロンプトは一時的なもの(チームは生成されたコードを保持しプロンプトを削除する)であるのに対し、書かれバージョン管理された仕様は人間とモデルの両方の認識を一致させます。OpenAI自身のModel Specはその典型例です。
  • ツール群は急速にコンバージエンス(収束)しました。GitHub Spec Kit(Specify → Plan → Tasks → Implement)、AWS Kiro(Requirements → Design → Tasks)、そしてTesslのより強力なspec-as-sourceという立場です。Böckeler氏の有用なラダー(段階)は、spec-first → spec-anchored → spec-as-sourceと進みます。
  • 対となる規範は「自制(Restraint)」です。実践者のガイダンスでは、信頼性が低下し始める前の実用的な上限として、約150〜200個の常設指示を基準(測定された保証ではなく経験則)としています。そのため、Agentファイル(AGENTS.md、CLAUDE.md)は簡潔かつ構造化された「WHAT/WHY/HOW」を保ち、段階的に開示されるべきです。網羅性は失敗モードの1つです。
  • SDDの未解決の課題は規模におけるガバナンスです。仕様は振る舞いを決定づける成果物であり、フリート規模では、コードが何十年も前に獲得したもの、すなわちバージョン管理、所有者、レビュー、そして仕様のバージョンからデプロイされた振る舞いへのリンクが必要となります。
  • 用語集の定義では、仕様はスキャフォールドであり、仕様の変更はポリシーの変更です。そのため、評価ゲートの背後にあるバージョン管理された成果物の中に属し、実行メタデータによってどの仕様バージョンが各実行を規定したかを記録します。
  • TrueFoundryのAgent Harnessでは、このガバナンスレーンが自然な居場所を見得ます。Agentの指示はAgent定義とともに存在します。再利用可能なプロシージャ仕様はバージョン管理されたSkills Registry成果物(ピン留め、RBAC管理、ロールバック、監査、ジャストインタイムでのマウントが可能)になります。機密性の高いツール使用はゲートで制御でき、実行はハーネスを通じてトラッキングされます。機能仕様とプランについては、実行メタデータに仕様バージョンを記録し、評価を通じてプロモーション(昇格)を制御するパターンが推奨されます。

エンジニアリングマネージャーのBastienは、早期かつ真摯な転向者でした。彼のチームは秋に仕様駆動開発を導入し、それは講演で約束された通りの成果をもたらしました。以前はプロンプトの不毛なやり取りで頓挫していた機能が1ページの仕様から出荷され、レビューの議論は一段上のレベルへシフトし、安全に委任できる作業範囲は20分のタスクから午後一杯かかる規模へと拡大しました。6ヶ月後、彼が監査を実施したところ、誰もガバナンス管理を行わなかった場合の「成功」の姿を目にすることになりました。9つのリポジトリにまたがる41個の仕様ファイル(そのうち4個は同じサービスを異なって記述)、9個のAGENTS.mdのバリエーション(そのうち3個は自動生成され、モデルが確実に追従できる範囲を超えて膨張)、そして一度生み出したコードから乖離した仕様(どの仕様のどのバージョンが任意のデプロイされた振る舞いを出荷したAgent実行を形成したかの記録は一切なし)。実践自体は正しかったのですが、成果物が野放しになっていたのです。Bastienがプラットフォームチームに投げかけた質問は、本記事が回答する内容そのものでした。「仕様を信頼できる唯一の情報源にしたのに、なぜその情報源がバージョン管理されていないのか?」

この質問に答えるため、まずこの用語が始まった場所から始めましょう。誕生の物語には、ガバナンスを論理的な次のステップとするまさにその論拠が含まれています。

1. バズワードの起源:Grove、シュレッダーにかけられたソース、そしてModel Spec

広く引用されている起点の1つが、あるカンファレンスでの講演です。サンフランシスコで開催されたAI Engineer World's Fair 2025において、当時OpenAIでアライメントを担当していたSean Grove氏が「The New Code」と題した講演を行いました。多くの実践者がこの運動の最も明快な言語化として引用するこの講演で、彼は象徴的なイメージを提示しました。開発者はモデルにプロンプトを与え、生成されたコードを保持し、プロンプトを捨ててしまう。Grove氏はこれを、ソースコードをシュレッダーにかけてバイナリをバージョン管理するようなものだと例えました。彼の論理は単なるワークフローの整理整頓にとどまりません。コードはプログラマーの価値の一部に過ぎず、より大きな部分は「意図の構造化された伝達」であり、書かれた仕様こそがモデルに調整させる前に、構築すべきものについて人間同士の認識を合わせる成果物であると主張しました。Grove氏が提示した例は、OpenAI自身のModel Specでした。これは同社が意図するモデルの振る舞いを表現した、バージョン管理されたリビングMarkdownドキュメントであり、各条項には一意のIDと、単体テストとして機能するサンプルプロンプトが含まれています。意図が一度書かれ、バージョン管理され、テスト可能であり、人間とマシンの両方によって消費されるのです。

業界の反応はこのアイディアに名前とツールを与えました。GitHubは2025年9月にSpec Kitをオープンソース化し、その変化を率直に表現しました。彼らの言葉を借りれば、開発の共通言語が一段上のレベルへシフトし、コードはラストワンマイルになるというものです。AWSはKiroを出荷しました。これは実行前にRequirements、Design、Tasksに仕様ワークフローの軸を置くIDEです。Tesslはラジカルな端を確保しました。仕様を維持される主要な成果物とし、コードはそこから再生成されるという立場です。そして、2025年2月に「vibe coding」という言葉を生み出したAndrej Karpathy氏は、その1年後に次のフェーズを「Agentic Engineering(エージェンティック・エンジニアリング)」と表現しました。これは人間の監視の下、詳細な仕様に対してAgentをオーケストレーションする手法です。バイブの時代が課題を命名し、SDDがその修正策を命名したのです。

2. SDDの本当の姿 — そしてBöckelerのラダー

この用語はその定義よりも急速に広まったため、最も有用なマップは、Birgitta Böckeler氏がThoughtworks向けに執筆した2025年10月の分析(martinfowler.comに掲載)です。彼女はSpec Kit、Kiro、Tesslを調査し、単一の実践ではなく野心のラダー(段階)が存在することを発見しました。Spec-first(仕様ファースト):良く考えられた仕様を書き、それを使ってAI支援タスクを進め、完了させる。仕様はその機能より長生きしない場合もあります。Spec-anchored(仕様アンカー):タスク完了後も仕様を保持し、仕様を通じて機能を進化させる。仕様は維持される振る舞いの記述となります。Spec-as-source(仕様ソース):Tesslの立場です。仕様こそが維持する成果物であり、コードはそのコンパイルされた出力です。今日SDDを実践しているほとんどのチームは最初の2つの段に位置しており、ワークフローはどこでも明確に共通しています。仕様作成、計画、タスクへの分解、実装 — Agentはあらゆる段階で仕様を消費します。

これが機能する理由も、もはや推測の域を出ています。構造化された仕様は、制約のない生成をカオスにする探索空間を制限します。受け入れ条件はAgent(およびその検証者)にチェック可能なものを与えます。そして分解によって、曖昧な機能がAgentサイズのタスクへと変わります。実践者のレポートによると、安全に委任できる範囲が10〜20分のタスクから、一貫した品質を保った複数時間に及ぶ機能開発へと拡大したと記述されています。これは制御された研究ではなく実践チームからの現場の証言であり、そのように読む価値があります。素直な境界線は、ラダーをマッピングした同じThoughtworksの分析から示されました。SDDは大規模な機能や新規(グリーンフィールド)開発に適しています。小さなバグ修正では、仕様のオーバーヘッドに見合う価値はありません。適用できない範囲を自覚している規範こそ、真剣に向き合う価値があるものです。

3. 対となる規範:自制と指示バジェット

SDDは、Agentにとって同様に重要な兄弟的実践とともに登場しました。それが常設指示ファイル(AGENTS.md、CLAUDE.md、およびその同類)であり、プロジェクトの永続的な声としてすべてのAgentセッションにに同乗します。そして、これらのファイルに関する苦労の末に得られた2026年のコンセンサスは「自制の議論」です。実践者のガイダンスは実用的な数値へと収束しました。フロンティアモデルは、遵守率が低下し始めるまでに信頼して追従できる常設指示の数が概ね150〜200個程度として扱われることが多いです。これはモデルの保証ではなく経験則です。そのため、すべてを詰め込んだ自動生成のAgentファイルは、勤勉さの仮面をかぶった失敗モードと言えます。浮上した推奨事項は、編集者のチェックリストのように読めます。ファイルを簡潔に保つ(HumanLayerが頻繁に引用する推奨事項は約300行未満)、WHAT/WHY/HOWの構造にする(スタックと構造、目的、ビルドコマンドと規約)、明示的なDo/Don'tリストと権限境界を含める、ファイルパスをドキュメント化しない(すぐに古くなるため)、ファイルをリンターとして使用しない(リンターを使用する)、金曜日には古くなるようなタスク固有の指示を埋め込まない。より大規模なコードベースに対しては「段階的開示(Progressive Disclosure)」、つまり簡潔なルートファイルを用意し、関連する場所でより深いファイルをロードするという手法をとります。

本シリーズの読者であれば、そのアドバイスの双方の側面に見覚えがあるでしょう。指示バジェット(Instruction Budget)とは、ドキュメントの帽子をかぶったコンテキストエンジニアリングの事実です。常設指示は事前ロードされたコンテキストであり、事前ロードされた大量のデータは、まさに当社のJITコンテキストに関する記事で説明しているように注意力を低下させます。段階的開示とは、仕様に適用されたジャストインタイムロードそのものです。そして「Agentファイルはプロジェクトの永続的な声である」というのはスキャフォールドの主張です。これこそがガバナンスのギャップへとつながる糸口となります。なぜなら、Bastienの9つの膨張したバリエーションは文章表現の問題ではなかったからです。それらは所有者のいない成果物の問題だったのです。

4. フリート規模でのギャップ:仕様は振る舞いであり、振る舞いは拡散する

ここに、SDDの議論がまだほとんど到達していない構造的な観察があります。この運動が仕様について言及しているすべてのこと — 信頼できる単一の情報源、Agentによる消費、人間の認識の一致 — は、仕様が振る舞いを決定するという主張です。Agent用語集の語彙で言えば、仕様はスキャフォールド(モデルが作業するためのコンテンツ)です。スキャフォールドへの変更はポリシーの変更であり、振る舞いの観点からはモデルの変更と同じカテゴリーのイベントです。誠実に実践されたSDDは、まさにこれらの成果物(機能仕様、計画ファイル、タスクリスト、AGENTS.mdのバリエーション、受け入れ条件)を増殖させます。それぞれがAgentを誘導します。しかし、一般的な導入において、デプロイに結びついたバージョン履歴、所有者、レビュー経路、あるいは「どの実行をこのファイルが決定づけたか?」という問いへの回答を持つものはほぼ皆無です。

それこそが名付けられたBastienの監査結果です。41個の仕様と9個のAgentファイルは整理整頓の問題ではありません。それらはバージョン管理されていない41個の振る舞い入力と、9個の競合する常設ポリシーなのです。既知のSDDのペインポイントはすべて同じ根源に遡ります。仕様とコードの乖離(初期のSDD導入者は、ワークフローの一環として仕様を更新しない限り、仕様とコードの同期が崩れると一般的に報告しています)は、宣言された真実とデプロイされた真実の間の監視されていない乖離です。重複した仕様は分岐したポリシーです。膨張した自動生成のAgentファイルは、レビューされていないポリシーの肥大化です。この運動は仕様を重要なものにしましたが、まだそれらをガバナンス管理されたものにはしていません。ソフトウェアはコードに対して、バージョン管理、コードレビュー、CIゲート、デプロイ記録を用いてこのまったく同じ問題を解決しました。仕様に対する修正も、新しい成果物クラスに向けられた同じ仕組みなのです。

図1: すべてのSDDツールが収束したパイプライン(Spec KitのSpecify→Plan→Tasks→Implement、KiroのRequirements→Design→Tasks)と、仕様が機能単体ではなくフリートを誘導するようになった際に実践が必要とするガバナンスレーン。

5. ガバナンス管理されたスキャフォールドとしての仕様:マッピング

すでにスキャフォールドをガバナンス管理されたコンテンツとして扱うプラットフォームを通してSDDの成果物リストを実行すると、各項目は特定の場所に収まります。常設指示(AGENTS.mdの役割)は、TrueFoundryのAgent Harness上のAgent定義に属します。プロンプトボックスでアドホックに編集するのではなく、バージョン管理されたコンテンツとして保存され、差分としてレビューされ、定義から参照されるべきです。これにより、自制の規範には著者だけでなくレビュー者が存在することになります。再利用可能なプロシージャ仕様(ランブック、「ここでのマイグレーションの進め方」、複数ステップの受け入れレシピ)は「スキル」です。RBACを備えたバージョン管理されたSKILL.md成果物としてSkills Registryに昇格し、Agentによってskill@versionとしてピン留めされ、ジャストインタイムでマウントされます。これは段階的開示を文字通り実装します。カタログの一行の説明が同乗し、完全なプロシージャはアクティベーション時にロードされます。1つの仕様、40のAgent、ブランチの分岐はゼロです。

機能仕様とプランは作業が存在するリポジトリに保持できますが、Agentの実行はそのトレースメタデータに不可変なバージョンまたはコミットSHAを記録する必要があります。ハーネスはすでに各実行のステップを記録しているため、仕様バージョンは後から復元するのではなく、実行とともに移動します。そうすれば、「どの仕様バージョンがこの実行を形成したか」は考古学ではなくクエリになります。そして全体のアセンブリこそがポリシーです。名前によるモデル、バージョン指定された指示、ピン留めされたスキル、ツール権限といったAgent定義は、1つの宣言的で差分可能な成果物であり、これこそまさに当社のポリシーに関する記事で、一緒にバージョン管理、ゲート制御、ロールバックされるべきだと主張したユニットです。このマッピングの嬉しい驚きは、SDDと対立するものが何もないということです。それは創業の論理を完成させます。Grove氏の主張は、意図はバージョン管理され、テスト可能なファーストクラスの成果物であるべきだというものでした。Model Specは1つの組織のモデルの振る舞いに対してそれを行いました。ガバナンスレーンは、フリートが消費するすべての仕様に対してそれを行います。

SDD型のAgent定義:ピン留めされ、バージョン管理されたスキャフォールドとしての仕様(例示)

TrueFoundry Agent Harness builder: instructions, skills, and MCP servers attached to one agent definition
図2: ガバナンス管理された設定としての仕様:単一の宣言的Agent定義に名前とバージョンでアタッチされた指示とスキル — ノーコードビルダー、SDK、APIのどこで作成されても同じ成果物となります。出典:TrueFoundry Agent Harness ドキュメント。

6. ゲートを通過する仕様の変更

運用上の結果については独立した節を割く価値があります。なぜなら、ここにSDDの最大の未処理のリスクが存在するからです。仕様が信頼できる唯一の情報源であり、Agentがそれに沿って実装を行う場合、仕様の編集はシステム内で最も影響力の大きい変更となります。それは流のすべてのAgentの決定を再指向します。しかし多くの導入において、それは最も儀式的な手続きの少ない変更でもあります。金曜日にマージされ、月曜日の実行で消費されるMarkdownの編集に過ぎません。修正策は、例外なく適用されるポリシーの規律です。仕様またはAgentファイルの変更はバージョンを繰り上げ(バンプし)なければならず、バージョン変更は評価ゲート(モデルの切り替えが直面するのと同じスイート — 振る舞いとしては同じ種類のイベント)をトリガーし、プロモーションは段階的に行われるべきです。共有スキル場合、バージョンの繰り上げはリポジトリ全体で暗黙的に行われるのではなく、Agentごとに意図的にロールアウトされます。これによって手軽な編集が大幅に遅くなることはありませんが、高コストな編集が本番環境に出る前に可視化されます。

同じ仕組みが乖離(ドフト)の問題を誠実に解消します。仕様とコードの乖離は、spec-firstの実践では避けられず、spec-anchoredの実践では管理されますが、それは乖離が検出可能である場合のみです。そのためにはデプロイされた振る舞いがどの仕様バージョンから生じたかを知る必要があります。実行が消費した仕様バージョンを記録していれば、乖離は現在の仕様と最後にゲートを通過したバージョンとの差分となり、スケジュールに従って表面化します。Bastienが発見したような、インシデント中に発見される事態を防ぐことができます。

7. 誠実な限界:SDDが直面する負荷

懐疑派の主張にも一節を設ける価値があります。なぜなら、彼らの最も強力な指摘がガバナンス設計を形作るからです。ウォーターフォール批判(再誕生した要求仕様書としてのSDD)は、仕様が最初に網羅的かつ前もって一度だけ書かれる場合に当てはまります。この実践は、仕様を百科事典的ではなく簡潔かつ反復的に保つことで批判を回避します。「コードこそが究極の実行可能な真実である」という反論(生成されたコードが間違っている場合、修正するのは文章ではなくコードである)は境界線上では正しく、これこそがspec-as-sourceが少数派にとどまっている理由そのものです。乖離検出を備えたspec-anchoredが、防衛可能な中間地点です。そしてオーバーヘッドに関する指摘は、Thoughtworks自身の分析が述べている通りです。小さな修正は仰々しい儀式を保証しないため、ガバナンスレーンには釣り合いの取れたファストパスが必要です。バージョンを記録し、低コストな自動ゲートを実行し、委員会をスキップします。

本記事の主張に固有の限界がもう1つあります。仕様をバージョン管理しても、それが優れたものになるわけではありません。正確に管理された悪い仕様は、正確に追跡可能な悪い振る舞いを生み出します。指示バジェット、WHAT/WHY/HOW構造、チェック可能な受け入れ条件というSDDのクラフト(技能)の側面は依然として人間の仕事であり、プラットフォームの貢献は誠実ですが限定的です。プラットフォームはクラフトをレビュー可能にし、帰属可能にし、反復を安全にします。

8. 最小限の実行可能なガバナンスレーン(Minimum Viable Governance Lane)

これにはプラットフォームの全面的な再構築は必要ありません。このレーンは5つの成果物クラスで構成され、それぞれに所有者、バージョン管理メカニズム、その影響範囲に釣り合ったゲート、そして実行トレース上で振る舞いに結びつけるフィールドが存在します。以下のパターンは、チームが最初に立ち上げることを推奨するものです。「Skills Registry」の行はドキュメント化されたTrueFoundryの機能であり、残りはチームが今日からリポジトリおよびハーネス設定に採用できる慣習です。

成果物 所有者 バージョン管理 ゲート ランタイムトレースフィールド
AGENTS.md リポジトリ所有者 / プラットフォーム コミットSHA または 成果物バージョン Agent評価スイート agent.instructions.version
機能仕様 プロダクト + 開発所有者 コミットSHA 受け入れ / E2Eテスト agent.spec.version
プラン / タスク 開発所有者 コミットSHA コード / テストレビュー agent.plan.version
再利用可能なランブック プラットフォーム所有者 Skills Registryバージョン スキル評価 agent.skill_versions[]
MCPツール権限 プラットフォーム / セキュリティ ポリシーバージョン 承認 / ポリシーテスト agent.tool_policy.version

その見返りは、実行ごとに残る単一の判読可能な記録です。振る舞いを決定づけたものが何であれ(指示、仕様、プラン、スキル、ツールポリシー)、それらはトレース上に名前が付けられピン留めされるため、インシデント後の質問は発掘作業ではなく検索(ルックアップ)になります。

「どのバージョンがこの振る舞いを決定づけたか?」に答える実行トレース(例示)

スキルのバージョンはファーストクラスの機能としてレジストリから取得されます。仕様、プラン、指示のバージョンは、実行にスタンプすることを選択したコミットSHAです。この規範は導入コストが低く、効果が累積します。Agentが誰にも説明できない振る舞いを出荷した最初のおいて、この記録がクエリで済むかウォー・ルーム(緊急対策室)を開くかの違いを生みます。

9. 到達点:Bastienの2回目の監査

ガバナンス管理されたレール上に再構築された6ヶ月後のBastienの領域は次のようになっています。9つのAGENTS.mdバリエーションは、レビュー済みの3つの指示セット(ドメインごとに1つ)になりました。それぞれが指示バジェット内に収まるほど簡潔で、それぞれがバージョン管理され、差分に名前が表示される所有者が存在します。機能仕様の中に隠れていた再利用可能なプロシージャは7つのレジストリスキルとして抽出され、フリート全体でバージョン指定によりピン留めされました。4つの競合するコピーが存在していたマイグレーションランブックはv4として1つだけ存在し、レジストリはそれをマウントしているすべてのAgentをリストアップできます。機能仕様は依然として機能とともに存在しており(SDDのワークフローは変わりません)、すべてのハーネス実行は消費した仕様と指示のバージョンをトレースメタデータに記録します。そのため、「どの仕様がこの振る舞いを生み出したか」は回答が存在するクエリとなり、仕様の編集はモデルの切り替えと同じ評価ゲートに直面します。41個のファイルは官僚主義にはなりませんでした。それらはインベントリ(資産目録)になったのです。

これこそが創業の論理の完成であり、改訂ではありません。Grove氏の指摘は、意図は破砕されたプロンプトよりも優遇されるべきだというものでした。SDDツールは意図を書かれた成果物にしました。ガバナンスレーンはそれを運用される成果物(バージョン管理され、ゲート制御され、トレースされ、分岐することなく共有される)にします。開発の共通言語は確かに一段上のレベルへシフトしました。インフラストラクチャもそこへ追従するべきです。

10. よくある質問(FAQ)

実際に「仕様駆動開発(spec-driven development)」という言葉を作ったのは誰ですか? 単一の発案者は存在しません。この用語は一瞬で現れたのではなく、2025年を通じて結実しました。最も頻繁に引用される知的火花は、AI Engineer World's Fair 2025でのSean Grove氏による「The New Code」の講演です。GitHubのSpec Kit(2025年9月)とAWSのKiroがこの実践にツールと語彙の多くを与え、Tesslが強力な形式を押し進め、Birgitta Böckeler氏によるThoughtworksの分析(2025年10月)が現在多くの実践者が使用している spec-first / spec-anchored / spec-as-source という分類体系を与えました。公平に評価するならば、これは特定の瞬間ではなく、1つの「運動」です。

SDDは単なる手続きが増えたウォーターフォールですか? 似ている部分はあり、それを否定すると信頼性を失います。重要な違いとして、SDDの仕様は網羅的で固定されたものではなく、簡潔で反復的です。実装ループは四半期単位ではなく時間単位であるため、仕様とコードは継続的に収束できます。そして仕様の消費者は、それを真正面から実行するAgentであり、これは大規模な事前の設計(Big Upfront Design)にはなかった要素です。チームが百科事典的な仕様を一度だけ書いて丸投げする場合、Agentの有無にかかわらず失敗モードを再発明していることになります。

AGENTS.mdファイルに本当にガバナンスが必要ですか?単なるドキュメントでは? これらはすべてのAgentセッションで消費される常設指示であり、ドキュメントではなく振る舞いを決定づけるコンテンツです。これらに対するレビューなしの編集は、それが影響を与えるすべての実行にわたる暗黙のポリシー変更であり、これこそまさにバージョン管理とレビューが存在する変更のカテゴリーそのものです。実践的なテスト:そのファイルを編集することで本番環境に出荷されるものが変わり得るなら、それは「単なるドキュメント」ではありません。

仕様とスキルの境界線はどこですか? スコープと再利用性です。機能仕様は1つの作業単位を記述し、その作業とともに存在します。スキルとは再利用可能なプロシージャ(組織がマイグレーション、レビュー、インシデント報告書作成をどのように行うか)であり、時間をかけて多くのAgentによって消費されます。これこそが、バージョン、RBAC、ピン留め、ジャストインタイムマウントといったレジストリ処理を受ける資格を与えるものです。同じ文章が仕様間でコピーされ続けているなら、それがスキルへの昇格のサインです。

私たちはエンジニア2人とAgent1つのチームです。これらは関係ありますか? クラフト(技能)の半分は完全に当てはまります。仕様ファースト、簡潔なAgentファイル、チェック可能な受け入れ条件は、どんな規模でも恩恵をもたらします。ガバナンスレーンは規模の拡大とともに価値を発揮します(Agentが増え、著者が増え、共有仕様が増える場合)。「どの仕様が本物か?」という会話が最初に発生した時点で採用してください。それまでは、Gitリポジトリと規律だけで十分に事足ります。

参考文献

  • Sean Grove (OpenAI) — "The New Code," AI Engineer World's Fair 2025 — 創設の議論:バージョン管理され、テスト可能な意図のホームとしての仕様。Groveの展示であるOpenAIのModel Specは、バージョン管理され、テスト可能なMarkdownドキュメントとして書かれた意図の典型例です。クレジットを付して要約。15語未満の引用断片。
  • Birgitta Böckeler (Thoughtworks) — "Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl," martinfowler.com, 2025年10月 — spec-first / spec-anchored / spec-as-source の分類と、SDDが適用される場所に関する率直な注意事項。
  • GitHub Spec Kit (2025年9月) — Specify → Plan → Tasks → Implement のフロー (/speckit.specify, /speckit.plan, /speckit.tasks, /speckit.implement) と「実行可能な仕様 (executable specifications)」のフレーミング。
  • AWS Kiro — requirements.md、design.md、tasks.mdを中心とした、EARSスタイルの受入基準を伴う仕様ワークフロー(要件から設計、タスク実行まで)。
  • Tessl — spec-as-source の立ち位置:仕様をプライマリに維持される成果物とし、コードはそこから再生成する。
  • Andrej Karpathy — "vibe coding" (2025年2月) と、人間の監視のもとで詳細な仕様に対して行うエージェンティックエンジニアリングに関するその後の議論。
  • エージェント指示ファイルに関する実践者の制約ガイダンス(指示バジェット、ファイル長の推奨、WHAT/WHY/HOW、段階的開示) — HumanLayerのものを含む、2026年初頭のコミュニティエンジニアリング記事。対照実験ではなく経験則として扱い、本文中で帰属を明記。EPAMのSpec Kit field reportは、拡張された委任ウィンドウの一般的な引用元であり、対照実験ではなく現場のエビデンスとして解釈される。
  • TrueFoundry Agent Harness および Skills Registry — この記事が依存するドキュメント化された機能:段階的開示を備えた、バージョン管理され、RBACガバナンスが効き、ピン留め可能で、ロールバック可能かつ監査可能な SKILL.md 成果物と、ハーネスのオーケストレーション、サンドボックス化、承認、トレーシング。

NorthwindとBastienは説明のための合成ケースであり、特定の組織ではありません。原典は執筆時点の公開トーク、記事、分析(Groveのトーク、GitHubとAWSのローンチ、Tesslのポジショニング、BöckelerによるThoughtworksの分類)に基づき、クレジットを付して要約しています。15語未満の引用断片は属性を明記しています。実践者の数値(指示バジェット、ファイル長ガイダンス、委任ウィンドウのレポート)はコミュニティのガイダンスであり、対照実験ではありません。設定スニペットは可読性のために簡略化されており、実際の製品スキーマではありません。TrueFoundryの機能は執筆時点の公開ドキュメントを反映しています。最新のドキュメントでご確認ください。

‍

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

LangChain vs LangGraph:どちらが最適か?

比較
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

Claude Fable 5: API、ベンチマーク、料金、使い方

エンジニアリングとプロダクト
openrouter vs litellm
November 16, 2026
|
5 min read

LiteLLMとOpenRouter:あなたに最適なのはどちらか?

比較
November 16, 2026
|
5 min read

大規模言語モデルにおけるトランスフォーマーアーキテクチャ

LLM用語
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour