zhu1090093659/spec_driven_develop

何を解決するか

Spec-Driven Develop は、大規模なソフトウェア変更（移行、再実装、複雑なリファクタリングなど）を、計画を基盤とした構造化されたワークフローで処理できる、アーキテクチャ最優先の AI コーディングエージェント向けのツールです。AI エージェントが進捗を失ったり、誤った計画を無批判に実行したりすることを防ぎます。複雑な実装中に元の意図から逸脱したり、アーキテクチャの後退を引き起こすという一般的な問題を回避します。

動作方法

このプロジェクトは、AI エージェントが読み取り・実行可能な Markdown ベースの「スキル」の集合体であり、プラットフォームに依存しません。7段階のパイプライン（意図の把握、深層分析、計画、実行、検証、アーカイブなど）を実装し、実行テレメトリを監視するクローズドループフィードバックシステム「Adaptive Control」を使用しています。エージェントの進捗が計画から大きく逸脱した場合、システムは自動的にコース補正またはタスクの再分解をトリガーします。

GitHub にネイティブに統合されており、Issues、Milestones、Labels を使ってタスクを追跡し、断片的な PR ではなく、一貫性のある「デリバリー・バッチ」にグループ化して作業を管理します。また、構造化された技術的ブレインストーミング用の「Deep Discuss」と、バグやリグレッションに焦点を当てた「Findings-first」コードレビュー用の「Review SPD」の2つの補助ワークフローも提供しています。

対象ユーザー

Claude Code、Cursor、Windsurf、Aider などの AI コーディングエージェントを使用し、高リスクの大規模なアーキテクチャ変更や、厳密な計画と追跡を必要とする複雑な機能実装を進めている開発者。

特徴

• S.U.P.E.R アーキテクチャ原則：自動化されたヘルスチェックとチェックリストを通じて、単一目的、一方向フロー、実装よりポート、環境非依存、交換可能な部品を強制します。
• Adaptive Control ループ：制御工学をインスパイアしたフィードバックシステム。実行の逸脱が特定のしきい値（20%、40%、60%）を超えた場合、計画の停止または再設計をトリガーします。
• GitHub ネイティブ追跡：自動的に Issues と Milestones を作成し、ワークツリーとバッチ PR を管理して、プロフェッショナルなプロジェクト管理を実現します。
• プラットフォーム非依存：Claude Code、Codex、OpenCode 用のプラグインとして動作するほか、カスタムインストラクションをサポートする任意のエージェント向けに、シンプルな Markdown スキルとしても利用可能。