spec-runner 1.0.6 → 1.0.7

package/templates/.spec-runner/scripts/spec-runner-core.sh

@@ -0,0 +1,282 @@
+#!/usr/bin/env bash
+# spec-runner 判定の単一入口。振る舞い仕様に沿って「フェーズ・ゲート・状態・グレード」を扱う。
+# 使用: spec-runner-core.sh [--phase] [--json] | --gate [GRADE] | --status | --grade
+# cmd-dispatch.sh（次のステップ・ゲート確認・ブランチ作成）から呼ばれる。
+
+set -e
+REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo ".")}"
+cd "$REPO_ROOT"
+STEPS_DIR="${STEPS_DIR:-$REPO_ROOT/.spec-runner/steps}"
+LOCK_FILE=".spec-runner/phase-locks.json"
+PROJECT_JSON=".spec-runner/project.json"
+
+MODE="phase"
+JSON_MODE=false
+GATE_GRADE=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --phase)  MODE="phase" ;;
+    --json)   JSON_MODE=true ;;
+    --gate)   MODE="gate"; GATE_GRADE="${2:-}"; shift ;;
+    --status) MODE="status" ;;
+    --grade)  MODE="grade" ;;
+    *)        [[ "$MODE" == "gate" && -z "$GATE_GRADE" ]] && GATE_GRADE="$1" ;;
+  esac
+  shift
+done
+
+# === 共通: lock / grade / branch を一度だけ読む ===
+has_charter_lock=0
+has_domain_lock=0
+has_arch_lock=0
+has_infra_lock=0
+if [[ -f "$LOCK_FILE" ]] && command -v jq >/dev/null 2>&1; then
+  [[ "$(jq -r '.charter.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] && has_charter_lock=1
+  [[ "$(jq -r '.domain.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] && has_domain_lock=1
+  [[ "$(jq -r '.architecture.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] && has_arch_lock=1
+  [[ "$(jq -r '.infra.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] && has_infra_lock=1
+fi
+
+grade="LOOP1"
+if [[ -f ".spec-runner/grade-history.json" ]] && command -v jq >/dev/null 2>&1; then
+  grade=$(jq -r '.current_grade // "LOOP1"' .spec-runner/grade-history.json 2>/dev/null || echo "LOOP1")
+fi
+
+branch=$(git branch --show-current 2>/dev/null || echo "")
+branch_prefix="feature"
+test_dir="tests"
+test_pattern="*.spec.*"
+if [[ -f "$PROJECT_JSON" ]] && command -v jq >/dev/null 2>&1; then
+  p=$(jq -r '.naming.branch_prefix // empty' "$PROJECT_JSON" 2>/dev/null)
+  [[ -n "$p" ]] && branch_prefix="$p"
+  d=$(jq -r '.test_design.dir // empty' "$PROJECT_JSON" 2>/dev/null)
+  [[ -n "$d" ]] && test_dir="$d"
+  pat=$(jq -r '.test_design.pattern // empty' "$PROJECT_JSON" 2>/dev/null)
+  [[ -n "$pat" ]] && test_pattern="$pat"
+fi
+on_uc_branch=0
+on_other_work_branch=0
+current_uc_id=""
+other_work_pattern="work|infra|cicd"
+if [[ -f "$PROJECT_JSON" ]] && command -v jq >/dev/null 2>&1; then
+  ow=$(jq -r '.naming.other_work_prefixes[]? // empty' "$PROJECT_JSON" 2>/dev/null | tr '\n' '|' | sed 's/|$//')
+  [[ -n "$ow" ]] && other_work_pattern="$ow"
+fi
+if [[ "$branch" =~ ^${branch_prefix}/UC-[0-9]{3}- ]]; then
+  on_uc_branch=1
+  current_uc_id="${branch#*/}"
+elif [[ "$branch" =~ ^${branch_prefix}/(${other_work_pattern})/ ]]; then
+  on_other_work_branch=1
+fi
+
+# === ゲート確認モード ===
+run_gate() {
+  exit_error() { echo "GATE: $1" >&2; exit 1; }
+  GRD="${GATE_GRADE:-$grade}"
+  [[ -f "$LOCK_FILE" ]] || exit_error "phase-locks.json が存在しません"
+  command -v jq >/dev/null 2>&1 || exit_error "jq がインストールされていません（例: brew install jq）"
+
+  check_required_paths() {
+    local key="$1"
+    local list
+    if [[ -f "$PROJECT_JSON" ]]; then
+      list=$(jq -r --arg k "$key" '.required_docs[$k][]? // empty' "$PROJECT_JSON" 2>/dev/null)
+    fi
+    if [[ -z "$list" ]]; then return 1; fi
+    while IFS= read -r path; do
+      [[ -z "$path" ]] && continue
+      if [[ -f "$path" ]]; then
+        :
+      elif [[ -d "$path" ]]; then
+        count=$(find "$path" -maxdepth 1 -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+        [[ "${count:-0}" -ge 1 ]] || exit_error "必須: $path に 1 件以上の .md がありません"
+      else
+        exit_error "必須: $path が存在しません"
+      fi
+    done <<< "$list"
+    return 0
+  }
+
+  if check_required_paths "charter"; then :; else
+    [[ -f "docs/01_憲章/憲章.md" ]] || exit_error "憲章.md が存在しません"
+  fi
+  if [[ "$GRD" == "LOOP1" ]]; then
+    [[ "$(jq -r '.charter.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] || exit_error "Phase 0 未完了（phase-locks.json の charter.completed）"
+    jq -e '.charter.reviewed_by' "$LOCK_FILE" >/dev/null 2>&1 || exit_error "憲章に署名がありません（charter.reviewed_by）"
+    echo "Phase 0: OK"
+  fi
+  if [[ "$GRD" != "LOOP1" ]]; then
+    [[ "$(jq -r '.domain.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] || exit_error "Phase 1 未完了"
+    if check_required_paths "domain"; then :; else
+      for doc in ユビキタス言語辞書 ドメインモデル 集約; do
+        [[ -f "docs/02_ドメイン設計/${doc}.md" ]] || exit_error "${doc}.md が存在しません"
+      done
+    fi
+    echo "Phase 1: OK"
+    [[ "$(jq -r '.architecture.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] || exit_error "Phase 2 未完了"
+    if check_required_paths "architecture"; then :; else
+      [[ -f "docs/03_アーキテクチャ/パターン選定.md" ]] || exit_error "パターン選定.md が存在しません"
+      [[ -f "docs/03_アーキテクチャ/インフラ方針.md" ]] || exit_error "インフラ方針.md が存在しません"
+      [[ $(find "docs/03_アーキテクチャ/設計判断記録/" -name "*.md" 2>/dev/null | wc -l) -gt 0 ]] || exit_error "ADR が 1 件もありません"
+    fi
+    echo "Phase 2: OK"
+  fi
+  if [[ "$GRD" == "A" ]]; then
+    [[ "$(jq -r '.infra.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] || exit_error "Grade A: インフラ設計未完了"
+    if check_required_paths "grade_a"; then :; else
+      [[ -f "docs/04_インフラ設計/schema.dbml" ]] || exit_error "Grade A 必須: docs/04_インフラ設計/schema.dbml が存在しません"
+    fi
+    echo "Phase 4 (Grade A): OK"
+  fi
+  if [[ "$GRD" == "A" || "$GRD" == "B" ]]; then
+    uc_count=$(find docs/05_ユースケース仕様 -mindepth 2 -maxdepth 2 -name "UC-*.md" 2>/dev/null | wc -l)
+    if [[ "${uc_count:-0}" -gt 0 ]]; then
+      uc_reviewed_count=$(jq -r '.uc_reviewed // [] | length' "$LOCK_FILE" 2>/dev/null || echo 0)
+      [[ "${uc_reviewed_count:-0}" -gt 0 ]] || exit_error "Gate 3: uc_reviewed に少なくとも1件の UC 識別子を登録してください"
+      if check_required_paths "gate3_openapi"; then :; else
+        [[ -f "docs/06_API仕様/openapi.yaml" ]] || exit_error "Gate 3: docs/06_API仕様/openapi.yaml が存在しません"
+      fi
+      echo "Gate 3 (UC+OpenAPI): OK"
+    fi
+    test_design_ok=0
+    [[ "$(jq -r '.test_design.completed // false' "$LOCK_FILE" 2>/dev/null)" == "true" ]] && test_design_ok=1
+    if [[ $test_design_ok -eq 1 ]] || [[ -d "$test_dir" && -n "$(find "$test_dir" -type f -name "$test_pattern" 2>/dev/null | head -1)" ]]; then
+      echo "Gate 5 (テスト設計): OK"
+    fi
+  fi
+  if [[ "$GRD" == "A" || "$GRD" == "B" || "$GRD" == "C" ]]; then
+    if [[ -f ".spec-runner/scripts/test/require-tests-green.sh" ]]; then
+      .spec-runner/scripts/test/require-tests-green.sh 2>/dev/null && echo "Gate 6 (テスト通過): OK" || true
+    elif [[ -f "docker-compose.yml" ]] || [[ -f "compose.yml" ]]; then
+      docker compose run --rm app npm test 2>/dev/null && echo "Gate 6 (テスト通過): OK" || true
+    elif [[ -f "package.json" ]]; then
+      npm test 2>/dev/null && echo "Gate 6 (テスト通過): OK" || true
+    fi
+  fi
+  echo "ゲート確認: 通過"
+}
+
+# === フェーズ判定モード ===
+run_phase() {
+  phase=0
+  phase_name_ja=""
+  command=""
+  command_file=""
+
+  if [[ $has_charter_lock -eq 0 ]]; then
+    phase=0; phase_name_ja="憲章策定"; command="憲章"; command_file="$STEPS_DIR/憲章.md"
+  elif [[ $has_domain_lock -eq 0 ]]; then
+    phase=1; phase_name_ja="ドメイン設計"; command="ドメイン設計"; command_file="$STEPS_DIR/ドメイン設計.md"
+  elif [[ $has_arch_lock -eq 0 ]]; then
+    phase=2; phase_name_ja="アーキテクチャ選択"; command="実装計画"; command_file="$STEPS_DIR/実装計画.md"
+  elif [[ $on_uc_branch -eq 1 ]]; then
+    uc_spec=""
+    if [[ -n "$current_uc_id" ]]; then
+      for f in docs/05_ユースケース仕様/*/"${current_uc_id}.md"; do [[ -f "$f" ]] && uc_spec="$f" && break; done
+    fi
+    if [[ -z "$uc_spec" ]]; then
+      phase=3; phase_name_ja="UC 仕様書"; command="仕様策定"; command_file="$STEPS_DIR/仕様策定.md"
+    else
+      uc_dir=$(basename "$uc_spec" .md)
+      reviewed=0
+      [[ -f "$LOCK_FILE" ]] && command -v jq >/dev/null 2>&1 && jq -e --arg u "$uc_dir" '.uc_reviewed[]? == $u' "$LOCK_FILE" 2>/dev/null | grep -q true && reviewed=1
+      if [[ $reviewed -eq 0 ]]; then
+        phase=3; phase_name_ja="UC 仕様書（レビュー通過まで）"; command="曖昧さ解消"; command_file="$STEPS_DIR/曖昧さ解消.md"
+      else
+        if [[ "$grade" == "A" ]] && [[ $has_infra_lock -eq 0 ]]; then
+          phase=4; phase_name_ja="インフラ詳細設計"; command="実装計画"; command_file="$STEPS_DIR/実装計画.md"
+        else
+          has_tests=0
+          [[ -d "$test_dir" ]] && [[ -n "$(find "$test_dir" -type f -name "$test_pattern" 2>/dev/null | head -1)" ]] && has_tests=1
+          if [[ $has_tests -eq 0 ]]; then
+            phase=5; phase_name_ja="テスト設計"; command="テスト設計"; command_file="$STEPS_DIR/テスト設計.md"
+          else
+            phase=6; phase_name_ja="実装"; command="実装"; command_file="$STEPS_DIR/実装.md"
+          fi
+        fi
+      fi
+    fi
+  else
+    if [[ $on_other_work_branch -eq 1 ]]; then
+      phase=3; phase_name_ja="その他作業（CI/CD・インフラ等）"; command="その他作業"; command_file="$STEPS_DIR/その他作業.md"
+    elif [[ $has_arch_lock -eq 0 ]]; then
+      phase=2; phase_name_ja="アーキテクチャ選択"; command="実装計画"; command_file="$STEPS_DIR/実装計画.md"
+    else
+      phase=3; phase_name_ja="UC 開始（仕様策定）"; command="仕様策定"; command_file="$STEPS_DIR/仕様策定.md"
+    fi
+  fi
+
+  if [[ "$JSON_MODE" == true ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      jq -cn --argjson phase $phase --arg name "$phase_name_ja" --arg cmd "$command" --arg file "$command_file" --arg grade "$grade" \
+        '{phase:$phase, phase_name_ja:$name, command:$cmd, command_file:$file, grade:$grade}'
+    else
+      echo "{\"phase\":$phase,\"phase_name_ja\":\"$phase_name_ja\",\"command\":\"$command\",\"command_file\":\"$command_file\",\"grade\":\"$grade\"}"
+    fi
+  else
+    echo "現在フェーズ: Phase $phase（$phase_name_ja）"
+    echo "推奨コマンド: $command"
+    echo "コマンドファイル: $command_file"
+    echo "グレード: $grade"
+    if [[ $on_uc_branch -eq 0 ]] && [[ -n "$branch" ]]; then
+      echo ""
+      echo "注意: main 等のままの修正は危険です。UC 用ブランチを作成してから作業してください（仕様策定ステップでブランチ作成）。"
+    fi
+  fi
+}
+
+# === 状態表示（lock 一覧）===
+run_status() {
+  echo "=== spec-runner フェーズ状況 ==="
+  echo "グレード: $grade"
+  echo ""
+  echo "Lock（.spec-runner/phase-locks.json）:"
+  if [[ -f "$LOCK_FILE" ]] && command -v jq >/dev/null 2>&1; then
+    for sec in charter domain architecture infra test_design; do
+      val=$(jq -r --arg s "$sec" '.[$s].completed // false' "$LOCK_FILE" 2>/dev/null)
+      [[ "$val" == "true" ]] && echo "  ✓ $sec" || echo "  - $sec"
+    done
+  else
+    echo "  phase-locks.json が存在しないか jq がインストールされていません"
+  fi
+}
+
+# === グレード判定チェックリスト ===
+run_grade() {
+  echo "=== spec-runner グレード判定 ==="
+  echo ""
+  echo "STEP 1: 作業の種別を判定する"
+  echo "  → 既存UCの修正・バグfix: Grade C 確定（以降の判定不要）"
+  echo "  → 新規UC: STEP 2 へ"
+  echo ""
+  echo "STEP 2: Grade B 仮置きで UC 草稿を作成する"
+  echo "  → AI と対話して UC 仕様書の草稿（status: draft）を作成する"
+  echo "  → この時点ではまだブランチ作成・コミット不要"
+  echo ""
+  echo "STEP 3: UC 草稿を見て Grade を確定する"
+  echo "  以下のいずれかが草稿に含まれていれば Grade A:"
+  echo "  □ 新しいDB・テーブル・コレクションの追加が必要"
+  echo "  □ 外部API・SaaS との新規連携が必要"
+  echo "  □ 新規クラウドサービスの追加が必要（S3バケット・Redisクラスタ等）"
+  echo "  □ ネットワーク構成の変更が必要"
+  echo "  □ CI/CDパイプラインの変更が必要"
+  echo "  → 一つでも該当: Grade A 確定 → ブランチ作成 → Phase 3（UC仕様書）へ"
+  echo "  → 全て非該当:  Grade B 確定 → ブランチ作成 → Phase 3（UC仕様書）へ（草稿を流用）"
+  echo ""
+  echo "判定結果は .spec-runner/grade-history.json に記録する（ブランチ名には含めない）。"
+  echo "迷ったら上位グレードを選ぶ。"
+  echo ""
+  echo "現在の記録: current_grade = $grade"
+}
+
+# === 実行 ===
+if [[ "$MODE" == "gate" ]]; then
+  echo "=== ゲート確認（グレード: ${GATE_GRADE:-$grade}） ==="
+  run_gate
+elif [[ "$MODE" == "status" ]]; then
+  run_status
+elif [[ "$MODE" == "grade" ]]; then
+  run_grade
+else
+  run_phase
+fi

package/templates/.spec-runner/scripts/test/require-tests-green.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# テストコマンドを実行し、すべてグリーンでないと終了コード 1 を返す。
+# 実装ステップの「完了検証」で必須。コマンドは .spec-runner/project.json の test_command.run で指定。
+# 未設定時はプロジェクトを検出して候補を実行し、設定を促す。
+
+set -e
+REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo ".")}"
+cd "$REPO_ROOT"
+SPEC_RUNNER="${REPO_ROOT}/.spec-runner"
+PROJECT_JSON="${SPEC_RUNNER}/project.json"
+LEGACY_TEST_JSON="${SPEC_RUNNER}/test-command.json"
+
+# 設定を読む: project.json の test_command.run → 後方互換で test-command.json の run
+get_run_command() {
+  local run=""
+  if [[ -f "$PROJECT_JSON" ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      run=$(jq -r '.test_command.run // empty' "$PROJECT_JSON" 2>/dev/null)
+    else
+      run=$(grep -o '"run"[[:space:]]*:[[:space:]]*"[^"]*"' "$PROJECT_JSON" 2>/dev/null | head -1 | sed 's/.*"\([^"]*\)" *$/\1/')
+    fi
+  fi
+  if [[ -z "$run" ]] && [[ -f "$LEGACY_TEST_JSON" ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      run=$(jq -r '.run // empty' "$LEGACY_TEST_JSON" 2>/dev/null)
+    else
+      run=$(grep -o '"run"[[:space:]]*:[[:space:]]*"[^"]*"' "$LEGACY_TEST_JSON" 2>/dev/null | sed 's/.*"\([^"]*\)" *$/\1/')
+    fi
+  fi
+  echo -n "$run"
+}
+
+# 未設定時に検出して実行するコマンドを決める
+detect_and_run() {
+  if [[ -f "package.json" ]] && grep -q '"test"' package.json 2>/dev/null; then
+    echo "npm test"
+    return
+  fi
+  if [[ -f "pyproject.toml" ]]; then
+    if command -v poetry >/dev/null 2>&1; then
+      echo "poetry run pytest"
+    else
+      echo "pytest"
+    fi
+    return
+  fi
+  if [[ -f "go.mod" ]]; then
+    echo "go test ./..."
+    return
+  fi
+  if [[ -f "docker-compose.yml" ]] || [[ -f "docker-compose.yaml" ]]; then
+    # サービス名は app を仮定（未設定時は検出のみで実行しない）
+    echo ""
+    return
+  fi
+  echo ""
+}
+
+RUN_CMD=$(get_run_command)
+
+# 未設定なら検出
+if [[ -z "$RUN_CMD" ]]; then
+  RUN_CMD=$(detect_and_run)
+  if [[ -z "$RUN_CMD" ]]; then
+    echo "require-tests-green: テストコマンドが未設定です。.spec-runner/project.json の test_command.run を設定するか、初期化（init-project.sh）を実行してください。" >&2
+    echo "  例: project.json に \"test_command\": {\"run\": \"npm test\"} を追加" >&2
+    exit 1
+  fi
+  echo "require-tests-green: project.json に test_command がありません。検出したコマンドで実行します: $RUN_CMD" >&2
+  echo "  恒久設定: 初期化で設定するか、project.json に test_command.run を追加してください。" >&2
+fi
+
+echo "require-tests-green: テストを実行しています（$RUN_CMD）..."
+if eval "$RUN_CMD"; then
+  echo "require-tests-green: すべてグリーンです。実装完了の条件（テスト）を満たしています。"
+  exit 0
+else
+  echo "" >&2
+  echo "require-tests-green: テストが失敗しました。実装完了とみなせません。" >&2
+  echo "  テストを修正し、再度 .spec-runner/scripts/test/require-tests-green.sh を実行してください。" >&2
+  echo "  コマンドを変更する場合は .spec-runner/project.json の test_command.run を編集するか、初期化（init-project.sh）を実行してください。" >&2
+  exit 1
+fi

package/templates/.spec-runner/spec-runner.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# spec-runner エントリポイント。次のステップ（現在フェーズ・やるべきステップ .md）を返す。
+# 使用: .spec-runner/spec-runner.sh [次のステップ] [--json|--lock|--グレード]
+
+set -e
+REPO_ROOT="${REPO_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+cd "$REPO_ROOT"
+SR="$REPO_ROOT/.spec-runner/scripts"
+
+cmd="${1:-}"
+shift || true
+
+case "$cmd" in
+  次のステップ|"")
+    if [[ "$cmd" == "" ]]; then
+      # 引数なしは「次のステップ」として扱う（/spec-runner スラッシュコマンド用）
+      :
+    fi
+    case "${1:-}" in
+      --lock)   exec "$SR/spec-runner-core.sh" --status ;;
+      --グレード) exec "$SR/spec-runner-core.sh" --grade ;;
+      *)        exec "$SR/spec-runner-core.sh" --phase "$@" ;;
+    esac
+    ;;
+  *)
+    echo "spec-runner: 引数なし、または「次のステップ」[--json|--lock|--グレード] のみ対応しています。" >&2
+    echo "  使用例: .spec-runner/spec-runner.sh 次のステップ --json" >&2
+    exit 1
+    ;;
+esac

package/templates/.spec-runner/steps//343/201/235/343/201/256/344/273/226/344/275/234/346/245/255.md

@@ -0,0 +1,22 @@
+# その他作業（CI/CD・インフラ・共通設定など）
+
+**このブランチは UC 用ではありません。** `feature/<接頭辞>/xxx` 形式（接頭辞は project.json の **naming.other_work_prefixes** で指定）のため、spec-runner は「CI/CD 構築」「インフラ」「共通設定」など UC 以外の作業用とみなします。
+
+## ブランチの例
+
+- `feature/cicd/github-actions` … CI/CD 構築
+- `feature/infra/docker` … インフラ・コンテナ
+- `feature/work/setup-tooling` … 共通ツール導入
+
+接頭辞は **project.json の naming.other_work_prefixes** に配列で書く（既定: work, infra, cicd）。プロジェクトに合わせて追加・変更してよい。
+
+## やること
+
+- **spec-runner の UC ステップ（仕様策定〜実装）は対象外**。このステップを出したまま、通常の開発フローで進めてよい。
+- 必要に応じて **実装計画.md**（`.spec-runner/steps/実装計画.md`）を参照し、設計書（docs/03, docs/04, docs/06 等）に沿って作業する。
+- 作業が終わったら main にマージするか、UC 用ブランチ（`feature/UC-NNN-xxx`）に切り替えて spec-runner を再実行する。
+
+## 注意
+
+- phase-locks の `uc_reviewed` や UC 用の判定には影響しない。このブランチ用の lock は不要。
+- 再度 spec-runner で「次のステップ」を見たい場合は、UC 用ブランチにチェックアウトするか、main に戻る。

package/templates/.spec-runner/steps//343/202/277/343/202/271/343/202/257/344/270/200/350/246/247.md

@@ -0,0 +1,132 @@
+> **実装タスクの整理**: UC 仕様書（UC-NNN-xxx.md）の**一番下**に「## タスク」または「## タスク一覧」セクションを追加・更新する。タスクは UC の .md 内に記載する。テスト設計は別ステップ「テスト設計」で行う。
+
+## ユーザー入力
+
+```text
+$ARGUMENTS
+```
+
+（空でない場合）処理を進める前にユーザー入力を**必ず**考慮すること。
+
+## 実行前チェック
+
+**拡張フックの確認（タスク生成前）**:
+- プロジェクトルートに `.spec-runner/extensions.yml` が存在するか確認する（任意。なければスキップ）
+- あれば `hooks.before_tasks` のエントリを読む
+- YAML がパースできない・不正な場合はフック確認を静かにスキップして続行
+- `enabled: true` のフックだけを対象にする
+- 各フックの `condition` 式の解釈・評価は行わない（条件が空でなければフックをスキップし、評価は HookExecutor に任せる）
+- 実行可能なフックごとに `optional` に応じて出力する:
+  - **任意フック**（`optional: true`）: 拡張名・コマンド・説明・プロンプト・実行方法を表示
+  - **必須フック**（`optional: false`）: 拡張名・実行するコマンドを表示し、結果を待ってから概要に進む
+- 登録フックがなければ、または `.spec-runner/extensions.yml` がなければ静かにスキップする
+
+## 概要
+
+1. **セットアップ**: リポジトリルートから `.spec-runner/scripts/lib/uc-context.sh --json` を実行する。現在ブランチは feature/UC-NNN-xxx。JSON から FEATURE_SPEC（UC 仕様書）、FEATURE_DIR をパースする。パスは絶対パス。引数にシングルクォートを含む場合はエスケープ（例: 'I'\''m Groot'）またはダブルクォートを使う。
+
+2. **設計ドキュメントの読み込み**: FEATURE_SPEC（UC 仕様書）を必須で読む。UC の「## 実装方針」から技術スタック・構造を読む。無ければ UC 仕様書とプロジェクト既存ファイルから推測する。
+
+3. **タスク整理ワークフローの実行**:
+   - UC の「## 実装方針」から技術スタック・プロジェクト構造を抽出する。無ければ UC 仕様書とプロジェクト既存ファイルから推測する。
+   - spec.md を読み、優先度（P1, P2, P3 等）付きユーザーストーリーを抽出する
+   - data-model.md があればエンティティを抽出しユーザーストーリーにマッピングする
+   - contracts/ があればインターフェース契約をユーザーストーリーにマッピングする
+   - research.md があれば決定をセットアップタスクに反映する
+   - ユーザーストーリーごとにタスクを整理して生成する（下記タスク生成ルール参照）
+   - ユーザーストーリー完了順の依存グラフを作成する
+   - ストーリーごとに並列実行例を作成する
+   - タスクの完全性を検証する（各ユーザーストーリーに必要なタスクが揃い、独立してテスト可能であること）
+
+4. **UC 仕様書へのタスクセクション追加・更新**: **FEATURE_SPEC（UC の .md）の一番下**に「## タスク」または「## タスク一覧」見出しを置き、以下で埋める。既にセクションがあれば内容を更新する。
+   - UC の実装方針から正しい機能名
+   - Phase 1: セットアップタスク（プロジェクト初期化）
+   - Phase 2: 基盤タスク（全ユーザーストーリーの前提）
+   - Phase 3 以降: 優先度順でユーザーストーリーごとに 1 フェーズ
+   - 各フェーズにストーリー目標・独立したテスト基準・（依頼があれば）テスト・実装タスクを含める
+   - 最終フェーズ: 仕上げと横断的関心事
+   - 全タスクは下記チェックリスト形式に厳守する
+   - 各タスクに明確なファイルパスを付ける
+   - ストーリー完了順の依存セクション
+   - ストーリーごとの並列実行例
+   - 実装戦略セクション（MVP 優先・段階的リリース）
+
+5. **報告**: 更新した UC 仕様書（FEATURE_SPEC）のパスとタスクセクションの概要を出力する:
+   - タスク総数
+   - ユーザーストーリーごとのタスク数
+   - 並列実行の機会
+   - ストーリーごとの独立したテスト基準
+   - 推奨 MVP スコープ（多くはユーザーストーリー 1 のみ）
+   - 形式検証: 全タスクがチェックリスト形式（チェックボックス・ID・ラベル・ファイルパス）に従っていることを確認する
+
+6. **拡張フックの確認（タスク追記後）**: UC へのタスクセクション追記後に `.spec-runner/extensions.yml` の `hooks.after_tasks` があれば同様のルールで表示または実行する（なければスキップ）。
+
+タスク整理の文脈: $ARGUMENTS
+
+UC 内のタスクセクションは即実行可能であること。各タスクは LLM が追加文脈なしで完了できる程度に具体的であること。**確定事項の完了は健全性確認（check.sh）で検証される。**
+
+## タスク生成ルール
+
+**重要**: 独立した実装・テストを可能にするため、タスクは**ユーザーストーリーごと**に整理すること。
+
+**テストは任意**: 機能仕様またはユーザーが TDD を依頼した場合にのみ、テストタスクを生成する。
+
+### チェックリスト形式（必須）
+
+各タスクは次の形式に厳守する:
+
+```text
+- [ ] [TaskID] [P?] [Story?] 説明（ファイルパス付き）
+```
+
+**構成要素**:
+
+1. **チェックボックス**: 常に `- [ ]` で始める
+2. **タスク ID**: 実行順の連番（T001, T002, T003 ...）
+3. **[P] マーカー**: 並列実行可能なタスクのみ付ける（別ファイル・未完了タスクに依存しない）
+4. **[Story] ラベル**: ユーザーストーリーフェーズのタスクのみ必須。形式: [US1], [US2], [US3] 等（spec.md のユーザーストーリーに対応）。セットアップ・基盤・仕上げフェーズにはストーリーラベルを付けない
+5. **説明**: 明確なアクションと正確なファイルパス
+
+**例**:
+
+- ✅ 正: `- [ ] T001 実装計画に従いプロジェクト構造を作成する`
+- ✅ 正: `- [ ] T005 [P] src/middleware/auth.py に認証ミドルウェアを実装する`
+- ✅ 正: `- [ ] T012 [P] [US1] src/models/user.py に User モデルを作成する`
+- ✅ 正: `- [ ] T014 [US1] src/services/user_service.py に UserService を実装する`
+- ❌ 誤: `- [ ] User モデルを作成する`（ID とストーリーラベルがない）
+- ❌ 誤: `T001 [US1] モデルを作成する`（チェックボックスがない）
+- ❌ 誤: `- [ ] [US1] User モデルを作成する`（タスク ID がない）
+- ❌ 誤: `- [ ] T001 [US1] モデルを作成する`（ファイルパスがない）
+
+### タスクの整理
+
+1. **ユーザーストーリー（spec.md）を主軸とする**:
+   - 各ユーザーストーリー（P1, P2, P3 ...）に 1 フェーズ
+   - ストーリーに関連するコンポーネントをすべてマッピング: モデル・サービス・インターフェース/UI・（依頼があれば）テスト
+   - ストーリー間の依存を記載する（多くのストーリーは独立）
+
+2. **契約から**:
+   - 各インターフェース契約を、それを提供するユーザーストーリーに対応づける
+   - テストを依頼されている場合: 各契約に対して、そのストーリーフェーズの実装前に契約テストタスク [P] を置く
+
+3. **データモデルから**:
+   - 各エンティティを、それを必要とするユーザーストーリーに対応づける
+   - 複数ストーリーで使うエンティティは、最初のストーリーまたはセットアップフェーズに含める
+   - リレーションは適切なストーリーフェーズのサービス層タスクで扱う
+
+4. **セットアップ/インフラから**:
+   - 共通インフラ → Phase 1（セットアップ）
+   - 基盤/ブロッキングタスク → Phase 2（基盤）
+   - ストーリー固有のセットアップ → そのストーリーのフェーズ内
+
+### フェーズ構成
+
+- **Phase 1**: セットアップ（プロジェクト初期化）
+- **Phase 2**: 基盤（全ユーザーストーリーの前提。ユーザーストーリーより前に完了必須）
+- **Phase 3 以降**: 優先度順のユーザーストーリー（P1, P2, P3 ...）
+  - 各ストーリー内: （依頼があれば）テスト → モデル → サービス → エンドポイント → 統合
+  - 各フェーズは独立してテスト可能な増分として完了させる
+- **最終フェーズ**: 仕上げと横断的関心事
+
+---
+完了したら次のステップに進む。