spec-runner 1.0.24 → 1.1.0

package/templates/.spec-runner/steps//346/206/262/347/253/240.md

@@ -6,7 +6,7 @@ primary_output: docs/01_憲章/憲章.md
 
 # 憲章策定（Phase 0: CHARTER）
 
-**やること**: `docs/01_憲章/憲章.md` のプロジェクト憲章を作成・更新する。spec.md セクション 2（Phase 0）に準拠する。
+**やること**: `docs/01_憲章/憲章.md` のプロジェクト憲章を作成・更新する。spec.md セクション 2（Phase 0）に準拠する。あわせて `docs/work.md` の目的・受入条件・実装タスクを更新する。
 
 | 項目 | 内容 |
 |------|------|

package/templates/.spec-runner/steps//346/233/226/346/230/247/343/201/225/350/247/243/346/266/210.md

@@ -6,7 +6,7 @@ note: 任意フェーズで曖昧さを解消
 
 # 曖昧さ解消（品質フロー）
 
-**やること**: 任意フェーズで対象仕様（憲章 / UC 仕様 / ドメイン設計 / アーキテクチャ）の曖昧さ・不足決定を検出し、**対話で 1 問ずつ**解消して仕様ファイルに反映する。
+**やること**: 任意フェーズで対象仕様（憲章 / UC 仕様 / ドメイン設計 / アーキテクチャ）の曖昧さ・不足決定を検出し、**対話で 1 問ずつ**解消して仕様ファイルに反映する。必要なら `docs/work.md` の受入条件・未解決も更新する。
 
 | 項目 | 内容 |
 |------|------|

package/templates/mkdocs-scaffold/docs/index.md

@@ -22,11 +22,11 @@
 リポジトリルートで次を実行します（Python 3 と `requirements-docs.txt` 用の仮想環境 `.venv-docs/` が使われます）。
 
 ```bash
-./.spec-runner/scripts/docs-serve.sh
+python3 -m venv .venv-docs && ./.venv-docs/bin/pip install -q -r requirements-docs.txt && ./.venv-docs/bin/mkdocs serve --dev-addr 127.0.0.1:8000
 ```
 
 `8000` 番が使用中の場合はポートを変えられます。
 
 ```bash
-DOCS_PORT=8001 ./.spec-runner/scripts/docs-serve.sh
+python3 -m venv .venv-docs && ./.venv-docs/bin/pip install -q -r requirements-docs.txt && ./.venv-docs/bin/mkdocs serve --dev-addr 127.0.0.1:8001
 ```

package/templates/skills/uc-k1-work-card-init/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: uc-k1-work-card-init
+description: 新規作業の docs/work.md を初期化する
+---
+
+# UC-K1: Work Card 初期化スキル
+
+## 目的
+
+新しい作業を始めるときに、`docs/work.md` を最小構成で初期化し、以後の仕様・実装・検証の正本にする。
+
+## 入力
+
+- ユーザーの自然言語要求（今回やりたいこと）
+- 既存の `docs/work.md`（あれば上書きせず更新）
+
+## 出力
+
+- `docs/work.md` に以下が埋まっていること
+  - `目的`
+  - `受入条件`
+  - `実装タスク`
+  - `検証結果`（初期は未実施）
+
+## 実行手順
+
+1. `docs/work.md` が存在するか確認する。
+2. なければ新規作成し、あれば今回作業分に更新する。
+3. ユーザー要求から `目的` を 1-3 行で明文化する。
+4. `受入条件` をテスト可能な箇条書きで 3-7 件作る。
+5. `実装タスク` をチェックボックス（`- [ ]`）で作る。
+6. 初期タスクに次を必ず含める。
+   - 憲章の更新確認
+   - ドメインモデル更新確認
+   - テスト設計
+   - 実装
+7. `検証結果` は初期状態を記入する（例: 「未実施」）。
+
+## テンプレート
+
+```md
+# Work Card
+
+## 目的
+- ...
+
+## 受入条件
+- [ ] ...
+- [ ] ...
+
+## 実装タスク
+- [ ] 憲章の更新確認
+- [ ] ドメインモデル更新確認
+- [ ] テスト設計
+- [ ] 実装
+
+## 検証結果
+- 未実施
+
+## 未解決 / 見送り
+- なし
+
+## コミット確認（任意）
+- [ ] 今回コミットする
+```
+
+## 完了条件
+
+- `docs/work.md` が存在する
+- `目的/受入条件/実装タスク/検証結果` が埋まっている
+- 受入条件が実装タスクと矛盾しない
+
+## 失敗時フォールバック
+
+- 要求が曖昧で受入条件を書けない場合は、推測で埋めず `曖昧さ解消` を先に提案する。
+- 既存 `docs/work.md` と競合する場合は、既存内容を保持しつつ「今回スコープ」を追記する。

