spec-runner 1.0.24 → 1.1.2

package/templates/.spec-runner/scripts/uc-next-start.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# 次の UC 仕様のひな形を作成する（Git ブランチの作成・切替は行わない）。
+# 使用例:
+#   ./uc-next-start.sh "task-management" "タスク管理機能追加" "タスク管理"
+#   ./uc-next-start.sh UC-2 "order-cancel" "注文キャンセル" "注文"
+#   ./uc-next-start.sh --yes "task-management" "タスク管理機能追加" "タスク管理"
+# 引数仕様（位置引数）:
+#   [UC-ID] [SLUG] [TITLE] [CATEGORY]
+#   - UC-ID: 省略可（例: UC-2）
+#   - SLUG: 必須。識別用の短名（ASCII, kebab-case 推奨。ファイル名には使わず参考・一貫性のため）
+#   - TITLE: 必須。UC ファイル題名（日本語推奨）
+#   - CATEGORY: 必須。docs/02_ユースケース仕様/ 配下のカテゴリ名（日本語可）
+# 重要: 空欄の引数は禁止。SLUG/TITLE/CATEGORY は必ず指定する
+
+set -e
+REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo ".")}"
+cd "$REPO_ROOT"
+
+git rev-parse --is-inside-work-tree >/dev/null 2>&1 || {
+  echo "Error: Git リポジトリ内で実行してください。" >&2
+  exit 1
+}
+
+YES_MODE=false
+ARGS=()
+for a in "$@"; do
+  case "$a" in
+    --yes|-y) YES_MODE=true ;;
+    *)
+      if [[ -z "$a" ]]; then
+        echo "Error: 空文字の引数は使用できません。UC-ID を省略する場合は引数自体を渡さないでください。" >&2
+        exit 1
+      fi
+      ARGS+=("$a")
+      ;;
+  esac
+done
+
+PROJECT_JSON="$REPO_ROOT/.spec-runner/project.json"
+[[ -f "$PROJECT_JSON" ]] || { echo "uc-next-start: project.json がありません: $PROJECT_JSON" >&2; exit 1; }
+command -v jq >/dev/null 2>&1 || { echo "uc-next-start: jq が必要です（brew install jq）" >&2; exit 1; }
+UC_ID_RE="$(jq -r '.naming.uc_id_pattern' "$PROJECT_JSON")"
+[[ -n "$UC_ID_RE" && "$UC_ID_RE" != "null" ]] || {
+  echo "uc-next-start: project.json の naming.uc_id_pattern が未設定です" >&2
+  exit 1
+}
+
+next_uc_id() {
+  local dir="$REPO_ROOT/docs/02_ユースケース仕様"
+  mkdir -p "$dir"
+  local max=0
+  for f in "$dir"/*/UC-*.md; do
+    [[ -e "$f" ]] || continue
+    base=$(basename "$f" .md)
+    if [[ "$base" =~ ^(${UC_ID_RE})- ]]; then
+      uc_id="${BASH_REMATCH[1]}"
+      digits=$(echo "$uc_id" | tr -cd '0-9')
+      [[ -z "$digits" ]] && continue
+      n=$((10#$digits))
+      [[ $n -gt $max ]] && max=$n
+    fi
+  done
+  printf "UC-%d\n" $((max + 1))
+}
+
+NEXT_UC="$(next_uc_id)"
+SLUG=""
+TITLE=""
+CATEGORY=""
+if [[ ${#ARGS[@]} -ge 1 ]] && [[ "${ARGS[0]}" =~ ^${UC_ID_RE}$ ]]; then
+  [[ ${#ARGS[@]} -eq 4 ]] || {
+    echo "Usage: .spec-runner/scripts/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+    echo "  - UC-ID を指定した場合は SLUG/TITLE/CATEGORY の3引数が必須です" >&2
+    exit 1
+  }
+  NEXT_UC="${ARGS[0]}"
+  SLUG="${ARGS[1]}"
+  TITLE="${ARGS[2]}"
+  CATEGORY="${ARGS[3]}"
+else
+  [[ ${#ARGS[@]} -eq 3 ]] || {
+    echo "Usage: .spec-runner/scripts/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+    echo "  - UC-ID は任意、SLUG/TITLE/CATEGORY は必須です（空文字禁止）" >&2
+    exit 1
+  }
+  SLUG="${ARGS[0]}"
+  TITLE="${ARGS[1]}"
+  CATEGORY="${ARGS[2]}"
+fi
+
+if [[ -z "$SLUG" || -z "$TITLE" || -z "$CATEGORY" ]]; then
+  echo "Usage: .spec-runner/scripts/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+  echo "  - UC-ID は任意、SLUG/TITLE/CATEGORY は必須です（空文字禁止）" >&2
+  exit 1
+fi
+
+SLUG=$(echo "$SLUG" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-*//' | sed 's/-*$//')
+if [[ -z "$SLUG" ]]; then
+  echo "Error: SLUG は英数字・ハイフンへ正規化可能な値を指定してください（例: task-management）。" >&2
+  exit 1
+fi
+
+DOC_TITLE="$TITLE"
+DOC_TITLE=$(echo "$DOC_TITLE" | sed 's/[\\\\\\/\\:\\*\\?\\\"\\<\\>\\|]/ /g' | sed 's/[[:space:]]\\+/ /g' | sed 's/^ *//; s/ *$//')
+if [[ -z "$DOC_TITLE" ]]; then
+  echo "Error: TITLE が不正です（危険文字除去後に空になりました）。" >&2
+  exit 1
+fi
+
+CATEGORY=$(echo "$CATEGORY" | sed 's/[\\\/:\*\?"<>|]//g' | sed 's/[[:cntrl:]]//g' | sed 's/[[:space:]]\+/ /g' | sed 's/^ *//; s/ *$//')
+if [[ -z "$CATEGORY" ]]; then
+  echo "Error: CATEGORY は空にできません。" >&2
+  exit 1
+fi
+
+FEATURE_DIR="docs/02_ユースケース仕様/${CATEGORY}"
+UC_DOC="${FEATURE_DIR}/${NEXT_UC}-${DOC_TITLE}.md"
+
+if [[ -f "$UC_DOC" ]]; then
+  echo "Error: 既に存在します: $UC_DOC" >&2
+  exit 1
+fi
+
+UC_ID_PATTERN="^${UC_ID_RE}$"
+if ! echo "$NEXT_UC" | grep -qE "$UC_ID_PATTERN"; then
+  echo "Error: UC-ID が命名規則に合いません: $NEXT_UC（期待: $UC_ID_PATTERN）" >&2
+  exit 1
+fi
+
+if [[ "$YES_MODE" != true ]]; then
+  echo "次の UC 仕様のひな形を作成します（ブランチは作成しません）。"
+  echo "  → $UC_DOC"
+  echo -n "  実行してよろしいですか？ [y/N]: "
+  read -r ans
+  case "$ans" in
+    [yY]|[yY][eE][sS]) ;;
+    *) echo "キャンセルしました。"; exit 0 ;;
+  esac
+fi
+
+mkdir -p "$FEATURE_DIR"
+mkdir -p "${FEATURE_DIR}/判断記録"
+TEMPLATE="$REPO_ROOT/.spec-runner/templates/UC-N-ユースケース名.md"
+if [[ -f "$TEMPLATE" ]]; then
+  sed "s/UC-N/${NEXT_UC}/g; s/{ユースケース名}/${DOC_TITLE}/g" "$TEMPLATE" > "$UC_DOC"
+  echo "Created: $UC_DOC"
+else
+  touch "$UC_DOC"
+  echo "# ${NEXT_UC}: ${DOC_TITLE}" >> "$UC_DOC"
+  echo "Created: $UC_DOC"
+fi
+
+echo ""
+echo "UC 仕様の準備ができました（現在のブランチは変更していません）。次のステップに進んでください。"

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # spec-runner エントリポイント。次のステップ（現在フェーズ・やるべきステップ .md）を返す。
-# 使用: .spec-runner/spec-runner.sh [次のステップ] [--json|--lock|--グレード]
+# 使用: .spec-runner/spec-runner.sh [次のステップ] [--json|--lock]
 
 set -e
 REPO_ROOT="${REPO_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
