仕様書作成
入力: work/<feature>/intent.md。出力: work/<feature>/spec.md(factory/templates/spec.md より)。
intent.md、CLAUDE.md、および変更が及ぶコードベースの該当部分を読み込む。コードを読まずに仕様を書くと制約を見落とす。これが最も一般的な失敗である。- ユーザーストーリーを優先順位(P1、P2、P3)で記述する。各P1ストーリーは、単独で出荷可能かつテスト可能でなければならない。
- すべての機能要件に安定したID(
FR-001)を、すべての成功基準にも同様にID(SC-001)を付与する。レビューおよびテストではこれらのIDを参照する。 - 以下の事項については、黙って解決せず、必ずインラインでフラグ付けする:
[NEEDS CLARIFICATION: ...]: 意図が決定を下していないあらゆる決定事項[POLICY: privacy | security | legal | money | brand]: ルールが適用される箇所すべてに、そのルールを付記
- 設計セクションは、計画に必要な範囲でのみ記述する: データ変更、インターフェース、状態、エラーケース。
- 明示的に対象外とする項目を列挙する。
- 仕様を提示し、すべての
[NEEDS CLARIFICATION]を人間と解決してから保存する。spec.mdをコミットすることが、planモードへのトリガーとなる。