説明
Spec-first Agentic Developmentは、AIコーディングエージェントと連携するための構造化されたアプローチを導入し、すべての変更が明確に定義され、レビューされた仕様によって開始されることを保証します。この方法論は、開発ライフサイクル全体にわたって人間の監視と自動チェックを統合することにより、AIエージェントによって開発されたコードの信頼性と保守性を向上させることを目的としています。
続きを読む
コアの原則は、すべての開発タスクをリポジトリに保存された文書化された仕様から開始することです。この仕様は、目標、関連する事実（ファイルおよび行の参照を含む）、実施すべきステップ、そして正確な「完了」基準を概説します。コードが書かれる前に、新しいレビュアーが既存のコードベースに対して仕様を確認し、その正確性と実現可能性を検証します。承認されると、AIエージェントは独自の隔離されたブランチと作業ツリーで機能を構築します。最終的なコミットは、すべての事前定義されたチェックとテストが合格した後にのみメインリポジトリに適用され、コードの品質と仕様への準拠が保証されます。
このシステムは、従来の「バイブコーディング」とは大きく異なり、アドホックなプロンプトをレビューされた持続的な仕様に置き換えます。エージェントが行った各決定は、その理由と共に記録され、明確な監査証跡を提供し、開発後の文書化の必要性を減少させます。仕様は、過度に正確なコード生成器ではなく、意図とアーキテクチャを明確にするように設計されており、テストとコミットゲートが必要な精度を提供します。古い仕様は、コミットと同様に不変の変更記録として扱われ、更新されることはなく、陳腐化を防ぎます。
Spec-first Agentic Developmentは、並行開発をサポートし、複数のエージェントが異なる仕様に同時に取り組むことを可能にします。プロセスは中断されず、レビューされた仕様がオープンな質問に事前に回答するため、エージェントは直接「完了」基準に基づいて構築できます。全体のワークフローは構造化されており、1つの仕様が1つのブランチおよび1つのコミットに対応し、プルリクエストを簡素化し、一貫性を確保します。状態は`context.yaml`に保持され、再起動後でも作業を再開可能にします。
この方法、テンプレート、およびClaude CodeプラグインはすべてMITライセンスで提供されており、コストのかからないソリューションです。Claude Codeプラグインは帳簿管理とゲート機能を自動化しますが、他のエージェント（Codex、Cursor、Copilotなど）でも`AGENTS.md`に従い、ゲート用のgit commit-msgフックをインストールすることで採用できます。このアプローチは、オープンソースのエージェントソフトウェアファクトリーであるAgent Smithの作成を通じて開発および洗練され、その実用性と効果を示しています。
- カテゴリーAI コーディングアシスタント
- 料金モデル無料
- デプロイクラウド
- プラットフォームWeb
Spec-first Agentic Developmentの主要機能
AIコーディングエージェントのための仕様主導の開発
構築前にコードと照らし合わせて確認されたレビュー済み仕様
各開発タスクのための隔離された作業ツリー
すべてのチェックが合格することを要求するゲート付きコミット
リポジトリに保存された持続的な仕様
トレーサビリティのための理由付きの決定ログ
ユニークなブランチIDを使用した並行開発のサポート
context.yamlに保存された状態で再開可能なワークフロー
MITライセンスの方法、テンプレート、およびClaude Codeプラグイン
Codex、Cursor、Copilot、およびターミナルとの互換性
コミットゲートを強制するためのgit commit-msgフック
仕様の引用に対する自動証拠チェック
単一または一連の仕様のための構造化されたプルリクエスト
既存のコードベースから生成されたコンテキストとルール
Agent Smithのビルドプロセスに手書きのコードは不要
Spec-first Agentic Developmentの使い方は？
プラグイン/フックのインストール: プロジェクトクローンにClaude Codeプラグインまたはgit commit-msgフックをインストールします。
プロジェクトのブートストラップ: /spec-first:bootstrap-projectを実行して、既存のコードからコンテキストとルールを生成します。
仕様の作成: create-specスキルを使用して、目標、ステップ、事実、および完了基準を定義した新しいタスクを作成します。
仕様のレビュー: 新しいレビュアーにコードに対して仕様の正確性と実現可能性を確認させます。
仕様の適用: エージェントはプロジェクトルールに従って、独自のブランチと作業ツリーで仕様を構築します。
仕様の納品: すべてのチェックが合格することを確認し、ゲートを通じて変更をコミットし、プルリクエストを開きます。
シリーズの納品: 大きな変更の場合は、/spec-first:deliver-seriesを使用して、複数の相互依存する仕様を管理および納品します。
Spec-first Agentic Developmentの使用例
- AIエージェントコード開発
- コード品質の確保
- 複雑なプロジェクトの管理
- コードのトレーサビリティの向上
- コードレビューの促進
- 開発ワークフローの自動化
- 新しい開発者のオンボーディング
- 既存ツールとの統合
