spec-runner 1.0.16 → 1.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-runner",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "フェーズ駆動で設計先行を強制。npx で .spec-runner を展開し、次のステップ .md に従って進める",
   "license": "MIT",
   "bin": {

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

@@ -298,12 +298,16 @@ schema_drift_check() {
 run_health_check() {
   local drifts=()
   local current_phase=0
+  local current_step_id=""
+  local is_quality_step=0
 
   # フェーズに応じてチェック強度を段階適用する
   if [[ -x ".spec-runner/scripts/spec-runner-core.sh" ]] && command -v jq >/dev/null 2>&1; then
     current_phase="$(.spec-runner/scripts/spec-runner-core.sh --json 2>/dev/null | jq -r '.phase // 0' 2>/dev/null)"
     [[ -n "$current_phase" && "$current_phase" != "null" ]] || current_phase=0
+    current_step_id="$(.spec-runner/scripts/spec-runner-core.sh --json 2>/dev/null | jq -r '.step_id // empty' 2>/dev/null)"
   fi
+  [[ "$current_step_id" == "clarify" || "$current_step_id" == "analyze" ]] && is_quality_step=1
 
   UC_ROOT="$(get_steps_common_doc "uc_root")"
   DOMAIN_ROOT="$(get_steps_common_doc "domain_root")"
@@ -320,16 +324,21 @@ run_health_check() {
     count=$(grep -c '\\[要確認:' "$f" 2>/dev/null || echo 0)
     count=$(echo "$count" | head -1 | tr -cd '0-9'); count=${count:-0}
     [[ "$count" -gt 3 ]] && drifts+=("UC ${base}: [要確認: が ${count} 個（3個以下にすること）")
-    grep -qE '^## 実装方針' "$f" 2>/dev/null || drifts+=("UC ${base}: 「## 実装方針」の見出しがありません（UC 仕様書の一番下に記載すること）")
-    grep -qE '^## タスク一覧|^## タスク\\b' "$f" 2>/dev/null || drifts+=("UC ${base}: 「## タスク」または「## タスク一覧」の見出しがありません（UC 仕様書の一番下に記載すること）")
+    # `## 実装方針` / `## タスク(一覧)` は実装計画以降で埋まる想定。
+    # ただし `clarify/analyze` は「任意フェーズで挿入」されるため、
+    # 実装計画が回っていない（＝生成物がまだ無い）タイミングで先回りで落とさない。
+    if [[ "$current_phase" -ge 3 && "$is_quality_step" -eq 0 ]]; then
+      grep -qE '^## 実装方針' "$f" 2>/dev/null || drifts+=("UC ${base}: 「## 実装方針」の見出しがありません（UC 仕様書の一番下に記載すること）")
+      grep -qE '^## タスク一覧|^## タスク\\b' "$f" 2>/dev/null || drifts+=("UC ${base}: 「## タスク」または「## タスク一覧」の見出しがありません（UC 仕様書の一番下に記載すること）")
+    fi
   done
 
-  if [[ "$current_phase" -ge 3 ]]; then
+  if [[ "$current_phase" -ge 3 && "$is_quality_step" -eq 0 ]]; then
     adr_count=$(find "$ARCH_ROOT/設計判断記録" -name "*.md" 2>/dev/null | wc -l)
     [[ "${adr_count:-0}" -lt 1 ]] && drifts+=("ADR が 1 件もありません（設計判断記録）")
   fi
 
-  if [[ "$current_phase" -ge 2 ]]; then
+  if [[ "$current_phase" -ge 2 && "$is_quality_step" -eq 0 ]]; then
     if [[ ! -f "$DOMAIN_ROOT/ユビキタス言語辞書.md" ]]; then
       drifts+=("ユビキタス言語辞書.md が存在しません")
     else
@@ -345,13 +354,13 @@ run_health_check() {
   elif command -v jq >/dev/null 2>&1; then
     grade=$(jq -r '.current_grade' .spec-runner/grade-history.json)
     [[ -n "$grade" && "$grade" != "null" ]] || drifts+=("grade-history.json の current_grade が未設定です")
-    if [[ "$grade" == "A" && "$current_phase" -ge 4 ]]; then
+    if [[ "$grade" == "A" && "$current_phase" -ge 4 && "$is_quality_step" -eq 0 ]]; then
       [[ ! -f "$INFRA_ROOT/schema.dbml" ]] && drifts+=("Grade A 必須: schema.dbml が存在しません")
       schema_sync_check >/dev/null 2>&1 || drifts+=("Prisma と schema.dbml のテーブルが一致していません（スキーマ同期チェック）")
     fi
   fi
 
-  if [[ "$current_phase" -ge 3 ]]; then
+  if [[ "$current_phase" -ge 3 && "$is_quality_step" -eq 0 ]]; then
     [[ ! -f "$OPENAPI_PATH" ]] && drifts+=("openapi.yaml が存在しません")
   fi
 

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

@@ -31,6 +31,16 @@ $ARGUMENTS
 
 ## 実行フロー
 
+### 0. スコープ判定と UC 分解提案（先に実施）
+
+- 入力が広いテーマ（例: 「タスク管理基盤」「認証基盤」「決済基盤」）の場合、**そのまま 1 UC を作らない**。
+- 先に AI が UC 分解案を提案し、ユーザー合意を取ってから UC を作成する。
+- 提案フォーマット（簡潔）:
+  - 候補 UC 一覧（`UC-候補: 目的 / 範囲 / 非対象`）
+  - 優先順（MVP から）
+  - まず作る 1 件（最小価値）
+- 合意後は **1 件ずつ** `uc-next-start.sh` で作成する（CRUD は原則別 UC）。
+
 ### 1. ブランチ用短名（2〜4 語）
 
 - 機能説明からキーワード抽出。**ブランチ名は ASCII のみ**、kebab-case（例: order-placement, user-auth）。
@@ -87,6 +97,8 @@ checklists を使う場合のみ `FEATURE_DIR/checklists/requirements.md` を生
 
 ブランチ名・仕様パス・チェックリスト結果・次フェーズ（曖昧さ解消 / 実装計画）の準備状況。
 
+※ 分解提案を経た場合は、採用された UC 分割案（採用順）も合わせて報告する。
+
 **注**: スクリプトは書き込み前にブランチ作成・チェックアウトと仕様の初期化を行う。
 
 ## 付録 A: 仕様品質チェックリスト例