spec-runner 1.0.23 → 1.1.0

package/templates/.spec-runner/scripts/{branch/uc-next-start.sh → uc-next-start.sh}

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# 次の UC を開始する: main に切り替え、feature/UC-N-xxx ブランチを作成する。
+# 次の UC 仕様のひな形を作成する（Git ブランチの作成・切替は行わない）。
 # 使用例:
 #   ./uc-next-start.sh "task-management" "タスク管理機能追加" "タスク管理"
 #   ./uc-next-start.sh UC-2 "order-cancel" "注文キャンセル" "注文"
@@ -7,16 +7,19 @@
 # 引数仕様（位置引数）:
 #   [UC-ID] [SLUG] [TITLE] [CATEGORY]
 #   - UC-ID: 省略可（例: UC-2）
-#   - SLUG: 必須。ブランチ用の短名（ASCII, kebab-case 推奨）
+#   - 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"
-BRANCH_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+git rev-parse --is-inside-work-tree >/dev/null 2>&1 || {
+  echo "Error: Git リポジトリ内で実行してください。" >&2
+  exit 1
+}
 
 YES_MODE=false
 ARGS=()
@@ -24,7 +27,6 @@ for a in "$@"; do
   case "$a" in
     --yes|-y) YES_MODE=true ;;
     *)
-      # 空引数は禁止
       if [[ -z "$a" ]]; then
         echo "Error: 空文字の引数は使用できません。UC-ID を省略する場合は引数自体を渡さないでください。" >&2
         exit 1