package/templates/skills/uc-k2-pre-commit-check/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: uc-k2-pre-commit-check
+description: docs/work.md の未完了と検証漏れを検出する
+---
+
+# UC-K2: コミット前チェック案内スキル
+
+## 目的
+
+コミット前に `docs/work.md` を確認し、未完了チェックと検証漏れを検出する。
+
+## 入力
+
+- なし（`docs/work.md` を読む）
+
+## 出力
+
+- 未完了項目の一覧
+- 検証漏れの一覧
+- 「今回コミットする / しない」の確認文
+
+## 実行手順
+
+1. `docs/work.md` を読み、`- [ ]` の未完了を抽出する。
+2. `## 検証結果` セクションを確認し、`未実施` や空欄を検出する。
+3. `## 受入条件` の完了状況と `## 実装タスク` の完了状況を突き合わせる。
+4. 次の形式で結果を返す。
+   - 未完了: 箇条書き
+   - 検証漏れ: 箇条書き
+   - 判断確認: `今回コミットしますか？（する / しない）`
+5. ユーザーが「しない」を選んだ場合、次に進むタスクを 1-3 件だけ提案する。
+
+## 出力フォーマット
+
+```md
+## コミット前チェック結果
+
+### 未完了
+- ...
+
+### 検証漏れ
+- ...
+
+### コミット確認
+今回コミットしますか？（する / しない）
+```
+
+## 完了条件
+
+- `docs/work.md` の未完了項目を列挙できている
+- 検証結果の不足有無を示せている
+- コミット意思確認を 1 文で提示できている
+
+## 失敗時フォールバック
+
+- `docs/work.md` が見つからない場合は、UC-K1 で初期化してから再実行する。
+- セクション見出しが欠けている場合は、既存内容を壊さず必要見出しの追記を提案する。

package/templates/skills/uc-k3-spec-impl-diff-review/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: uc-k3-spec-impl-diff-review
+description: 仕様と実装差分の不一致を抽出する
+---
+
+# UC-K3: 仕様-実装差分レビュー補助スキル
+
+## 目的
+
+`docs/work.md` の受入条件と実装差分を照合し、仕様不足・実装不足・テスト不足を検出する。
+
+## 入力
+
+- `docs/work.md`
+- 差分ファイル一覧（`git diff --name-only` 相当）
+
+## 出力
+
+- 不一致項目の一覧
+  - 仕様不足
+  - 実装不足
+  - テスト不足
+
+## 実行手順
+
+1. `docs/work.md` の `受入条件` と `実装タスク` を読む。
+2. 差分ファイル一覧から、仕様・実装・テストの変更有無を分類する。
+3. 次の観点で不一致を検出する。
+   - 受入条件にあるのに実装差分が見当たらない
+   - 実装差分があるのに受入条件に反映されていない
+   - 実装差分があるのにテスト差分がない
+4. 不一致がある場合のみ、項目ごとに短く列挙する。
+
+## 出力フォーマット
+
+```md
+## 仕様-実装差分レビュー
+
+### 仕様不足
+- ...
+
+### 実装不足
+- ...
+
+### テスト不足
+- ...
+```
+
+## 完了条件
+
+- 3分類（仕様不足 / 実装不足 / テスト不足）で結果を返せる
+- 不一致なしの場合は「不一致なし」を明記できる
+
+## 失敗時フォールバック
+
+- 差分一覧が無い場合は `git diff --name-only` 相当の取得を提案する。
+- `docs/work.md` の受入条件が未整備なら UC-K1 を先に実行する。

