sddadd

SDD + ADD スターターテンプレートは、AIプログラミングアシスタント、特に Claude Code 向けのガバナンスフレームワークです。その主な目的は、AIアシスタントを、Spec-Driven Development (SDD) ワークフローと Agent-Driven Development (ADD) を組み合わせた規律ある開発パートナーに変えることです。 ## コアワークフロー このテンプレートは、CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync という順次の開発ワークフローを適用します。各ステップにはチェックポイントがあり、エージェントが実行を許可される前に人間の承認が必要です。 ## 3つの基本ルール 1. **コードではなくスペックを編集する**: 要件が欠落している、または曖昧な場合は、`/sdd-update` コマンドを使用してまずスペックを更新し、動作を変更する前にレビューします。 2. **技術的な推測をしない**: Plan、Tasks、実行では、`.sdd/architecture-profile.md` で承認されたバインディングと正確な検証コマンドのみを使用します。 3. **人間が決定する**: エージェントは自己承認せず、`git push` せず、デプロイせず、物理的な状態変更を自律的に実行しません。 ## 所有権と実行 このテンプレートは、`.sdd/shared_context.md` で2つの独立した軸を分離します。 - **プロジェクト所有権** (`solo` または `team`): 人間によるレビューの有効性と Git 配信ポリシーを決定します。デフォルトは `team` です。 - **エージェント実行** (`direct` または `orchestrated`): `/add-execute` は現在のエージェントで直接実行するか、ランタイム機能を確認した後にワーカーをオーケストレーションします。 ## ドキュメント このテンプレートは、包括的なドキュメントシステムを提供します。 - **クイックスタート** (`docs/sdd-add-quickstart.md`): 初心者向けのステップバイステップのロードマップ。 - **運用ガイド** (`docs/sdd-add-guide.md`): 成果物、ゲート、所有権を理解します。 - **クイックリファレンス** (`docs/sdd-add-field-guide.md`): シナリオに応じてコマンドを選択します。 - **シナリオプレイブック** (`docs/sdd-add-scenario-playbook.md`): グリーンフィールド、ブラウンフィールド、エラー、ハンドオフを処理します。 - **アーキテクチャプロファイルガイド** (`docs/architecture-profile-guide.md`): バインディングと技術コマンドを選択します。 - **実行ガイド** (`docs/multi-agent-orchestration-guide.md`): タスク/機能の実行とワーカーのオーケストレーション。 ## 正規ソース - `.claude/skills/`: コマンドの契約。 - `.claude/skills/_shared/ai-review-protocol.md`: レビュープロトコル、方法論、アクションレコード。 - `.sdd/architecture-profile.md`: 技術バインディングと正確な検証コマンド。 - `CONSTITUTION.md`: セキュリティ、アーキテクチャ、品質に関するハードルール。 - `AGENTS.md`: エージェントのスコープと権限。 ## ユーティリティスクリプト - `scripts/self-heal.sh`: 承認されたコマンドを実行して証拠を収集します。ソースを変更したり、再試行したりしません。 - `scripts/template-smoke.sh` / `.ps1`: ファイル、リンク、ポリシー契約の静的チェック。 - `scripts/adopt.*`: 既存のリポジトリにテンプレートを採用します。 - `scripts/update.*`: テンプレートから更新を取得します。ガバナンスファイルはレビューのためにステージングされます。