spec-runner 1.0.5 → 1.0.6

package/README.md

@@ -89,9 +89,7 @@ npx spec-runner
 ⑥ 実装
    ./.spec-runner/scripts/spec-runner.sh implement
    テストを Green にする実装を書く
-
-⑦ 完了
-   ./.spec-runner/scripts/spec-runner.sh complete
+   完了したら: git push → PR 作成。次のユースケースは init <名前> で開始
 ```
 
 TDD はデフォルトで有効。実装に進むには「テスト設計ドキュメント」と「テストコードのコミット」が必須。無効にしたいときは `.spec-runner/config.sh` で `export TDD_ENABLED="false"`。
@@ -140,7 +138,7 @@ curl -sSL https://raw.githubusercontent.com/spec-runner/spec-runner/main/install
 | ④ plan（技術計画） | `design-high` → `design-detail`（domain / usecase / table / infra） |
 | ⑤ analyze（整合性） | `review-pass` と CI の phase-gate-check |
 | ⑥ tasks（タスク分割） | テスト設計・実装フェーズでのタスク単位の進め方 |
-| ⑦ implement | `implement` → `complete` |
+| ⑦ implement | 実装完了後は push → PR。次の UC は `init` で開始 |
 
 ---
 
@@ -200,7 +198,7 @@ npx spec-runner --update
 
 ## スラッシュコマンド
 
-**`/sr-状態` を実行すると、現在のフェーズと「次にやるべきこと」（次に打つコマンド）が動的に表示される。** フェーズ移行（概要設計〜実装完了）はこの案内に従えばよい。
+**`/sr-状態` を実行すると、現在のフェーズと「次にやるべきこと」（次に打つコマンド）が動的に表示される。** フェーズ移行（概要設計〜実装）はこの案内に従い、実装完了後は push → PR → 次の UC は init で開始。
 
 | コマンド | 説明 |
 |----------|------|
@@ -214,7 +212,7 @@ npx spec-runner --update
 | `/sr-修正` 内容 | 修正 |
 | `/sr-緊急修正` 内容 | 緊急修正 |
 
-概要設計・詳細設計・テスト設計・実装・完了は、`/sr-状態` の案内に表示されるので個別に指定不要。
+概要設計・詳細設計・テスト設計・実装は、`/sr-状態` の案内に表示されるので個別に指定不要。実装完了後は push → PR。次の UC は `/sr-初期化` で開始。
 
 定義: Claude `.claude/commands/` / Cursor `.cursor/commands/` / Copilot `.github/prompts/*.prompt.md`（いずれもファイル名・コマンド名は日本語）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-runner",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "AI-driven DDD phase gate system — design-first enforcement for Claude Code, Cursor, and Copilot",
   "license": "MIT",
   "bin": {

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

@@ -18,7 +18,6 @@
 #   ./.spec-runner/scripts/spec-runner.sh fix <修正内容>
 #   ./.spec-runner/scripts/spec-runner.sh hotfix <内容>
 #   ./.spec-runner/scripts/spec-runner.sh review-pass <ドキュメントパス>
-#   ./.spec-runner/scripts/spec-runner.sh complete
 # =============================================================================
 
 set -euo pipefail
@@ -245,13 +244,17 @@ cmd_init() {
   step "ユースケース初期化: $usecase"
   echo ""
 
-  # 既存のstateがあれば警告
+  # 既存のstateがあれば警告（SR_YES=1 のときは AI/CI 用に確認をスキップ）
   if [[ -f "$STATE_FILE" ]]; then
     local current
     current=$(state_get "usecase")
-    warn "作業中のユースケース '$current' があります"
-    read -r -p "上書きしますか？ [y/N] " answer
-    [[ "$answer" =~ ^[Yy]$ ]] || die "中止しました"
+    if [[ "${SR_YES:-0}" == "1" ]]; then
+      warn "作業中のユースケース '$current' を上書きします（SR_YES=1）"
+    else
+      warn "作業中のユースケース '$current' があります"
+      read -r -p "上書きしますか？ [y/N] " answer
+      [[ "$answer" =~ ^[Yy]$ ]] || die "中止しました"
+    fi
   fi
 
   # ブランチ作成
@@ -708,59 +711,10 @@ cmd_implement() {
   info " 1. テストを Green にする実装を書く"
   info " 2. 設計と乖離した場合は先にドキュメントを更新する"
   info " 3. コードとドキュメントを同一コミットに含める"
-  info " 4. 完了後: ./.spec-runner/scripts/spec-runner.sh complete"
+  info " 4. 完了したら: git push → PR 作成。次のユースケースは init <名前> で開始"
   warn "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 }
 
-# ── complete ──────────────────────────────────────────────────────────────────
-cmd_complete() {
-  require_state
-
-  echo ""
-  step "【完了チェック】実装の完了条件を確認します"
-  echo ""
-
-  local errors=0
-
-  # テストが通るか確認を促す
-  warn "テストが全て通過していることを確認してください"
-  read -r -p "全テスト通過済みですか？ [y/N] " ans_test
-  [[ "$ans_test" =~ ^[Yy]$ ]] || { fail "テストを通過させてから完了してください"; ((errors++)); }
-
-  # ドキュメントと実装の乖離チェック
-  read -r -p "設計ドキュメントと実装に乖離はないですか？ [y/N] " ans_doc
-  [[ "$ans_doc" =~ ^[Yy]$ ]] || { fail "ドキュメントを更新してから完了してください"; ((errors++)); }
-
-  if [[ $errors -gt 0 ]]; then
-    echo ""
-    die "完了条件を満たしていません"
-  fi
-
-  state_set_str "phase" "complete"
-  state_push_history "実装完了"
-
-  # ブランチ情報の表示
-  local branch agg_branch usecase
-  branch=$(state_get "branch")
-  agg_branch=$(state_get "aggregate_branch")
-  usecase=$(state_get "usecase")
-
-  echo ""
-  ok "『$usecase』の実装が完了しました！"
-  echo ""
-  info "次のステップ:"
-  info "  1. git push origin $branch"
-  if [[ -f "$PROJECT_ROOT/.github/PULL_REQUEST_TEMPLATE.md" ]]; then
-    info "  2. Pull Request を作成（.github/PULL_REQUEST_TEMPLATE.md を使用）"
-  else
-    info "  2. Pull Request を作成"
-  fi
-  if [[ -n "$agg_branch" ]]; then
-    info "  3. PRマージ先: $agg_branch"
-    info "  4. 関連ユースケースがすべて揃ったら $agg_branch → main へPR"
-  fi
-}
-
 # ── review-pass ───────────────────────────────────────────────────────────────
 cmd_review_pass() {
   local file="${1:-}"
@@ -836,13 +790,31 @@ cmd_review_pass() {
   esac
 }
 
+# 日本語ゲート名 → 内部キー（set-gate で日本語指定時に使用）
+gate_ja_to_key() {
+  case "$1" in
+    要件レビュー済み) echo "require_approved" ;;
+    用語集確認済み) echo "glossary_checked" ;;
+    概要設計レビュー済み) echo "high_level_reviewed" ;;
+    ドメインモデルレビュー済み) echo "domain_model_reviewed" ;;
+    ユースケース設計レビュー済み) echo "usecase_design_reviewed" ;;
+    テーブル設計レビュー済み) echo "table_design_reviewed" ;;
+    インフラ設計レビュー済み) echo "infra_design_reviewed" ;;
+    テスト設計レビュー済み) echo "test_design_reviewed" ;;
+    テストコードコミット済み) echo "test_code_committed" ;;
+    *) echo "$1" ;;
+  esac
+}
+
 # ── set-gate ──────────────────────────────────────────────────────────────────
 cmd_set_gate() {
   require_state
   local gate="${1:-}"
-  [[ -n "$gate" ]] || die "使い方: ./.spec-runner/scripts/spec-runner.sh set-gate <ゲート名>"
-  state_set_bool "gates.$gate" true
-  ok "ゲートフラグ設定: $gate = true"
+  [[ -n "$gate" ]] || die "使い方: ./.spec-runner/scripts/spec-runner.sh set-gate <ゲート名>  例: 用語集確認済み、テストコードコミット済み"
+  local key
+  key=$(gate_ja_to_key "$gate")
+  state_set_bool "gates.$key" true
+  ok "ゲートフラグ設定: $key = true"
 }
 
 # ── status 表示用：フェーズ・ゲートの日本語ラベル ─────────────────────────────
@@ -970,7 +942,7 @@ cmd_status() {
     require)
       echo -e "  1. ${CYAN}$req_file${NC} を編集"
       echo -e "  2. /sr-レビュー $req_file"
-      echo -e "  3. /sr-ゲート設定 glossary_checked"
+      echo -e "  3. /sr-ゲート設定 用語集確認済み"
       echo -e "  4. /sr-概要設計"
       ;;
     design-high)
@@ -997,15 +969,12 @@ cmd_status() {
       ;;
     test-design)
       echo -e "  1. docs/04_テスト設計/$(uc_slug).md を編集し、テストコードを書く（Red）"
-      echo -e "  2. テストコードをコミット → /sr-ゲート設定 test_code_committed"
+      echo -e "  2. テストコードをコミット → /sr-ゲート設定 テストコードコミット済み"
       echo -e "  3. /sr-レビュー docs/04_テスト設計/$(uc_slug).md"
       echo -e "  4. /sr-実装"
       ;;
     implement)
-      echo -e "  実装してテストを Green にしたら: /sr-完了"
-      ;;
-    complete)
-      echo -e "  完了。PR を作成してマージしてください。"
+      echo -e "  実装完了したら: git push → PR 作成。次のユースケースは /sr-初期化 <名前> で開始"
       ;;
     fix)
       echo -e "  案内に従って該当ドキュメントを修正し、必要なら /sr-詳細設計 等から再実行。"
@@ -1136,7 +1105,6 @@ main() {
     design-detail) cmd_design_detail "$@" ;;
     test-design)   cmd_test_design "$@" ;;
     implement)     cmd_implement "$@" ;;
-    complete)      cmd_complete "$@" ;;
     review-pass)   cmd_review_pass "$@" ;;
     set-gate)      cmd_set_gate "$@" ;;
     status)        cmd_status "$@" ;;
@@ -1154,11 +1122,10 @@ main() {
       echo "  design-detail <sub>            詳細設計フェーズ（sub: domain|usecase|table|infra）"
       echo "  test-design                    テスト設計フェーズに移行（ゲートチェック）"
       echo "  implement                      実装フェーズに移行（ゲートチェック）"
-      echo "  complete                       実装完了（完了チェック）"
       echo ""
       echo -e "${BOLD}レビュー:${NC}"
       echo "  review-pass <ファイル>         ドキュメントをレビュー通過にする"
-      echo "  set-gate <ゲート名>            手動でゲートフラグを立てる"
+      echo "  set-gate <ゲート名>            手動でゲートフラグを立てる（日本語可。例: 用語集確認済み）"
       echo ""
       echo -e "${BOLD}確認:${NC}"
       echo "  status                         現在の状態を表示"

package/templates/claude/.claude/commands/sr-/343/202/262/343/203/274/343/203/210/350/250/255/345/256/232.md

@@ -1,9 +1,9 @@
 # /sr-ゲート設定
 
-**チャットで使うコマンド**。$ARGUMENTS にゲート名を指定し、以下を**ターミナルで実行**してください（例: `/sr-ゲート設定 glossary_checked`）。
+**チャットで使うコマンド**。$ARGUMENTS にゲート名を指定し、以下を**ターミナルで実行**してください（例: `/sr-ゲート設定 用語集確認済み`）。
 
 ```bash
 ./.spec-runner/scripts/spec-runner.sh set-gate $ARGUMENTS
 ```
 
-引数が空の場合は、ユーザーに「ゲート名を指定してください（例: glossary_checked, test_code_committed）」と伝えてください。
+ゲート名は**日本語**でも**英語キー**でも指定できます。引数が空の場合は、ユーザーに「ゲート名を指定してください。例: 用語集確認済み、テストコードコミット済み、概要設計レビュー済み」と伝えてください。

package/templates/claude/CLAUDE.md

@@ -92,7 +92,7 @@
 - **TDD: テストを Green にする実装を書く**
 - 設計と乖離した場合は先にドキュメントを更新する
 - コードとドキュメントを同一コミットに含める
-- 完了後: `./.spec-runner/scripts/spec-runner.sh complete`
+- 実装完了後: git push → PR。次のユースケースは `./.spec-runner/scripts/spec-runner.sh init <名前>` で開始
 
 ---
 

package/templates/copilot/.github/copilot-instructions.md

@@ -19,7 +19,7 @@
 - require → design-high → design-detail (domain → usecase → table → infra) → test-design → implement
 - 各フェーズ完了時: `./.spec-runner/scripts/spec-runner.sh review-pass <該当ファイル>`
 - ゲート: `./.spec-runner/scripts/spec-runner.sh set-gate glossary_checked` など
-- 実装完了: `./.spec-runner/scripts/spec-runner.sh complete`
+- 実装完了後: git push → PR。次のユースケースは `init <名前>` で開始
 - 修正: `./.spec-runner/scripts/spec-runner.sh fix "内容"` / `./.spec-runner/scripts/spec-runner.sh hotfix "内容"`
 
 詳細はプロジェクトの README を参照。

package/templates/copilot/.github/prompts/sr-/343/202/262/343/203/274/343/203/210/350/250/255/345/256/232.prompt.md

@@ -1,7 +1,7 @@
 ---
 agent: 'agent'
 description: 'spec-runner: ゲート通過を記録'
-argument-hint: 'ゲート名（例: glossary_checked, test_code_committed）'
+argument-hint: 'ゲート名（例: 用語集確認済み、テストコードコミット済み）'
 tools: ['shell']
 ---
 
@@ -11,4 +11,4 @@ tools: ['shell']
 ./.spec-runner/scripts/spec-runner.sh set-gate ${input:gate:ゲート名}
 ```
 
-引数が空の場合は、ユーザーに「ゲート名を指定してください」と伝えてください。
+ゲート名は日本語（用語集確認済み、テストコードコミット済み など）または英語キーで指定できます。引数が空の場合は、ユーザーに「ゲート名を指定してください。例: 用語集確認済み、テストコードコミット済み」と伝えてください。

package/templates/cursor/.cursor/commands/sr-/343/202/262/343/203/274/343/203/210/350/250/255/345/256/232.md

@@ -1,9 +1,11 @@
 # /sr-ゲート設定
 
-**チャットで使うコマンド**。ユーザーが `/sr-ゲート設定` の後に続けて入力したゲート名で、以下を**ターミナルで実行**してください（例: `/sr-ゲート設定 glossary_checked`）。
+**チャットで使うコマンド**。ユーザーが `/sr-ゲート設定` の後に続けて入力したゲート名で、以下を**ターミナルで実行**してください（例: `/sr-ゲート設定 用語集確認済み`）。
 
 ```bash
 ./.spec-runner/scripts/spec-runner.sh set-gate <ユーザーが入力したゲート名>
 ```
 
-引数が空の場合は、ユーザーに「ゲート名を指定してください（例: glossary_checked, test_code_committed）」と伝えてください。
+ゲート名は**日本語**でも**英語キー**でも指定できます。引数が空の場合は、ユーザーに次のように伝えてください。
+
+「ゲート名を指定してください。例: 用語集確認済み、テストコードコミット済み、概要設計レビュー済み」

package/templates/cursor/.cursor/commands/sr-/345/210/235/346/234/237/345/214/226.md

@@ -1,10 +1,35 @@
 # /sr-初期化
 
-**チャットで使うコマンド**。ユーザーが `/sr-初期化` の後に続けて入力した文字列を引数として、以下を**ターミナルで実行**してください（例: ユーザーが `/sr-初期化 顧客登録 顧客管理` と入力した場合）。
+**チャットで使うコマンド**。ユーザーが `/sr-初期化` の後に続けて入力した文字列を引数として扱います（例: `/sr-初期化 Todoアプリ` → ユースケース名「Todoアプリ」）。
 
-```bash
-./.spec-runner/scripts/spec-runner.sh init <ユーザーが入力した引数>
-```
+## 重要: 対話は「チャット上で AI が埋める」形式で行う
 
-- **引数あり**（例: `顧客登録 顧客管理`）: 未設定なら詳細設定の対話 → 続けてユースケース作成。
-- **引数が空**の場合は、ユーザーに「ユースケース名（と任意で集約名）を指定してください」と伝えるか、**設定対話だけ**したい場合は `/sr-設定` を案内してください。
+- **ターミナルで read や npx --configure の入力待ちにしないこと。** 未設定時は、**AI が** プロジェクト構成を確認し、必要ならチャットでユーザーに聞きながら設定を決め、**AI が** `.spec-runner/config.sh` を編集・生成してから init を実行する。
+
+## 手順
+
+1. **設定済みか確認**  
+   `.spec-runner/config.sh` が存在し、かつ `CONFIGURED="true"` かどうかを確認する。
+
+2. **未設定の場合（config.sh がない、または CONFIGURED が true でない）**
+   - プロジェクトの `package.json` や既存の `src/` などを確認し、Domain/UseCase/テストのパスなどを推測する。
+   - 必要ならチャットでユーザーに聞く（例: 「Domain のパスは `src/domain` でよさそうですが、変更しますか？」）。
+   - 決まったら **AI が** `.spec-runner/config.sh` を編集または作成する。必ず `export CONFIGURED="true"` を設定し、以下の変数も設定する（既存の config.sh がある場合は必要な部分だけ上書きする）。
+   - その後、ターミナルで `./.spec-runner/scripts/spec-runner.sh init <引数>` を実行する。このときはすでに CONFIGURED が true なので、ターミナルでの対話は発生しない。
+
+3. **設定済みの場合**  
+   そのまま `./.spec-runner/scripts/spec-runner.sh init <ユーザーが入力した引数>` を実行する。
+
+4. **引数がない場合**  
+   ユーザーに「ユースケース名（と任意で集約名）を指定してください」と伝えるか、設定だけしたい場合は `/sr-設定` を案内する。
+
+## config.sh に必要な変数（AI が書くときの目安）
+
+- `CONFIGURED="true"` （必須）
+- `DOMAIN_PATH`, `USECASE_PATH`, `INFRA_PATH`（例: `src/domain`, `src/useCase`, `src/infrastructure`）
+- `TEST_DIR`（例: `tests`）, `SOURCE_EXTENSIONS`（例: `ts tsx js jsx`）, `TEST_EXTENSIONS`（例: `test.ts spec.ts`）
+- `TDD_ENABLED`, `SPEC_RUNNER_DDD_ENABLED`（`"true"` / `"false"`）
+- `BUILD_CMD`, `TEST_CMD`, `LINT_CMD`（例: `npm run build`, `npm test`, `npm run lint`）
+- その他、既存の `.spec-runner/config.sh` にあれば同じ形式で揃える（`SPEC_RUNNER_FRAMEWORK`, `SPEC_RUNNER_TOOLS`, `SPEC_RUNNER_LANGUAGE`, `CI_PLATFORM` など）。
+
+非対話で実行したいときは、上書き確認もスキップするため `SR_YES=1 ./.spec-runner/scripts/spec-runner.sh init <引数>` のように実行してよい。

package/templates/cursor/.cursor/commands/sr-/350/250/255/345/256/232.md

@@ -1,11 +1,20 @@
 # /sr-設定
 
-詳細設定（パス・TDD・DDD 等）の**対話のみ**を実行します。ユースケースは作成しません。
+詳細設定（パス・TDD・DDD 等）を**チャット上で AI が埋める**形で行います。ユースケースは作成しません。
 
-以下を**必ずターミナルで実行**してください。
+## 重要: 対話はターミナルではなくチャットで行う
 
-```bash
-./.spec-runner/scripts/spec-runner.sh init
-```
+- **ターミナルで `init` を実行して入力待ちにしないこと。** AI がプロジェクトを確認し、必要ならチャットでユーザーに聞きながら設定を決め、**AI が** `.spec-runner/config.sh` を編集・生成する。
 
-引数なしの init のため、対話で Domain/UseCase のパスやテスト設定を聞かれたあと「最初のユースケースを開始するには…」と表示されて終わります。ユースケースを作る場合は `/sr-初期化 ユースケース名 集約名` を使ってください。
+## 手順
+
+1. `.spec-runner/config.sh` の有無を確認する。ない場合は `npx spec-runner` で一度セットアップされている必要がある（config.sh が存在する前提）。
+2. プロジェクト構成（`package.json`、既存の `src/` やテストディレクトリなど）を確認し、以下を決める（不明ならチャットでユーザーに聞く）:
+   - Domain / UseCase / Infrastructure のパス
+   - テストディレクトリ、ソース・テストの拡張子
+   - TDD を必須にするか、DDD を使うか
+   - CI プラットフォーム、ドキュメント言語 など
+3. **AI が** `.spec-runner/config.sh` を編集または作成する。必ず `export CONFIGURED="true"` を設定し、`sr-初期化` のコマンド説明にある変数（DOMAIN_PATH, USECASE_PATH, TEST_DIR, TDD_ENABLED など）を適切に設定する。
+4. 完了したら「設定を config.sh に反映しました。ユースケースを開始する場合は `/sr-初期化 ユースケース名 集約名` を使ってください」と伝える。
+
+**ターミナルで `./.spec-runner/scripts/spec-runner.sh init` を実行して対話に頼る必要はない。**

package/templates/cursor/.cursorrules

@@ -8,6 +8,7 @@
 - `phase` が `implement` でないときは実装コードを生成しない。ユーザーに「現在のフェーズを確認してください」と伝える。
 - ユーザーが「init して」「status 確認して」「design-high で進めて」などと言ったら、対応する `./scripts/spec-runner.sh` をターミナルで実行する。
 - スラッシュコマンド `/sr-init` などは `.cursor/commands/` に定義済み。チャットで `/sr-status` のように呼び出せる（Agent 経由でシェル実行）。
+- **初期化・設定**: `/sr-初期化` や `/sr-設定` では、未設定時も**ターミナルの入力待ちにしない**。AI がプロジェクトを確認し、チャットで聞くか推測して `.spec-runner/config.sh` を編集・生成してから init を実行する（対話は「AI がどんどん埋めていく」形式）。
 
 ## TDD（テスト駆動）— デフォルトで有効
 
@@ -19,7 +20,7 @@
 - require → design-high → design-detail (domain → usecase → table → infra) → test-design → implement
 - 各フェーズ完了時: `./scripts/spec-runner.sh review-pass <該当ファイル>`
 - ゲート: `./scripts/spec-runner.sh set-gate glossary_checked` など
-- 実装完了: `./scripts/spec-runner.sh complete`
+- 実装完了後: git push → PR。次のユースケースは `./scripts/spec-runner.sh init <名前>` で開始
 - 修正: `./scripts/spec-runner.sh fix "内容"` / `./scripts/spec-runner.sh hotfix "内容"`
 
 詳細はプロジェクトの CLAUDE.md または README を参照。

package/templates/claude/.claude/commands/sr-/345/256/214/344/272/206.md

@@ -1,9 +0,0 @@
-# /sr-完了
-
-以下を**必ずターミナルで実行**してください。
-
-```bash
-./.spec-runner/scripts/spec-runner.sh complete
-```
-
-実行結果をユーザーに伝えてください。

package/templates/copilot/.github/prompts/sr-/345/256/214/344/272/206.prompt.md

@@ -1,13 +0,0 @@
----
-agent: 'agent'
-description: 'spec-runner: 実装フェーズ完了'
-tools: ['shell']
----
-
-以下を**必ずシェルで実行**してください。
-
-```bash
-./.spec-runner/scripts/spec-runner.sh complete
-```
-
-実行結果をユーザーに伝えてください。

package/templates/cursor/.cursor/commands/sr-/345/256/214/344/272/206.md

@@ -1,9 +0,0 @@
-# /sr-完了
-
-以下を**必ずターミナルで実行**してください。
-
-```bash
-./.spec-runner/scripts/spec-runner.sh complete
-```
-
-実行結果をユーザーに伝えてください。