本文へスキップ
hdknr blog
戻る

組織で仕様駆動開発(SDD)を広げる 6 つの段階 — Spec Kit を個人の実験からチームの開発能力へ

仕様駆動開発(Spec-Driven Development、SDD)は、たいてい「開発者 1 人・リポジトリ 1 つ・具体的な課題 1 つ」から始まります。GitHub Spec Kit を入れて、constitution・spec・plan・tasks を作り、AI エージェントに実装させます。ここまでは個人でもすぐに回せます。

難しいのはその先です。マイクロサービスで複数のリポジトリがあり、全社の標準があり、Spec Kit を使っているチームといないチームが混在し、経営層からは成果が見えない。この状態で SDD を「組織の開発能力」にするにはどうすればよいのでしょうか。

Microsoft Tech Community(ブラジル開発者向けブログ)に、この問いに答える記事が 2026 年 11 月 15 日に公開され、X でも紹介されていました。

本記事では、この記事が示す 6 つの段階(実験 → 再現性 → 一貫性 → 協調 → ガバナンス → 計測)と、実際に進めるときの考え方を日本語で整理します。SDD や Spec Kit そのものの説明は、以下の記事を参照してください。

前提:SDD は「AI に先に文書を書かせること」ではない

元記事はまず、SDD の定義をはっきりさせます。SDD とは、AI にコードより先に文書を書かせることではありません。変更の意図を、デリバリーが終わるまで明示的かつ検証可能な形で保ち続けること です。

Spec Kit は成果物を整理して作業を速くします。ただし、仕様を書き、レビューし、検証するという実践そのものは、Markdown とチーム内の取り決めだけでも成り立ちます。そのため元記事は「プロセスの問題を解決するコマンドを探さないこと」を勧めています。

組織で SDD が広がらないときに、テンプレートやエージェントを足すのは筋が違います。先に探すべきなのは、どの調整の問題が実践の前進を止めているか です。

6 つの段階の全体像

元記事は SDD の成熟を 6 つの段階で説明します。ただし「厳密な順序でも認定モデルでもなく、実務の目安」だと断っています。各段階の最後には、次へ進んでよいかを判断する 「進化の合図(Sinal de evolução)」 が書かれています。

組織で SDD を育てる 6 つの段階を示す図。個人・1 リポジトリの段階として「1. 実験(意図を明示する)」「2. 再現性(チームの実践にする)」、複数チーム・複数リポジトリの段階として「3. 一貫性(共通ルールと現場の裁量)」「4. 協調(リポジトリの境界を越える)」、組織の仕組みの段階として「5. ガバナンス(開発フローに組み込む)」「6. 計測(活動ではなく結果を測る)」が左から右へ並び、それぞれの下に次へ進む合図が書かれている

段階目的次へ進む合図
1. 実験変更の意図を明示する作者と話さなくても、他の人が変更の意図を理解できる
2. 再現性個人の経験をチームの実践にする「Spec Kit の専門家」に頼らず、チームが理解して回せる
3. 一貫性共通のガードレールと現場の自律を両立する何が必須で、何を調整してよく、誰が決めるかをチームが区別できる
4. 協調リポジトリの境界を越えて計画する分散した変更が 1 つのデリバリーにどう寄与し、その互換性をどう検証しているかを説明できる
5. ガバナンスSDD を開発フローに組み込む不要な承認の連鎖を作らずに、不確実さと手戻りが減る
6. 計測活動ではなく結果を評価する証拠を、遵守の強制ではなく実践の調整に使っている

以下、段階ごとに要点を見ていきます。

1. 実験:意図を明示する

最初の段階の目的は、作業の定義の質を上げることです。

元記事が勧めるのは、実装の前に 「ゼロフェーズ(文脈の準備)」 を置くことです。ユーザーストーリー、受け入れ基準、プロダクトの文書、既存のコード、テスト、デプロイ上の制約を集めます。とくに既存システムに手を入れるときに効きます。

そのうえで、問題・期待する振る舞い・制約・受け入れ基準を、実装より前に言葉にします。

疑問が出たときの扱いも具体的です。

AI の推測が、黙って要件に化けてはいけない という点が、この段階の肝です。

2. 再現性:チームの実践にする

1 人がうまく回せても、その人がいなくなれば止まります。2 つ目の段階では、それをチームのものにします。

元記事は、成果物ごとに「レビューで問うこと」を 1 つずつ割り当てています。

成果物レビューで問うこと
constitution.md原則と制約は、このプロジェクトのあるべき作り方を反映しているか
spec.md要件は明確で、漏れがなく、テスト可能か
plan.md方針は実現可能で、依存関係・リスク・検証を考慮しているか
tasks.mdチームが理解できる順序で作業を実行できるか
分析・チェックリスト解決すべき矛盾・抜け・保留事項はどれか