package/templates/spec-runner-command.md

@@ -19,12 +19,11 @@ $ARGUMENTS
    ```bash
    .spec-runner/spec-runner.sh 次のステップ --json
    ```
-   出力は JSON で、少なくとも以下を含む:
+  出力は JSON で、少なくとも以下を含む:
    - `phase` — 現在フェーズ（0〜6）
    - `phase_name_ja` — フェーズ名（日本語）
    - `command` — 推奨ステップ名（例: テスト設計）
    - `command_file` — そのステップの .md の絶対パス（`.spec-runner/steps/` 配下）
-   - `grade` — 検出されたグレード（LOOP1 / A / B / C）
 
 2. **ステップを読み実行する**  
    - `command_file` で示されたファイル（例: `.spec-runner/steps/テスト設計.md`）を開いて読む。
@@ -37,6 +36,8 @@ $ARGUMENTS
 ## ルール
 
 - **spec-runner はこの 1 コマンドでよい。** 迷ったらこれを実行し、`command_file` の内容に従う。
-- `spec-runner.sh 次のステップ` は lock ファイル・ブランチ・グレードからフェーズを判定する。lock がまだ無ければ Phase 0（憲章）から始める。
+- `spec-runner.sh 次のステップ` は lock ファイルと成果物の有無から次フェーズを判定する。lock がまだ無ければ Phase 0（憲章）から始める。
 - ステップ内容は `.spec-runner/steps/` 配下にあり、spec-runner は現在フェーズ用のファイルを読み実行する。
+- **Work Card**: 常に `docs/work.md` を正本として更新する（目的・受入条件・実装タスク・検証結果）。
+- **Skills化（任意）**: 同じ作業が繰り返しになる場合、AI は次に進む前に Skills を提案する。テンプレートは `templates/skills/` 配下（`uc-k1-work-card-init`, `uc-k2-pre-commit-check`, `uc-k3-spec-impl-diff-review`）を優先し、必要なら `.claude/skills/<skill-name>/` に取り込んで使う。
 

package/templates/.spec-runner/hooks/pre-commit