@@ -18,12 +18,11 @@ case "$cmd" in
     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: 引数なし、または「次のステップ」[--json|--lock] のみ対応しています。" >&2
     echo "  使用例: .spec-runner/spec-runner.sh 次のステップ --json" >&2
     exit 1
     ;;

package/templates/.spec-runner/steps/steps.json

@@ -1,9 +1,10 @@
 {
-  "version": 1,
-  "note": "steps/*.md の『宣言（機械可読）』。md は実行テンプレ、こちらはルールと入出力の参照用。",
+  "version": 2,
+  "note": "薄いオーケストレータ向け steps 定義。主線6本（実行フェーズ5本 + 憲章）+ 横断2本（clarify/analyze）。",
   "common": {
     "docs": {
       "root": "docs",
+      "work_card": "docs/work.md",
       "charter": "docs/01_憲章/憲章.md",
       "uc_root": "docs/02_ユースケース仕様",
       "domain_root": "docs/03_ドメイン設計",
@@ -14,25 +15,7 @@
     },
     "commands": {
       "check": ".spec-runner/scripts/check.sh",
-      "start_next_uc": ".spec-runner/scripts/branch/uc-next-start.sh"
-    },
-    "naming": {
-      "uc_id_regex": "^UC-[0-9]+$",
-      "uc_branch_regex": "^(?<prefix>[^/]+)/(?<uc>UC-[0-9]+)-(?<slug>[a-z0-9-]+)$",
-      "uc_spec_regex": "^UC-[0-9]+-.+\\.md$",
-      "decision_log_dir_name": "判断記録",
-      "decision_log_filename_pattern": "UC-N-MMDD-題名.md",
-      "decision_log_example": "UC-1-0317-要件解釈.md"
-    },
-    "clarification_policy": {
-      "marker_format": "[要確認: ...]",
-      "rule": "不明点は推測で確定せず、仕様/設計書内に [要確認: ...] として残す。",
-      "interactive_questions_max": 3,
-      "excess_handling": "質問として提示するのは最大3件。残りは『追加の要確認』として文書内に残す。"
-    },
-    "uc_to_domain_to_arch_flow": {
-      "order": ["charter", "uc_spec", "domain", "architecture"],
-      "note": "憲章の次は UC→ドメイン→アーキ。UC を入力にドメインを固め、ドメインを入力にアーキを固める。"
+      "start_next_uc": ".spec-runner/scripts/uc-next-start.sh"
     }
   },
   "steps": [
@@ -41,11 +24,8 @@
       "name_ja": "憲章",
       "phase": 0,
       "md_file": "憲章.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/01_憲章/憲章.md"],
-      "notes": ["存在しない場合は .spec-runner/templates/憲章.md から生成する"]
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["docs/01_憲章/憲章.md", "docs/work.md"]
     },
     {
       "id": "uc_spec",
@@ -53,119 +33,64 @@
       "phase": 1,
       "md_file": "仕様策定.md",
       "commands": [
-        { "id": "start_uc_branch", "command": ".spec-runner/scripts/branch/uc-next-start.sh" },
+        { "id": "start_uc_spec_scaffold", "command": ".spec-runner/scripts/uc-next-start.sh" },
         { "id": "check", "command": ".spec-runner/scripts/check.sh" }
       ],
-      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/UC-<N>-<題名>.md"],
-      "secondary_outputs_optional": ["docs/02_ユースケース仕様/<カテゴリ>/判断記録/UC-N-MMDD-題名.md"]
+      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/UC-<N>-<題名>.md", "docs/work.md"]
     },
     {
       "id": "domain",
       "name_ja": "ドメイン設計",
       "phase": 2,
       "md_file": "ドメイン設計.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
       "primary_outputs": [
         "docs/03_ドメイン設計/ユビキタス言語辞書.md",
         "docs/03_ドメイン設計/ドメインモデル.md",
-        "docs/03_ドメイン設計/集約.md"
-      ],
-      "notes": ["存在しない場合は .spec-runner/templates/ から生成する"]
+        "docs/03_ドメイン設計/集約.md",
+        "docs/work.md"
+      ]
     },
     {
       "id": "architecture_plan",
       "name_ja": "実装計画",
       "phase": 3,
       "md_file": "実装計画.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/04_アーキテクチャ/*"],
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["docs/04_アーキテクチャ/*", "docs/work.md"],
       "secondary_outputs_optional": ["docs/06_API仕様/openapi.yaml"]
     },
