方法論とプロセス

AIオーグメンテッド開発メソドロジー

仕様駆動設計、テスト駆動設計、ヒューマン・イン・ザ・ループ

Eastgate Software Engineering

2025年3月

Eastgate Software - ドイツのエンジニアリング基準。エンタープライズグレードの成果。

方法論とプロセス

AIオーグメンテッド開発メソドロジー: 仕様駆動設計、テスト駆動設計、ヒューマン・イン・ザ・ループ

多くのチームはAIにプロンプトを投げて結果を期待するだけです。私たちは仕様が実行可能なアーティファクトになる構造化された方法論を使用しています。AIエージェントがそこからビルドし、実装、テスト、ドキュメントを単一の信頼できるソースから駆動します。3つの柱:仕様駆動設計はコードの前に要件をエンコード。テスト駆動設計は具体的な例で検証。ヒューマン・イン・ザ・ループはAIが判断を補完するが置き換えないことを保証。

Eastgate Software Engineering 2025年3月 10分で読める

はじめに

なぜほとんどのAI支援チームはいまだに品質に悩んでいるのか?

AIコーディングアシスタントはコードを書く速度を変えました。しかし、正しいコードを書く難しさは変わっていません。ボトルネックは入力速度ではなく、ビジネスのニーズと開発者の理解の間のギャップでした。

要件がチャット履歴に存在する場合、AIは予測不可能な結果を生成します。監査証跡がなく、共有理解がなく、意図を検証する方法がありません。チームはより速くイテレーションしますが、より多く手戻りします - 入力が十分に正確でなかったからです。

私たちの方法論は意図と実装の間に軽量な仕様レイヤーを導入します。要件はコードが書かれる前に具体的な例を持つ構造化された振る舞い優先の仕様としてエンコードされます。この方法論はSpecification by Example(Gojko Adzic、Manning 2011)、オープンソースのOpenSpecフレームワーク(Fission AI、33K+スター)、そしてSiemens Mobility、FinTechプラットフォーム、エンタープライズSaaSのシステムデリバリーの経験に基づいています。

第I部

3つの柱とは何か?

順次フェーズではなく、ライフサイクル全体で並行して動作します。

1

仕様駆動設計 (SDD)

コードが書かれる前に、構造化された振る舞い優先の仕様として要件をエンコードします。AIはアドホックなプロンプトではなく、仕様からビルドします。

GIVEN/WHEN/THENシナリオを使用した振る舞い優先の要件
実行可能で生きたアーティファクトとしての仕様 - 静的なドキュメントではない
デルタベースの変更管理:提案、適用、アーカイブ
ブラウンフィールド優先:既存システムの修正、グリーンフィールドだけではない
2

テスト駆動設計 (TDD)

実装が始まる前に「完了」を定義する具体的な例で各要件を説明します。仕様からテストを生成し、継続的に検証します。

例はすべての要件を説明 - 正確で、現実的で、テスト可能
受け入れ基準とエッジケースからAI生成テストスイート
継続的検証:毎コミットで実行可能な仕様が動作
生きたドキュメント:テストはシステムが何をするかを確実に記述
3

ヒューマン・イン・ザ・ループ (HITL)

AIはすべてのフェーズを加速しますが、意思決定は人間が担います。仕様は協働で書かれます。AIが提案し、人間がすべてのゲートで承認します。

コードの前に開発者、テスター、ステークホルダーが整合
すべての重要な移行でオペレーター承認ゲート
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週間のパイロットから始めます。

000 +

エンジニア

AI活用デリバリー

00 %

継続率

パートナーシップ重視

00 +

年間実績

エンタープライズデリバリー