@@ -1,47 +0,0 @@
-#!/bin/bash
-# spec-runner pre-commit: ブランチ名チェック + 命名規則チェック（Section 8-4）
-
-set -e
-REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
-[[ -n "$REPO_ROOT" ]] || exit 0
-
-branch=$(git branch --show-current)
-
-pj="$REPO_ROOT/.spec-runner/project.json"
-[[ -f "$pj" ]] || { echo "pre-commit: project.json がありません: $pj" >&2; exit 1; }
-command -v jq >/dev/null 2>&1 || { echo "pre-commit: jq が必要です（brew install jq）" >&2; exit 1; }
-bp="$(jq -r '.naming.branch_prefix // "feature"' "$pj" 2>/dev/null)"
-uc_id_pat="$(jq -r '.naming.uc_id_pattern // "UC-[0-9]+"' "$pj" 2>/dev/null)"
-other_work="$(jq -r '.naming.other_work_prefixes[]? | . + "/.+"' "$pj" 2>/dev/null | tr '\n' '|' | sed 's/|$//')"
-[[ -z "$other_work" ]] && other_work="work/.+|infra/.+|cicd/.+"
-valid_pattern="^(main|develop|${bp}/(${uc_id_pat}-.+|${other_work})|fix/${uc_id_pat}-.+|release/[0-9]+\\.[0-9]+\\.[0-9]+.*|hotfix/[0-9]+\\.[0-9]+\\.[0-9]+-.+)$"
-
-if ! echo "$branch" | grep -qE "$valid_pattern"; then
-  echo "❌ ブランチ名が規則違反: $branch"
-  echo "   正しい形式:"
-  if [[ -f "$REPO_ROOT/.spec-runner/project.json" ]] && command -v jq >/dev/null 2>&1; then
-    bp=$(jq -r '.naming.branch_prefix // "feature"' "$REPO_ROOT/.spec-runner/project.json" 2>/dev/null || echo "feature")
-  else
-    bp="feature"
-  fi
-  echo "     ${bp}/{UC-ID}-{kebab-description}   （新規UC、UC-IDは project.json の uc_id_pattern）"
-  echo "     ${bp}/cicd/xxx  ${bp}/infra/xxx      （その他作業、project.json の other_work_prefixes）"
-  echo "     fix/{UC-ID}-{kebab-description}        （修正）"
-  echo "     release/{semver}                        （リリース）"
-  echo "     hotfix/{semver}-{kebab-description}     （緊急修正）"
-  exit 1
-fi
-
-# 命名規則チェック（.spec-runner スクリプトがある場合のみ実行）
-if [[ -d "$REPO_ROOT/src" ]]; then
-  while IFS= read -r dir; do
-    [[ -z "$dir" ]] && continue
-    base=$(basename "$dir")
-    if ! echo "$base" | grep -qE '^[a-z][a-z0-9-]*$'; then
-      echo "NAMING: フォルダ名「$dir」はkebab-caseで命名してください" >&2
-      exit 1
-    fi
-  done < <(find "$REPO_ROOT/src/" -type d 2>/dev/null || true)
-fi
-
-exit 0

package/templates/.spec-runner/hooks/pre-push

@@ -1,9 +0,0 @@
-#!/bin/bash
-# spec-runner pre-push: main/develop への直接 push 禁止（Section 8-5）
-
-branch=$(git branch --show-current)
-if [[ "$branch" == "main" || "$branch" == "develop" ]]; then
-  echo "❌ main / develop への直接 push は禁止です。PR を作成してください"
-  exit 1
-fi
-exit 0

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

@@ -1,224 +0,0 @@
-#!/usr/bin/env bash
-# 次の UC を開始する: main に切り替え、feature/UC-N-xxx ブランチを作成する。
-# 使用例:
-#   ./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"
-BRANCH_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-# Git 未初期化ワークスペースでは最小構成で初期化する（main を既定化）
-if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-  git init -b main >/dev/null 2>&1 || git init >/dev/null 2>&1
-fi
-
-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")"
-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
-  exit 1
-}
-
-# 憲章の未コミット変更があれば、AI によるレビュー付きコミットを先に行う
-CHARTER_DOC="$REPO_ROOT/docs/01_憲章/憲章.md"
-if [[ -f "$CHARTER_DOC" ]]; then
-  if [[ -n "$(git status --porcelain -- "$CHARTER_DOC")" ]]; then
-    echo "Error: 憲章に未コミット変更があります: $CHARTER_DOC" >&2
-    echo "       先に AI に差分を確認させ、適切なコミットメッセージでコミットしてください。" >&2
-    echo "       その後に uc-next-start.sh を再実行してください。" >&2
-    exit 1
-  fi
-fi
-
-next_uc_id() {
-  # docs/02_ユースケース仕様/<カテゴリ>/UC-*.md から次に使う UC-N を返す
-  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/branch/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/branch/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
-
-# 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 "  - 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
-  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:-}"
-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 -n "  実行してよろしいですか？ [y/N]: "
-  read -r ans
-  case "$ans" in
-    [yY]|[yY][eE][sS]) ;;
-    *) echo "キャンセルしました。"; exit 0 ;;
-  esac
-fi
-
-# 初回コミット前（unborn HEAD）は checkout main が失敗し得るためフォールバックする
-if git rev-parse --verify HEAD >/dev/null 2>&1; then
-  git checkout "$MAIN_BRANCH"
-  git pull --ff-only 2>/dev/null || true
-else
-  CURRENT_HEAD="$(git symbolic-ref --short -q HEAD 2>/dev/null || echo "")"
-  if [[ -z "$MAIN_BRANCH" ]]; then
-    MAIN_BRANCH="${CURRENT_HEAD:-main}"
-  fi
-  if [[ "$CURRENT_HEAD" != "$MAIN_BRANCH" ]]; then
-    git checkout -b "$MAIN_BRANCH" >/dev/null 2>&1 || true
-  fi
-  echo "Info: 初回コミット前のため pull はスキップします。"
-fi
-
-# ブランチ作成 + 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"
-  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/scripts/docs-serve.sh