@@ -38,14 +40,12 @@ 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")"
-BRANCH_PREFIX="$(jq -r '.naming.branch_prefix' "$PROJECT_JSON")"
-[[ -n "$UC_ID_RE" && "$UC_ID_RE" != "null" && -n "$BRANCH_PREFIX" && "$BRANCH_PREFIX" != "null" ]] || {
-  echo "uc-next-start: project.json の naming.uc_id_pattern / branch_prefix が未設定です" >&2
+[[ -n "$UC_ID_RE" && "$UC_ID_RE" != "null" ]] || {
+  echo "uc-next-start: project.json の naming.uc_id_pattern が未設定です" >&2
   exit 1
 }
 
 next_uc_id() {
-  # docs/02_ユースケース仕様/<カテゴリ>/UC-*.md から次に使う UC-N を返す
   local dir="$REPO_ROOT/docs/02_ユースケース仕様"
   mkdir -p "$dir"
   local max=0
@@ -69,7 +69,7 @@ TITLE=""
 CATEGORY=""
 if [[ ${#ARGS[@]} -ge 1 ]] && [[ "${ARGS[0]}" =~ ^${UC_ID_RE}$ ]]; then
   [[ ${#ARGS[@]} -eq 4 ]] || {
-    echo "Usage: .spec-runner/scripts/branch/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+    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
   }
@@ -79,7 +79,7 @@ if [[ ${#ARGS[@]} -ge 1 ]] && [[ "${ARGS[0]}" =~ ^${UC_ID_RE}$ ]]; then
   CATEGORY="${ARGS[3]}"
 else
   [[ ${#ARGS[@]} -eq 3 ]] || {
-    echo "Usage: .spec-runner/scripts/branch/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+    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
   }
@@ -88,68 +88,48 @@ else
   CATEGORY="${ARGS[2]}"
 fi
 
-# SLUG / TITLE / CATEGORY は必須（UC-ID のみ任意）
 if [[ -z "$SLUG" || -z "$TITLE" || -z "$CATEGORY" ]]; then
-  echo "Usage: .spec-runner/scripts/branch/uc-next-start.sh [UC-ID] \"SLUG\" \"TITLE\" \"CATEGORY\" [--yes]" >&2
+  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 は英小文字・ハイフン（Git ブランチ名は ASCII のみ）
-# macOS(BSD sed) でも動くように、連続ハイフンは 's/--*/-/g' で圧縮する
 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
-BRANCH_NAME="${BRANCH_PREFIX}/${NEXT_UC}-${SLUG}"
 
-# UC ファイル題名
 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
 
-# カテゴリは必須。日本語カテゴリは許可し、危険文字だけ除去。
-# 文字レンジ指定は sed 実装差で壊れやすいため、危険文字のみを除去する。
 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
 
-if git rev-parse --verify "$BRANCH_NAME" >/dev/null 2>&1; then
-  echo "Error: ブランチ '$BRANCH_NAME' は既に存在します。" >&2
+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
 
-CURRENT=$(git branch --show-current 2>/dev/null || echo "")
-MAIN_BRANCH=""
-
-# 1) origin/HEAD からデフォルトブランチを取得
-if git symbolic-ref -q --short refs/remotes/origin/HEAD >/dev/null 2>&1; then
-  MAIN_BRANCH="$(git symbolic-ref -q --short refs/remotes/origin/HEAD | sed 's#^origin/##')"
-fi
-# 2) main / master をフォールバック
-if [[ -z "$MAIN_BRANCH" ]]; then
-  if git rev-parse --verify "main" >/dev/null 2>&1; then
-    MAIN_BRANCH="main"
-  elif git rev-parse --verify "master" >/dev/null 2>&1; then
-    MAIN_BRANCH="master"
-  fi
-fi
-# 3) どれも無ければ現在ブランチ（初期ブランチ名が trunk/develop 等のケース）
-if [[ -z "$MAIN_BRANCH" ]]; then
-  MAIN_BRANCH="${CURRENT:-}"
+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
-[[ -n "$MAIN_BRANCH" ]] || { echo "Error: ベースブランチを特定できません（main/master/current が見つかりません）。" >&2; exit 1; }
 
 if [[ "$YES_MODE" != true ]]; then
-  echo "次の UC を開始する準備をします。"
-  echo "  $MAIN_BRANCH にチェックアウトし、ブランチ \"$BRANCH_NAME\" を作成します。"
+  echo "次の UC 仕様のひな形を作成します（ブランチは作成しません）。"
+  echo "  → $UC_DOC"
   echo -n "  実行してよろしいですか？ [y/N]: "
   read -r ans
   case "$ans" in
@@ -158,30 +138,8 @@ if [[ "$YES_MODE" != true ]]; then
   esac
 fi
 
-git checkout "$MAIN_BRANCH"
-git pull --ff-only 2>/dev/null || true
-
-# ブランチ作成 + UC 仕様書作成（統合）
-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
-valid_uc_pattern="^${BRANCH_PREFIX}/${UC_ID_RE}-[a-z0-9-]+\$"
-if ! echo "$BRANCH_NAME" | grep -qE "$valid_uc_pattern"; then
-  echo "Error: ブランチ名が命名規則に合いません: $BRANCH_NAME（期待: ${BRANCH_PREFIX}/<UC-ID>-kebab-description）" >&2
-  exit 1
-fi
-
-git checkout -b "$BRANCH_NAME"
-echo "Created branch: $BRANCH_NAME"
-
-FEATURE_DIR="docs/02_ユースケース仕様/${CATEGORY}"
-UC_DOC="${FEATURE_DIR}/${NEXT_UC}-${DOC_TITLE}.md"
 mkdir -p "$FEATURE_DIR"
-# UC ごとの判断ログ置き場（任意だが、作成しておくと運用が安定する）
 mkdir -p "${FEATURE_DIR}/判断記録"
-# テンプレ: 修正・改善は .spec-runner/templates/UC-N-ユースケース名.md を編集。プレースホルダ UC-N → UC番号, {ユースケース名} → 題名
 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"
@@ -193,4 +151,4 @@ else
 fi
 
 echo ""
-echo "次の UC 用ブランチの準備ができました。次のステップに進んでください。"
+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,23 +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 仕様の作成
 
-- `.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. テンプレ読込
 
@@ -107,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 は上記スクリプト。
+**次**: 完了後、次のステップへ。