【結論】要件定義から実装へ進める
Claude Codeで要件定義を行う際は、要望をFunctional、Non-functional、Constraint、Acceptance Criteria、Out of Scopeへ分解します。
Planモードで既存コードと利害関係を調査し、未確認事項と意思決定を明示します。
要件書を作った直後に履歴を消す必要はなく、必要な文脈は/compactで保持できます。
# ターミナルで実行：Planモードで開始
claude --permission-mode plan
# ターミナルで実行：要件用ブランチを作成
git switch -c docs/requirements
# 起動後のセッション内で実行：重要事項を保持して圧縮
/compact 目的、承認済み要件、未決事項、制約を保持してください
# ターミナルで実行：文書差分を確認
git diff -- '*.md'具体的な手順・設定方法
利用者、課題、現在フロー、制約、非対象を確認します。
User Story、Acceptance Criteria、Data、Security、Operationsを作成します。
人間が承認し、要件IDとTestを対応付けて実装へ移ります。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
決済機能の要件定義を支援してください。
利用者、主要フロー、失敗時、冪等性、監査、個人情報、SLO、非対象を質問形式で整理してください。
未回答事項を推測せず、まだファイル編集と外部API調査は行わないでください。注意点・よくあるエラーと対処法
既存コードから抽出した挙動が正しい業務要件とは限りません。
巨大なlegacy_system全体を無条件に読み込ませず、Boundaryごとに調査します。
Planは契約や承認の代替ではなく、Product、Security、Legal、Operationsの確認が必要です。