方法論とプロセス
AIオーグメンテッド開発メソドロジー
仕様駆動設計、テスト駆動設計、ヒューマン・イン・ザ・ループ
Eastgate Software - ドイツのエンジニアリング基準。エンタープライズグレードの成果。
AIオーグメンテッド開発メソドロジー: 仕様駆動設計、テスト駆動設計、ヒューマン・イン・ザ・ループ
多くのチームはAIにプロンプトを投げて結果を期待するだけです。私たちは仕様が実行可能なアーティファクトになる構造化された方法論を使用しています。AIエージェントがそこからビルドし、実装、テスト、ドキュメントを単一の信頼できるソースから駆動します。3つの柱:仕様駆動設計はコードの前に要件をエンコード。テスト駆動設計は具体的な例で検証。ヒューマン・イン・ザ・ループはAIが判断を補完するが置き換えないことを保証。
はじめに
なぜほとんどのAI支援チームはいまだに品質に悩んでいるのか?
AIコーディングアシスタントはコードを書く速度を変えました。しかし、正しいコードを書く難しさは変わっていません。ボトルネックは入力速度ではなく、ビジネスのニーズと開発者の理解の間のギャップでした。
要件がチャット履歴に存在する場合、AIは予測不可能な結果を生成します。監査証跡がなく、共有理解がなく、意図を検証する方法がありません。チームはより速くイテレーションしますが、より多く手戻りします - 入力が十分に正確でなかったからです。
私たちの方法論は意図と実装の間に軽量な仕様レイヤーを導入します。要件はコードが書かれる前に具体的な例を持つ構造化された振る舞い優先の仕様としてエンコードされます。この方法論はSpecification by Example(Gojko Adzic、Manning 2011)、オープンソースのOpenSpecフレームワーク(Fission AI、33K+スター)、そしてSiemens Mobility、FinTechプラットフォーム、エンタープライズSaaSのシステムデリバリーの経験に基づいています。
第I部
3つの柱とは何か?
順次フェーズではなく、ライフサイクル全体で並行して動作します。
仕様駆動設計 (SDD)
コードが書かれる前に、構造化された振る舞い優先の仕様として要件をエンコードします。AIはアドホックなプロンプトではなく、仕様からビルドします。
テスト駆動設計 (TDD)
実装が始まる前に「完了」を定義する具体的な例で各要件を説明します。仕様からテストを生成し、継続的に検証します。
ヒューマン・イン・ザ・ループ (HITL)
AIはすべてのフェーズを加速しますが、意思決定は人間が担います。仕様は協働で書かれます。AIが提案し、人間がすべてのゲートで承認します。
共通の糸: SDDは意図をエンコードします。TDDは例で検証します。HITLは人間が意思決定を担うことを保証します。これらが組み合わさって、要件と出荷されたソフトウェアの間のギャップを埋めます。
第II部
仕様駆動ワークフローはどのように機能するか?
OpenSpecから適応した提案・適用・アーカイブパターン。各変更は独立したワークスペースです。仕様は実装の詳細ではなく、GIVEN/WHEN/THENシナリオを使用して観察可能な動作を記述します。
| ステップ | 名前 | 何が起こるか | アーティファクト |
|---|---|---|---|
| 1 | 提案 | 意図、スコープ、アプローチを定義します。AIが構造化された提案を生成します。 | proposal.md |
| 2 | 仕様化 | GIVEN/WHEN/THENシナリオとして要件をエンコードします。システムが何をすべきか、どのようにではなく。 | specs/ (delta) |
| 3 | 設計 | AIが承認された仕様から技術戦略を生成します。アーキテクチャの決定を文書化します。 | design.md |
| 4 | 分解 | 設計を順序付けされたタスクリストに分解します。各タスクは単一のフォーカスセッション向けにサイズ調整。 | tasks.md |
| 5 | 実装 | AIエージェントがタスクリストからビルドし、項目をチェックオフします。仕様が生成を駆動します。 | コード + テスト |
| 6 | 検証 | 仕様に対して検証:完全性、正確性、整合性。 | 検証レポート |
| 7 | アーカイブ | デルタ仕様をメインツリーにマージします。生きたドキュメントが自動的に更新されます。 | Updated specs/ |
流動的で硬直していない: 強制されたフェーズゲートはありません。明確な要件のためにすべてのアーティファクトを高速転送します。探索的作業では一度に一つずつステップします。変更はデルタ(ADDED/MODIFIED/REMOVED)として表現 - 完全な書き直しではありません。アーカイブ時、デルタは自動的にメイン仕様ツリーにマージされます。
第III部
仕様駆動はプロンプト駆動開発とどのように比較されるか?
| 次元 | プロンプト駆動 | 仕様駆動 |
|---|---|---|
| AIへの入力 | チャットメッセージ | シナリオを含む構造化された要件 |
| 再現性 | 毎回異なる出力 | 同じ仕様、一貫した結果 |
| 監査可能性 | チャット履歴に埋もれる | コードと並んでバージョン管理 |
| コラボレーション | 一人の解釈 | チームレビュー済み、ステークホルダー承認済み |
| テスト | コード後にテストを作成 | コード前に仕様からテストを導出 |
| ドキュメント | 事後に手動で作成 | 仕様から自動生成 |
| 変更管理 | 毎回フルコンテキストを再説明 | デルタ仕様は変更点のみを表示 |
変化: プロンプト駆動はAIを会話パートナーとして扱います。仕様駆動はAIを設計図を読むビルダーとして扱います。設計図はレビュー、バージョン管理、共有、実行が可能ですが、会話はできません。
第IV部
予測可能に出荷するチームと手戻りするチームを分けるものは何か?
アンチパターン
AIにプロンプトを投げて結果を期待する
ベストプラクティス
コードの前に要件を構造化された仕様としてエンコード
アンチパターン
JiraチケットとSlackに要件を置く
ベストプラクティス
コードと並んでバージョン管理に仕様を保存
アンチパターン
実装後にテストを作成
ベストプラクティス
コードの前に受け入れ基準を定義
アンチパターン
ビジネスユーザーがデリバリー後にレビュー
ベストプラクティス
ステークホルダーが実装前に仕様で協働
アンチパターン
リリース後にドキュメントを手動で作成
ベストプラクティス
実行可能な仕様から生きたドキュメントを生成
アンチパターン
すべての変更に対してフルな仕様セレモニー
ベストプラクティス
適切なサイズ:機能にはフルSDD、修正には軽量アプローチ
第V部
実践的なツールスタックはどのようなものか?
この方法論はツール非依存です。以下は6つのライフサイクルフェーズで実際に使用するスタックです。
仕様化
OpenSpec
AIコーディングアシスタント向けSDDフレームワーク
Kiro
ClaudeによるAWS仕様優先IDE
Claude Code
ターミナルネイティブのエージェンティックコーディング
開発
Claude Code
エージェンティックマルチファイルコーディング
Cursor
AI編集とコンポーザーを備えたIDE
GitHub Copilot
インライン補完とチャット
テスト
Playwright
E2Eブラウザ自動化
Vitest / Jest
ユニットテストと統合テスト
SonarQube
静的解析と品質ゲート
コードレビュー
CodeRabbit
AIによるコンテキスト対応PRレビュー
Copilot Review
GitHub PRでのAI解析
ESLint / Prettier
スタイルとフォーマットの強制
CI/CD
GitHub Actions
パイプラインオーケストレーション
ArgoCD
GitOps継続的デリバリー
Docker / K8s
コンテナオーケストレーション
モニタリング
Datadog
フルスタックAPM
Sentry
エラートラッキング
Grafana
ダッシュボードとアラート
設計上ツール非依存: OpenSpecは20+のAIコーディングツールをサポートします。価値は構造化された仕様プロセスにあり、特定のツールにではありません。
FAQ
よくある質問
従来のアジャイルとどう違うのですか? +
アジャイルのセレモニーは引き続き適用されます。違いは、AIが曖昧なユーザーストーリーの代わりに、正確で監査可能な入力(GIVEN/WHEN/THEN基準を持つ構造化された仕様)を持つことです。チームは実装前に仕様で協働し、誤解による手戻りを削減します。
開発が遅くなりませんか? +
最初に仕様を書くことはコードに直接飛び込むよりも時間がかかります。しかし、AI生成のコードが最初のパスで意図に合致するため、デリバリーは速くなります。小さなバグ修正では完全な仕様プロセスをスキップします - オーバーヘッドは機能やグリーンフィールドプロジェクトでのみ効果を発揮します。
OpenSpecとは何ですか? +
OpenSpecはAIコーディングアシスタント向けのオープンソースSDDフレームワーク(MITライセンス、GitHubスター33,000+)です。ツール非依存(Claude Code、Cursor、Copilot、20+のツールと動作)、ブラウンフィールド優先、イテレーティブです。提案・適用・アーカイブのワークフローは、私たちのクライアントエンゲージメントの構造と一致しています。
ヒューマン・イン・ザ・ループは実際にどのように機能しますか? +
すべての重要な移行には承認ゲートがあります。開発者とステークホルダーが提案で協働します。AIが仕様ドラフトを生成します。チームがレビューします。AIが承認された仕様から実装します。人間が検証します。承認なしには何も出荷されません。人間の修正が仕様履歴に記録され、AIが時間とともに改善されます。
既存のワークフローで使用できますか? +
はい。既存のGitワークフロー、CI/CD、プロジェクト管理の上に重ねて使用できます。仕様はコードと並んで保存されます。ほとんどのチームは段階的に採用します:1つの機能から始め、結果を測定し、拡大します。
ホワイトペーパー全文を読む
詳細なフレームワーク、実装手法、実践的なインサイトを、ビジネスメールアドレスで今すぐご覧いただけます。
Eastgate Softwareについて
Eastgate Softwareは、ベトナム・ハノイに本社を置く戦略的エンジニアリングパートナーです。ドイツ・アーヘンおよび東京に拠点を持ち、200名以上のエンジニア、93%のチーム継続率、12年以上のデリバリー実績を誇ります。Siemens MobilityやYunex Trafficをはじめとする企業向けにミッションクリティカルシステムを構築しています。
AI活用デリバリー手法により、ドイツのエンジニアリング規律とベトナムのエンジニアリング人材を組み合わせ、インテリジェント交通、フィンテック、小売、製造業においてエンタープライズグレードの成果を提供します。
お問い合わせ: contact@eastgate-software.com | (+84) 246.276.3566 | eastgate-software.com
エンジニアリングプロセスを変革する準備はできていますか?
私たちのAI活用メソドロジーがどのようにデリバリーを加速できるか確認しましょう。実際のプロジェクトで2週間のパイロットから始めます。
エンジニア
AI活用デリバリー
継続率
パートナーシップ重視
年間実績
エンタープライズデリバリー