1 件ずつ計画・実装する¶
このページでは、1 つの Spec 項目（ Spec-backed item ）を Requirements から実装検証まで、成果物と Gate を段階ごとに確認しながら進めます。SpecBind を初めて使うとき、影響の大きい変更を慎重に進めたいとき、または特定のフェーズだけをやり直すときに向いています。
Milestone と対象 Spec は、先に Discovery で作成しておきます。まだ進行中の Milestone がなければ、新規プロジェクトまたは 既存プロジェクトの導入手順から始めてください。
以下では対象 Spec をcsv-exportとします。Codex では$、Claude Code では/でスキルを呼び出します。
1. 現在地と対象を確認する¶
Roadmap の分類、依存関係、現在有効な Gate、次に進められる操作を確認します。このページの手順は Spec 項目向けです。Direct 項目には Requirements、Design、
Contract、Tasks を作らず、sb-implement <item-id>へ直接進みます。
2. Requirements を作成する¶
Requirements は今回の差分だけではなく、その Spec が現在保証する振る舞い全体です。 Brief が Source Items を指定している場合は、採用する内容が正規の Requirement と Acceptance Criteria へ書き直されていることを確認します。
内容をレビューし、Requirements Gate を承認します。判断が必要な点が残っている場合は、 先へ進めるために曖昧な文言へ丸めず、ここで解決します。
3. Design と Contract を作成・検証する¶
Design は Requirements をどう実現するかを定め、Contract は外部責任、依存関係、所有するファイル境界を構造化します。Design 作成後には、独立した検証が Requirements の網羅、
責任境界、検証可能性を確認します。検証がREADYになってから Design Gate を承認します。
検証で問題が見つかった場合は、具体的な指摘を Design へ反映して再検証します。 Requirements 自体の問題なら、Design で補わず Requirements へ戻します。
4. Milestone 全体の Contract をレビューする¶
Contract レビューは 1 つの Spec だけを見る処理ではありません。進行中の Milestone に含まれる全 Spec の Design が準備できてから、所有権の重複、循環依存、互換性、統合時の抜けをまとめて確認します。
ほかの Spec の Design が未完了なら、この時点で待つ必要があります。その Spec も個別に手順 3 まで進めるか、複数 Spec をまとめて計画する場合は Plan と Drive で Milestone を進めるを使います。
5. Tasks を作成する¶
Tasks は Requirements と Design を実行可能な順序へ分解します。各 Task の対象、完了条件、 検証方法、Requirement への対応を確認してから Tasks Gate を承認します。
Tasks 承認までは計画です。この時点では実装は始まっていません。
6. 1 つの Roadmap 項目を実装する¶
Implement は 1 回につき 1 つの Roadmap 項目を担当します。Spec 項目では Task を順番に処理し、各 Task について実装、レビュー、検証、CLI への進捗記録、プロジェクトのアダプターが定めたチェックポイントを完了してから次へ進みます。
実装中に Requirements、Design、Contract、Tasks の問題が見つかった場合、Implement は上流成果物をその場で書き換えません。新しい診断で所有フェーズを特定し、必要な Gate を明示的に無効化して、そのフェーズのスキルからやり直します。
7. Spec 全体を検証する¶
全 Task が完了したら、個々の Task ではなく Spec 全体を検証します。
検証は現在の Requirements と Design に対して実装を評価します。結果がGOとなり、CLI が完了を裏付ける記録（ completion evidence ）を受理すると、その Spec 項目は完了です。依存していた別の Roadmap 項目が新たに着手可能になることもあります。
8. 次の境界を選ぶ¶
Milestone に未完了項目があれば、次の項目で同じ手順を繰り返します。ここからまとめて進めたい場合はsb-driveへ切り替えてもかまいません。Drive は現在の CLI 状態から再開するため、このページで進めた内容をやり直しません。
すべての実装検証が終わっても、リリースはまだ実行されていません。公開と Milestone の確定処理は、別途リリースするから明示的に進めます。
この進め方を選ぶ場面¶
- 最初の 1 件で各成果物と Gate の役割を理解したい
- Requirement や設計判断を段階ごとに自分で確認したい
- 影響の大きい Spec をほかの項目と切り離して進めたい
- 無効化後に、所有フェーズから限定的にやり直したい
Milestone に複数の独立項目があり、安全に進められる範囲をまとめて進めたい場合は、 Plan と Drive で Milestone を進めるへ進んでください。