spec-first-superpowers

Spec-First + Superpowers Orchestrator v5

AI がすぐにコードを書き始めるのを防ぎます。すべての機能追加、バグ修正、リファクタリングは、まず仕様策定フェーズを経由します。精査されていないコードは、コストのかかるコードだからです。

コマンド

コマンド	効果
/super-spec	一連のワークフローを実行します（自動モード＋複雑度の自動判定）
/super-spec force-spec-kit	Spec-Kit モードを強制します
/super-spec force-openspec	OpenSpec モードを強制します
/super-spec reset	モードの選択をリセットします
/super-spec upgrade	統合されているすべてのプロジェクトで更新を確認し、アップグレードを実行します

仕組み

ステップ 1：モードを選択する

既存のシグナルを確認し、該当しない場合はヒューリスティックに基づいて選択します。

シグナル	モード
.spec-mode ファイルが存在する	ファイルに記載されているモードを使用
.specify/ ディレクトリが存在する	Spec-Kit
openspec/ ディレクトリが存在する	OpenSpec
新規プロジェクトで、ファイル数が 30 未満	Spec-Kit
それ以外	OpenSpec（デフォルト）

選択したモードを .spec-mode に保存し、今後のセッションでも引き継がれるようにします。

モードごとの詳しいワークフローについては、以下を参照してください。

• Spec-Kit：references/spec-kit-workflow.md
• OpenSpec：references/openspec-workflow.md

ステップ 2：複雑度を判定する

AI がレベルを提案し、ユーザーが確認または変更します。

レベル	該当するケース	実行内容
Quick	単一ファイルのバグ修正、誤字、設定	簡易仕様（/opsx:propose または /opsx:ff）→ TDD → アーカイブ
Standard	範囲が明確な単一機能	すべてのフェーズ（UI がある場合のみフェーズ 3）
Thorough	複数モジュール、アーキテクチャ上の判断	すべてのフェーズ＋Agent Teams の評価

ステップ 3：パイプラインを実行する

フェーズ 0 — セッションの復旧（自動） 前回のセッションの task_plan.md が存在する場合は、計画ファイルをすべて読み込み、MemPalace に関連する履歴を問い合わせ（設定されている場合）、5 つの質問による再起動テスト（現在の状況は？／どこに向かっている？／目標は？／何を学んだ？／何をした？）を実行してから、最後のチェックポイントから再開します。

フェーズ 1 — 仕様策定 選択したモードを使って仕様を作成します。Quick タスクでは /opsx:propose を使用し、Standard／Thorough タスクでは /opsx:explore または /speckit.specify を使った一連のフローを実行します。次に進む前に、ユーザーが仕様を明示的に承認する必要があります。 ゲート G1：ユーザーの承認済み＋仕様が憲章に準拠＋仕様のインラインレビューに合格＋スコープ確認済み。

フェーズ 2 — 永続的な計画 planning-with-files と writing-plans を使用して、task_plan.md（ファイル構成の対応付けとテスト項目を含む番号付きチェックリスト）、findings.md、progress.md を生成します。 ゲート G2：すべてのタスクにファイルパス、受け入れ基準、テスト戦略があり、計画のインラインレビューに合格していること。

フェーズ 3 — UI/UX デザイン（条件付き） UI 関連のキーワードが検出された場合のみ実行します。ui-ux-pro-max --design-system --persist を呼び出して、デザインシステムを生成し、永続化します（v2.5.0：67 のスタイル、161 のパレット、57 のフォント、14 の技術スタック、6 つの専門スキル）。 ゲート G3：納品前チェックリストに合格＋ユーザーがデザインを承認。

フェーズ 4 — 実装 次の 2 つの戦略のいずれかを使って実行します（AI が推奨し、ユーザーが選択します）。

• サブエージェント主導：タスクごとに新しいサブエージェントを使用＋2 段階のレビュー（仕様への準拠→コード品質）＋タスクの役割に応じたモデル選択＋実装担当者のステータス処理（DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED）
• 計画実行：バッチ実行＋チェックポイントレビュー

全体を通じて TDD を実施します。エラーは 3-Strike プロトコルを通じてエスカレーションし、systematic-debugging を実行します。 ゲート G4：すべてのテストに合格＋レビューに合格＋検証の証拠を progress.md に記録済み＋/opsx:verify に合格（利用可能な場合）＋MemPalace にアーカイブ済み（設定されている場合）。

フェーズ 5 — アーカイブ finishing-a-development-branch を実行 → すべてのチェックボックスを更新 → 仕様関連の成果物をアーカイブ → progress.md に最終エントリを記録 → MemPalace に日誌を記録（設定されている場合）。

品質ゲート

各ゲートは必須の停止ポイントです。すべてのチェックに合格するまで、先には進めません。ゲートに失敗した場合は、問題を修正して再評価してください。ゲートの基準の詳細：references/quality-gates.md

拙速防止

ユーザーから仕様策定フェーズを省略するよう求められた場合は、丁寧に断り、/super-spec を案内してください。このスキルの目的は、時期尚早な実装を防ぐことです。

参照ファイル

必要に応じて以下を読んでください。詳細な手順が記載されており、このファイルが肥大化するのを防げます。

ファイル	読むタイミング
references/quality-gates.md	いずれかのゲート（G0-G4）を評価するとき
references/synergy-patterns.md	ツール間連携（6 つのチェーン）を理解するとき
references/integration-guide.md	セットアップ、トラブルシューティング、依存関係の一覧を確認するとき
references/spec-kit-workflow.md	Spec-Kit のワークフローを実行するとき
references/openspec-workflow.md	OpenSpec のワークフローを実行するとき
references/mempalace-integration.md	MemPalace のメモリーシステムのセットアップと 5 つの統合ポイントを確認するとき
references/upgrade-protocol.md	/super-spec upgrade — 標準化されたバージョン同期手順
assets/constitutions/openspec-constitution.md	OpenSpec の憲章テンプレート
assets/constitutions/spec-kit-constitution.md	Spec-Kit の憲章テンプレート