-    {
-      "id": "infra_plan",
-      "name_ja": "インフラ詳細設計（Grade A）",
-      "phase": 4,
-      "md_file": "実装計画.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/05_インフラ設計/schema.dbml"]
-    },
     {
       "id": "test_design",
       "name_ja": "テスト設計",
       "phase": 5,
       "md_file": "テスト設計.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["<test_design.dir>/**/UC-N-*.spec.*"]
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["<test_design.dir>/**/*.spec.*", "docs/work.md"]
     },
     {
       "id": "implement",
       "name_ja": "実装",
       "phase": 6,
       "md_file": "実装.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["src/**", "<tests green>"],
-      "notes": ["完了条件: require-tests-green.sh が exit 0"]
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["src/**", "<tests green>", "docs/work.md"]
     },
     {
       "id": "clarify",
       "name_ja": "曖昧さ解消",
       "phase": null,
       "md_file": "曖昧さ解消.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/UC-<N>-<題名>.md (更新)"]
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["(target spec update)", "docs/work.md"]
     },
     {
       "id": "analyze",
       "name_ja": "分析",
       "phase": null,
       "md_file": "分析.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/UC-<N>-<題名>.md (更新)"]
-    },
-    {
-      "id": "checklist",
-      "name_ja": "チェックリスト",
-      "phase": 1,
-      "md_file": "チェックリスト.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/checklists/*.md (任意)"]
-    },
-    {
-      "id": "task_list",
-      "name_ja": "タスク一覧",
-      "phase": 1,
-      "md_file": "タスク一覧.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["docs/02_ユースケース仕様/<カテゴリ>/UC-<N>-<題名>.md (## タスク / ## タスク一覧 更新)"]
-    },
-    {
-      "id": "other_work",
-      "name_ja": "その他作業",
-      "phase": 1,
-      "md_file": "その他作業.md",
-      "commands": [
-        { "id": "check", "command": ".spec-runner/scripts/check.sh" }
-      ],
-      "primary_outputs": ["(branch scoped)"]
+      "commands": [{ "id": "check", "command": ".spec-runner/scripts/check.sh" }],
+      "primary_outputs": ["(analysis report)", "docs/work.md"]
     }
   ]
 }
-

package/templates/.spec-runner/steps//343/203/206/343/202/271/343/203/210/350/250/255/350/250/210.md

@@ -6,15 +6,15 @@ primary_output: project.json の test_design.dir（既定 tests）
 
 # テスト設計（Phase 5: TEST DESIGN）
 
-**やること**: UC 仕様と受入条件に基づき、**PENDING 状態のテストコード**を `test_design.dir`（既定 `tests`）に作成する。続けて analyze / checklist → 人間承認 → review-pass のち Phase 6 へ。
+**やること**: UC 仕様と受入条件に基づき、**PENDING 状態のテストコード**を `test_design.dir`（既定 `tests`）に作成する。あわせて `docs/work.md` の実装タスク・検証結果を更新する。
 
-**機械的な前提**（`project.json` の `test_design.require_uc_prefixed_tests` が true のとき）: ファイル名は **`UC-N-<slug>.spec.<ext>`**（ブランチの UC 番号と一致）にすること。**これが無いと「次のステップ」は実装フェーズに進みません**（TDD で先にテストを置く流れを強制）。
+**機械的な前提**（`project.json` の `test_design.require_uc_prefixed_tests` が true のとき）: ファイル名は **`UC-N-<slug>.spec.<ext>`**（対象 UC の番号と一致）にすること。true の場合だけ、**命名が無いと「次のステップ」は実装フェーズに進みません**。
 
 | 項目 | 内容 |
 |------|------|
 | **出力先** | `.spec-runner/project.json` の `test_design.dir`（既定: `tests`）、パターンは `test_design.pattern`（既定: `*.spec.*`）。Python は `test_*.py` 等に変更可 |
 | **ドキュメント** | **読み取り専用**（test_design.dir への**追加のみ**）。UC 仕様の修正は「曖昧さ解消」等で別途 |
-| **命名** | spec.md **8-2** に厳守: `UC-N-{ユースケース名}.spec.{拡張子}` |
+| **命名** | （推奨） `UC-N-{ユースケース名}.spec.{拡張子}` 。`test_design.require_uc_prefixed_tests=true` のときだけ必須。 |
 | **ピラミッド** | spec セクション 14: Unit : Integration : E2E ≈ 70 : 20 : 10。E2E は UC 1 本あたり最大 2 本目安 |
 
 ## ユーザー入力
@@ -28,19 +28,20 @@ $ARGUMENTS
 ## 実行フロー
 
 1. **セットアップ**  
-   リポジトリルートで `.spec-runner/spec-runner.sh 次のステップ --json`。ブランチ `feature/UC-N-xxx`。JSON の `feature_spec`・`feature_dir` を使用。
+   リポジトリルートで `.spec-runner/spec-runner.sh 次のステップ --json`。JSON の `feature_spec`・`feature_dir` を使用。
 
 2. **UC 仕様の読み込み**
    - FEATURE_SPEC から受入条件・成功基準・ユーザーストーリーを抽出
    - `docs/04_アーキテクチャ/命名規則.md` の SOURCE_EXTENSIONS でテスト拡張子（例: ts → `.spec.ts`）
-   - ブランチ名から UC 番号と kebab 名（例: `feature/UC-1-order-placement` → UC-1, order-placement）
+   - `feature_spec` のファイル名から UC 番号と識別名を決める（例: `UC-1-注文作成.md` → UC-1, order-placement）
 
-3. **配置と命名**（spec.md 8-2）
+3. **配置と命名**
    - ベース: **`project.json` の `test_design.dir`**、パターンは `test_design.pattern`
-   - ユニット/UC: `{dir}/unit/UC-N-{名}.spec.{ext}`（例: `tests/unit/UC-1-order-placement.spec.ts`）
-   - E2E: `{dir}/e2e/UC-N-{名}.e2e.spec.{ext}`
+- `test_design.require_uc_prefixed_tests=true` の場合:
+  - ユニット/UC: `{dir}/unit/UC-N-{名}.spec.{ext}`（例: `tests/unit/UC-1-order-placement.spec.ts`）
+  - E2E: `{dir}/e2e/UC-N-{名}.e2e.spec.{ext}`
    - 集約不変条件: `{dir}/unit/{集約名}.invariants.spec.{ext}`
-   - 既存の unit / integration / e2e 構造に合わせる
+- `false` の場合: `test_design.pattern` に合致するテストファイル名であれば任意（ディレクトリ構造は既存に合わせる）
 
 4. **PENDING で記述**
    - 受入条件・成功基準ごとに **スキップ/TODO**（`it.todo` / `test.skip` / `@pending` 等）

package/templates/.spec-runner/steps//343/203/211/343/203/241/343/202/244/343/203/263/350/250/255/350/250/210.md

@@ -6,7 +6,7 @@ primary_output: docs/03_ドメイン設計/
 
 # ドメイン設計（Domain）
 
-**やること**: `docs/03_ドメイン設計/` にユビキタス言語・ドメインモデル・集約等を整備する。完了後、レビュー通過で `phase-locks.json` の `domain` に `completed: true`。
+**やること**: `docs/03_ドメイン設計/` にユビキタス言語・ドメインモデル・集約等を整備する。完了後、レビュー通過で `phase-locks.json` の `domain` に `completed: true`。あわせて `docs/work.md` の実装タスクを更新する。
 
 | 項目 | 内容 |
 |------|------|
@@ -38,7 +38,7 @@ $ARGUMENTS
    - 必要に応じて `エンティティ.md`・`値オブジェクト.md`
 
 2. **編集・追記**  
-   ユーザー指示や UC で発見した新概念に基づき上記を更新。骨格（主要集約と境界）を確定。Grade A の UC ループで肉付け。  
+   ユーザー指示や UC で発見した新概念に基づき上記を更新。骨格（主要集約と境界）を確定し、必要に応じて後続で肉付けする。
    不明は推測で確定せず **`[要確認: ...]`** を残す（例: `[要確認: 集約境界の決め手（更新頻度/整合性要件）]`）。
 
 3. **レビュー通過後**  

package/templates/.spec-runner/steps//344/273/225/346/247/230/347/255/226/345/256/232.md

@@ -6,15 +6,17 @@ primary_output: docs/02_ユースケース仕様/<カテゴリ>/UC-N-xxx.md
 
 # ユースケース仕様（UC 仕様書）
 
-**やること**: 機能説明（`$ARGUMENTS`）から UC ブランチと UC 仕様書を作成し、テンプレに沿って埋める。その後 quality フロー（clarify → analyze）を回し、必要に応じて checklist を実施して review-pass へ進む。
+**やること**: 機能説明（`$ARGUMENTS`）から UC 仕様書を作成（または更新）し、テンプレに沿って埋める。その後 quality フロー（clarify → analyze）を回し、必要に応じて checklist を実施して review-pass へ進む。あわせて `docs/work.md` の受入条件・実装タスクを同期する。
 
 | 項目 | 内容 |
 |------|------|
 | **成果物** | `docs/02_ユースケース仕様/<カテゴリ>/UC-N-xxx.md`（1 UC = 1 本） |
-| **main** | **必ず UC 用ブランチを作成してから**仕様を書く。main で直接編集しない |
+| **Git** | **フェーズごとにブランチを切る必要はない。** 今いるブランチで仕様を書いてよい。**コミットしたくなったタイミング**で、AI に `project.json` の naming に沿った**ブランチ名・コミットメッセージを相談し、checkout / 作成・コミットまで一緒にやってもらう**運用でよい |
 | **品質フロー** | `phase-locks.json` の `quality` を使って **clarify → analyze** を自動進行。必要なら checklist を追加で実施 |
 | **判断ログ（任意）** | `docs/02_.../<カテゴリ>/判断記録/UC-N-MMDD-題名.md`。テンプレ: `.spec-runner/templates/UC-N-MMDD-判断記録テンプレ.md` |
 
+**補足（spec-runner コア）**: テスト設計・実装フェーズは、ブランチではなく **UC 仕様と lock 状態**で判定されます。`uc_discovery.completed=false` の間は UC 作成フェーズを継続し、未レビュー UC がある場合は `clarify/analyze` を優先します。`spec-runner` はブランチを作りません。
+
 ## ユーザー入力
 
 `$ARGUMENTS` が機能説明。空でコマンドしていない限り、繰り返し入力を求めない。
@@ -40,7 +42,7 @@ $ARGUMENTS
   - 候補 UC 一覧（`UC-候補: 目的 / 範囲 / 非対象`）
   - 優先順（MVP から）
   - まず作る 1 件（最小価値）
-- 合意後は **1 件ずつ** `uc-next-start.sh` で作成する（CRUD は原則別 UC）。
+- 合意後は **1 件ずつ** UC を追加する。土台づくりに **`uc-next-start.sh`**（仕様ひな形のみ）を使っても、手動で `UC-N-xxx.md` を置いてもよい（CRUD は原則別 UC）。
 
 ### 0.5. 引数なし時の候補提示（必須）
 
@@ -53,24 +55,24 @@ $ARGUMENTS
 - ユーザー回答後:
   - 選択された案（または自由入力文）を今回の機能説明として扱い、以降のステップを通常どおり実行する。
 
-### 1. ブランチ用短名（2〜4 語）
+### 1. 短名 SLUG（2〜4 語）
 
-- 機能説明からキーワード抽出。**ブランチ名は ASCII のみ**、kebab-case（例: order-placement, user-auth）。
+- 機能説明からキーワード抽出。`uc-next-start.sh` の**第1引数（UC-ID 省略時）または第2引数**として必須。**ASCII のみ**、kebab-case（例: order-placement, user-auth）。スクリプトはファイル名には使わず、**人間・AI がブランチ名を考えるときのタグ**として使う。
 - **UC ファイル名は TITLE を使用**（`UC-<N>-<TITLE>.md`）。
-- 技術略語（OAuth2, API, JWT）はそのまま。`SLUG` は ASCII（kebab-case）、`TITLE` は日本語で記述する。
+- 技術略語（OAuth2, API, JWT）はそのまま。`TITLE` は日本語で記述する。
 - 例: 「ユーザー認証」→ user-auth / 「OAuth2 API」→ oauth2-api-integration 等。
 
-### 2. ブランチと仕様の作成
+### 2. UC 仕様の作成
 
-- `docs/01_憲章/憲章.md` は先に確定する。未コミット差分がある場合は、**AI が差分を確認してコミットメッセージを作成し、コミット完了後**に `uc-next-start.sh` を実行する。
-- `.spec-runner/scripts/branch/uc-next-start.sh [UC-ID] "$SLUG" "$TITLE" "$CATEGORY" [--yes]`
+- `docs/01_憲章/憲章.md` は先に確定する。未コミット差分がある場合は、**コミットしたくなったら AI に差分確認・メッセージ案・コミットを依頼**する（憲章と UC を同じコミットにまとめる必要はない）。
+- **ショートカット**: `.spec-runner/scripts/uc-next-start.sh [UC-ID] "$SLUG" "$TITLE" "$CATEGORY" [--yes]` — **UC 仕様のひな形ファイルだけ**を所定フォルダに作成する（**Git のブランチ作成・checkout は行わない**）。**使わず**手動で `UC-N-xxx.md` を置いてもよい。
 - UC-ID は省略可（省略時は自動採番）。**SLUG / TITLE / CATEGORY は必須**（空文字禁止）。
 - CATEGORY で配置先が決まる（カテゴリ名は日本語可）。**機能ごとに 1 回だけ**。
 - シングルクォートはエスケープ（例: `'I'\''m Groot'`）またはダブルクォート。
 - 引数の実例:
-  - `./.spec-runner/scripts/branch/uc-next-start.sh "task-management" "タスク管理機能追加" "タスク管理" --yes`
-  - `./.spec-runner/scripts/branch/uc-next-start.sh UC-2 "order-cancel" "注文キャンセル" "注文" --yes`
-  - `./.spec-runner/scripts/branch/uc-next-start.sh UC-3 "task-import" "タスク一括登録" "タスク管理" --yes`
+  - `./.spec-runner/scripts/uc-next-start.sh "task-management" "タスク管理機能追加" "タスク管理" --yes`
+  - `./.spec-runner/scripts/uc-next-start.sh UC-2 "order-cancel" "注文キャンセル" "注文" --yes`
+  - `./.spec-runner/scripts/uc-next-start.sh UC-3 "task-import" "タスク一括登録" "タスク管理" --yes`
 
 ### 3. テンプレ読込
 
@@ -108,13 +110,13 @@ checklists を使う場合のみ `FEATURE_DIR/checklists/requirements.md` を生
 
 ### 7. 完了報告
 
-ブランチ名・仕様パス・チェックリスト結果・次フェーズ（曖昧さ解消 / 実装計画）の準備状況。
+仕様パス・チェックリスト結果・次フェーズ（曖昧さ解消 / 実装計画）の準備状況。
 
 ※ 分解提案を経た場合は、採用された UC 分割案（採用順）も合わせて報告する。
 
 ※ **UC 洗い出しが完了したら** `./.spec-runner/phase-locks.json` の `uc_discovery.completed` を `true` にする（以降 `domain` に進む）。
 
-**注**: スクリプトは書き込み前にブランチ作成・チェックアウトと仕様の初期化を行う。
+**注**: `uc-next-start.sh` は仕様ファイルの生成のみ。現在のブランチは変わらない。
 
 ## 付録 A: 仕様品質チェックリスト例
 

package/templates/.spec-runner/steps//345/210/206/346/236/220.md

@@ -7,7 +7,7 @@ note: 任意フェーズで実行可能（読み取り専用）
 
 # 分析（品質フロー）
 
-**やること**: 任意フェーズで、**読み取り専用**で UC 仕様・憲章の一貫性・矛盾・カバレッジを分析し、構造化レポートを出力する（ファイルは変更しない）。
+**やること**: 任意フェーズで、**読み取り専用**で UC 仕様・憲章の一貫性・矛盾・カバレッジを分析し、構造化レポートを出力する（ファイルは変更しない）。必要に応じて `docs/work.md` の未解決更新を提案する。
 
 | 項目 | 内容 |
 |------|------|
@@ -26,7 +26,7 @@ $ARGUMENTS
 
 ### 1. コンテキスト初期化
 
-`.spec-runner/spec-runner.sh 次のステップ --json` を 1 回。`feature/UC-N-xxx`。  
+`.spec-runner/spec-runner.sh 次のステップ --json` を 1 回。`feature_spec`・`feature_dir` を使用。  
 **SPEC** = FEATURE_SPEC（**必須**）。実装方針・タスクは UC の「## 実装方針」「## タスク」。  
 無ければエラー中止。引数のシングルクォートはエスケープ。
 

package/templates/.spec-runner/steps//345/256/237/350/243/205.md

@@ -5,12 +5,12 @@ phase: 6
 
 # 実装（Phase 6: IMPLEMENTATION）
 
-**やること**: Phase 5 の **PENDING テストをグリーン**にする。**完了**はコードだけでなく **起動確認**（dev で `/` と主要画面）と **可能なら E2E 1 本グリーン**。Phase 5 レビュー後は AGENTS.md / CLAUDE.md の更新を検討。
+**やること**: Phase 5 の **PENDING テストをグリーン**にする。**完了**はコードだけでなく **起動確認**（dev で `/` と主要画面）と **可能なら E2E 1 本グリーン**。あわせて `docs/work.md` のチェックボックスと検証結果を確定する。
 
 | 項目 | 内容 |
 |------|------|
 | **UC 配置** | カテゴリ内 **UC-N-xxx.md 1 本**。**## 実装方針**・**## タスク**（または **## タスク一覧**）は **一番下** |
-| **検証** | 完了は check.sh。テストは **`require-tests-green.sh`**（`project.json` の `test_command.run`）が **exit 0** まで「完了」報告しない |
+| **検証** | 完了は check.sh。テストは **`project.json` の `test_command.run`** が **exit 0** まで「完了」報告しない |
 
 ## フォルダ構造
 
@@ -37,7 +37,7 @@ $ARGUMENTS
 ## 実行フロー
 
 1. **JSON**  
-   `次のステップ --json`。`feature_dir`・`feature_spec`。`feature/UC-N-xxx`。
+   `次のステップ --json`。`feature_dir`・`feature_spec`。
 
 2. **チェックリスト（FEATURE_DIR/checklists/ がある場合）**  
    `- [ ]` / `- [x]` を数え表化。未完了 0 → PASS。未完了あり → 「このまま進めますか？ yes/no」で待つ。no で停止。yes で続行。
@@ -64,16 +64,17 @@ $ARGUMENTS
 
 9. **完了検証**
    - 必須タスク完了・仕様一致
-   - **`require-tests-green.sh`** が 0 になるまで完了報告禁止
+   - **`test_command.run` の実行結果** が 0 になるまで完了報告禁止
    - **起動確認（必須）**: dev で `/` と当該 UC の主要画面が 200 等。不可なら修正まで
    - **E2E（推奨）**: `tests/e2e/` に該当 UC があればハッピーパス 1 本グリーンを目標。無ければユニット+起動で可
 
 10. **hooks.after_implement**  
     あれば同様に表示/実行。
 
-## 次の UC
+## 次の UC・履歴整理
 
-`.spec-runner/scripts/branch/uc-next-start.sh` — 実行前に確認。`--yes` で確認省略。main に切り替えて次ブランチ作成。
+次 UC やマージのタイミングはプロジェクト次第。**コミット・ブランチが欲しくなったら** AI に相談する。  
+**任意**: `.spec-runner/scripts/uc-next-start.sh`（`--yes` で確認省略）— **次 UC 用の仕様ひな形 `.md` のみ**作成（ブランチは作らない）。
 
 ---
-**次**: 完了後、次のステップへ。次 UC は上記スクリプト。
+**次**: 完了後、次のステップへ。

package/templates/.spec-runner/steps//345/256/237/350/243/205/350/250/210/347/224/273.md

@@ -1,18 +1,18 @@
 ---
 step_id: implementation_plan
-phase: "2,4"
-note: アーキテクチャ + Grade A インフラ
+phase: 3
+note: アーキテクチャ設計
 ---
 
-# 実装計画（Phase 2 アーキテクチャ / Phase 4 インフラ Grade A）
+# 実装計画（アーキテクチャ）
 
-**やること**: Phase 2 では `docs/04_アーキテクチャ/` に設計を置く。Phase 4（Grade A）または UC ブランチでは **実装方針を UC の .md の一番下（## 実装方針）** に書き、計画ワークフローを回す。
+**やること**: `docs/04_アーキテクチャ/` に設計を置き、最新の UC 仕様に **実装方針を UC の .md の一番下（## 実装方針）** として反映する。あわせて `docs/work.md` の実装タスクを更新する。
 
 | 項目 | 内容 |
 |------|------|
 | **docs/02** | カテゴリフォルダ内に **UC-N-xxx.md を 1 本ずつ**。実装方針・タスクは **各 UC .md の一番下** |
 | **動的設定** | 必須ドキュメント・命名規則は **`.spec-runner/project.json` を AI が直接編集** |
-| **Phase 4 Grade A** | `docs/05_インフラ設計`（schema.dbml 等）も対象。`migrations/` は Atlas 利用時のみ任意 |
+| **補足（任意）** | 必要に応じて `docs/05_インフラ設計`（schema.dbml 等）を作成 |
 
 ## ユーザー入力
 
@@ -27,7 +27,7 @@ $ARGUMENTS
 | フェーズ | パス | 内容の例 |
 |----------|------|----------|
 | Phase 2 | `docs/04_アーキテクチャ/` | パターン選定・インフラ方針・命名・設計判断（`MMDD-題名.md`。年はフォルダ分け可） |
-| Phase 4（Grade A） | `docs/05_インフラ設計/` | クラウド・ネットワーク・**schema.dbml**（DB の単一ソース） |
+| 任意 | `docs/05_インフラ設計/` | クラウド・ネットワーク・**schema.dbml**（必要時のみ） |
 | API 公開時 | `docs/06_API仕様/` | openapi.yaml（Gate 3 で参照） |
 
 ## API 仕様（openapi.yaml）
@@ -35,16 +35,16 @@ $ARGUMENTS
 - **単一ソース**: `docs/06_API仕様/openapi.yaml`。型・クライアントはここから生成すると設計と一致。`tags` で分類、`$ref` 分割可。
 - **生成手段**: プロジェクト標準（openapi-generator / openapi-typescript / orval 等）。spec-runner は固定しない。
 
-## Phase 2（main/develop、UC ブランチにいない場合）
+## Phase 2（main/develop など）
 
 `docs/01_憲章/憲章.md` と `docs/03_ドメイン設計/` を読み、**`docs/04_アーキテクチャ/`** にパターン選定・インフラ方針・命名・設計判断記録を作成。フォルダが無ければこのフェーズで作成。
 
-## Phase 4 または UC 上での計画（実装方針セクション）
+## UC 上での計画（実装方針セクション）
 
 以下 1–4 を実行。
 
 1. **セットアップ**  
-   `.spec-runner/spec-runner.sh 次のステップ --json`。`feature_spec`・`feature_dir`。UC ブランチ上であること。
+   `.spec-runner/spec-runner.sh 次のステップ --json`。`feature_spec`・`feature_dir`。
 
 2. **文脈**  
    FEATURE_SPEC（**必須**）、`docs/01_憲章/憲章.md`、UC の「## 実装方針」。UC 1 本で計画。
@@ -59,7 +59,7 @@ $ARGUMENTS
    - 設計後に憲章チェックを再評価
 
 4. **停止と報告**  
-   コマンドは Phase 2 計画の後で終了。ブランチ・FEATURE_SPEC・生成物を報告。
+   コマンドは Phase 2 計画の後で終了。FEATURE_SPEC・生成物を報告。
 
 ## サブフェーズ詳細