PR は実装のときではなく、成果物を作った時点から 始めることを勧めています。ただしファイルごとに PR を分ける必要はなく、spec の PR・plan の PR・実装の PR のどこにチェックポイントを置くかは、リスクに応じてチームで決めます。

流れは「原則 → 仕様 → 明確化 → 計画 → タスク → 一貫性の分析 → 実装」で、最後に 仕様と実際にデリバリーしたものが一致しているか(収束) を確かめます。

運用面の準備も見落とせません。承認済みのツール、リポジトリへのアクセス、AI 利用ポリシー、制約に合ったインストール方法を確認します。元記事は、オフラインでインストールできても、エージェントが接続や承認なしで動けるわけではないと注意しています。既存リポジトリに導入するときは、初期化で生じた差分をレビューし、すでに承認済みの指示・パターン・成果物を壊さないようにします。

3. 一貫性:共通のガードレールと現場の自律

チームが増えると、標準化とチームの自律がぶつかります。元記事は、指針を 3 つの層に分けることを提案しています。

  1. 全社の原則:要件とガードレール
  2. 技術標準:API・イベント・言語・プラットフォーム
  3. 現場の判断:ドメインやサービス固有の事情

共有の constitution に共通の原則を書くことはできます。しかし、それだけでは配布と更新の問題は解けません。各リポジトリが新しい版をどう取り込むか、影響を誰が評価するか、例外をどう記録するか。これを決めておかないと、コピーはやがてばらばらになります。

現場で得た学びは、テンプレート・プレイブック・再利用できるパターンとして戻します。共有できるのは spec、本番環境の要件、テスト戦略、IaC、検証基準などです。ただし、機密や特定案件の情報を取り除くキュレーションが必要です。元記事は、再利用とは「コピー」ではなく「適応」だとしています。

4. 協調:リポジトリの境界を越える

ユーザーに届く 1 つの機能(ケイパビリティ)は、API・イベント・非同期処理・UI にまたがります。各リポジトリの計画が個別には正しくても、全体としては噛み合わないことがあります。

ここで元記事が示す選択肢が アンカーリポジトリ です。

アンカーリポジトリと各サービスのリポジトリの関係を示す図。共通パターン(全社原則・技術標準・共有 constitution)を参照するアンカーリポジトリが、ケイパビリティの目的・範囲・契約・依存関係・E2E の受け入れ基準を持ち、API サービスとイベント消費側のそれぞれのリポジトリにスライスを渡す。各リポジトリは spec の見直しと plan の検証をしてから実装し、最後に統合受け入れで検証済みバージョンとデプロイ順を確認する

元記事はこれを「プロセスはアンカーリポジトリで始まるが、各サービスの文脈で完結する」と表現しています。サービス単位の初期タスク分解はアンカー側で考えてよいものの、その順序を固定してはいけません。各チームは spec を見直して明確化し、plan を自分たちのコード・constitution・ローカル標準と突き合わせて検証します。単純な変更なら、共有の Issue 1 つで足りることもあります。

GitHub の機能との対応にも触れています。

もう一つ重要な指摘があります。2 つのリポジトリで PR が緑でも、それだけでは統合されたケイパビリティが完成した証明にはならない という点です。検証済みのバージョンを記録し、デプロイ順を計画します。サービスをまたいだアトミックなマージやロールバックは存在しません。そのため、データ・契約・すでに起きた副作用も考慮に入れる必要があります。

5. ガバナンス:開発フローに組み込む

5 つ目の段階では、SDD を既存のエンジニアリングの仕組みとつなぎます。元記事は、それぞれの仕組みが「何をして、何をしないか」を表にしています。

仕組みすることしないこと
GitHub Actionsチェックを実行する中身の質は保証しない(ファイルの存在しか確かめられない)
CODEOWNERSパスに応じてレビュー依頼を振り分けるそれだけでは承認を必須にしない
Rulesets / ブランチ保護チェックや承認を強制するビジネス上の妥当性は判断しない(バイパスの管理も要る)
Copilot coding agentスコープが決まった変更を準備する人間の承認の代わりにはならない
Environmentsデプロイを制御するマージの承認を本番リリースの承認に置き換えない

段階ごとの責任分担も示されています。

工程関わる人責任を持つ人
仕様プロダクト・開発・QA要件のオーナー(テックリードがレビュー)
計画開発・アーキテクチャ・サービスオーナーテックリード
タスクと実装開発・QA技術オーナー+ピアレビュー
統合受け入れ各サービスのチーム・QAケイパビリティのオーナー+プロダクトの受け入れ