@@ -1,21 +0,0 @@
-#!/usr/bin/env bash
-# MkDocs + Material で docs/ をプレビュー（プロジェクトルートで実行される想定）
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-cd "$ROOT"
-
-DOCS_PORT="${DOCS_PORT:-8000}"
-REQ="requirements-docs.txt"
-
-if [[ ! -f "$REQ" ]]; then
-  echo "ERROR: ${REQ} が見つかりません。npx spec-runner を実行して MkDocs 用ファイルを展開してください。" >&2
-  exit 1
-fi
-
-if [[ ! -d .venv-docs ]]; then
-  python3 -m venv .venv-docs
-fi
-
-./.venv-docs/bin/pip install -q -r "$REQ"
-exec ./.venv-docs/bin/mkdocs serve --dev-addr "127.0.0.1:${DOCS_PORT}"

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

@@ -1,27 +0,0 @@
-#!/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"
-command -v jq >/dev/null 2>&1 || { echo "require-tests-green: jq が必要です（brew install jq）" >&2; exit 1; }
-[[ -f "$PROJECT_JSON" ]] || { echo "require-tests-green: $PROJECT_JSON がありません" >&2; exit 1; }
-
-RUN_CMD=$(jq -r '.test_command.run' "$PROJECT_JSON")
-[[ -n "$RUN_CMD" && "$RUN_CMD" != "null" ]] || {
-  echo "require-tests-green: project.json に test_command.run を設定してください。" >&2
-  exit 1
-}
-
-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
-  exit 1
-fi

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

@@ -1,34 +0,0 @@
----
-step_id: other_work
-phase: null
-note: UC ブランチではない
----
-
-# その他作業（CI/CD・インフラ・共通設定など）
-
-**やること**: UC 以外の作業用ブランチ上で、通常開発フローで進める。spec-runner の UC ステップ（仕様策定〜実装）は**対象外**。
-
-| 項目 | 内容 |
-|------|------|
-| **ブランチ** | `feature/<接頭辞>/xxx`（接頭辞は `project.json` の **naming.other_work_prefixes**。既定: work, infra, cicd） |
-| **UC フロー** | このステップのまま **仕様策定〜実装は実行しない** |
-| **参照** | 必要なら `.spec-runner/steps/実装計画.md` と docs/03, 04, 06 等 |
-
-## ブランチの例
-
-| ブランチ例 | 用途 |
-|------------|------|
-| `feature/cicd/github-actions` | CI/CD |
-| `feature/infra/docker` | インフラ・コンテナ |
-| `feature/work/setup-tooling` | 共通ツール |
-
-接頭辞は **project.json の naming.other_work_prefixes** に配列で記載。プロジェクトに合わせて追加・変更可。
-
-## 注意
-
-- phase-locks の `uc_reviewed` や UC 判定には**影響しない**。このブランチ用 lock は不要。
-- 再度「次のステップ」を見たい場合は **UC ブランチに checkout** するか **main に戻る**。
-- 作業完了後は main にマージするか、UC ブランチに切り替えて spec-runner を再実行。
-
----
-**次**: UC 作業に戻る場合は適切なブランチへ。