ここでのキーワードは 「関わる(envolvido)」と「責任を持つ(responsável)」の区別 です。開発者を巻き込んでも、判断を検証する責任が消えるわけではありません。

自動化について元記事が描くのは、4 つの役割が回る「半自動のサイクル」です。

決定的な計測・AI による提案・人間の判断を分けて扱うのが原則です。チェックは最初は情報提供にとどめ、慣れてからブロッキングにします。ワークフローには最小権限を与え、シークレットを保護し、信頼できない PR のコードを特権付きで実行しないようにします。例外には理由・オーナー・見直し日を付けます。

なお、こうしたスキャナーとそのルールは自分たちで作って保守するものであり、Spec Kit に最初から入っているものではない、と元記事は念を押しています。

6. 計測:活動ではなく結果を測る

最後の段階で元記事が強調するのは、Copilot の利用は SDD の定着と同じではない ということです。文書の数、コマンドの実行回数、インストール数は「どこまで届いたか」を示すだけで、エンジニアリングが良くなったかどうかは示しません。

代わりに提案されている観点は次の 5 つです。

観点見るもの
トレーサビリティ変更が spec → 実装 → 検証とつながっているか
明確さ曖昧な要件による手戻り
協調サービスをまたぐ依存関係を、実装前に見つけられたか
レビューレビューにかかる時間と、求められた修正の種類
持続性一部の人に頼らず実践が続いているか

指標にはベースラインと文脈が要ります。リードタイムが変わっても、それを自動的に SDD の成果と見なしてはいけません。spec.md・plan.md・tasks.md が揃っていることは「存在」を示すだけで、正しさや安全性を示すものではありません。スコアで定性的な分析を置き換えることもできません。

実際にどう進めるか

2 つの協調モデル

元記事は、今の進め方と比べてみるべきモデルを 2 つ挙げています。

(b) を選ぶなら、計画の規律、互換性のある契約、要件に紐づいたテストが条件になります。変更は自己完結させて後方互換に保つのが基本です。たとえば、あるサービスが新しい任意属性を「受け取れる」ようにしてから、別のコンポーネントがそれを「送る」ようにします。こうしてデプロイと有効化を分けます。

どちらのモデルでも、要件には安定した ID を振ってテストと結びつけます。元記事の例では「AC-03」という受け入れ基準は、タスクの本文に書かれているだけでは不十分で、検証の証拠が必要です。

2 つのモデルは共存できます。単純な変更はローカルで、横断的なケイパビリティは合同で計画する、という使い分けです。元記事は「中央集権化を強めれば、自動的に成熟度が上がるわけではない」とも書いています。

展開の順序

まず開発フローを明示します(成果物をいつレビューするか、誰がどの判断に責任を持つか、ブランチと PR の使い方、依存関係の記録方法)。自動化と計測はその後です。展開は次の順に進めます。

  1. 診断:どこで詰まっているかを特定する
  2. 基盤づくり:フローと責任分担を決める
  3. パイロット:1 つのサービスで試す
  4. 段階的な自動化:情報提供のチェックから始める
  5. 拡大:プレイブック、チャンピオン(各チームの推進役)、成果の追跡

次の段階に進むかどうかは、日付だけで決めず、得られた学びと合意した終了条件で判断します。

詰まっている場所の見分け方

診断のヒントも具体的です。

コストの確認

ツールキット自体はオープンソースですが、AI のライセンス、ワークフローの実行時間、ランナー、ストレージには費用がかかることがあります。パイロットを広げる前に、機能の有効化、権限、利用上限、オーナーを確認します。価格やクォータは変わるので、その時点の公式ドキュメントで確かめるよう勧めています。

まとめ

元記事の結論は、SDD を広げるとは すべてのリポジトリに同じファイル構成をコピーすることではない、というものです。意図・判断・実装・検証をつなぐ「共通のやり方」を組織として作ることが目的です。

Spec Kit はその道のりを支える道具です。しかし成熟度を決めるのは、組織がこの実践を自分たちのアーキテクチャと働き方にどう組み込むかです。そうなったとき、仕様は個人の道具ではなくなり、人・チーム・サービスのあいだで共有される「理解の契約」として機能します。

元記事を紹介した X の投稿(参考リンク参照)が勧めるとおり、まずは 1 つのサービスで試す ところから始めるのが現実的でしょう。そのときは全体像の表にある「次へ進む合図」を手元に置き、自分たちがまだ満たしていない合図はどれかを確かめてください。どの段階で詰まっているのかが見えてきます。

参考リンク



前の記事
エージェント同士に会話させる — Claude Code の 3 つの経路と A2A の使い分け
次の記事
Gemini Decisions API とは — 文章ではなく「確率」を返す Google 版の判定 API