spec-runner 1.0.10 → 1.0.12

package/package.json

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

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

@@ -297,6 +297,13 @@ schema_drift_check() {
 
 run_health_check() {
   local drifts=()
+  local current_phase=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
+  fi
 
   UC_ROOT="$(get_steps_common_doc "uc_root")"
   DOMAIN_ROOT="$(get_steps_common_doc "domain_root")"
@@ -317,16 +324,20 @@ run_health_check() {
     grep -qE '^## タスク一覧|^## タスク\\b' "$f" 2>/dev/null || drifts+=("UC ${base}: 「## タスク」または「## タスク一覧」の見出しがありません（UC 仕様書の一番下に記載すること）")
   done
 
-  adr_count=$(find "$ARCH_ROOT/設計判断記録" -name "*.md" 2>/dev/null | wc -l)
-  [[ "${adr_count:-0}" -lt 1 ]] && drifts+=("ADR が 1 件もありません（設計判断記録）")
-
-  if [[ ! -f "$DOMAIN_ROOT/ユビキタス言語辞書.md" ]]; then
-    drifts+=("ユビキタス言語辞書.md が存在しません")
-  else
-    grep -qE '禁止語|forbidden' "$DOMAIN_ROOT/ユビキタス言語辞書.md" 2>/dev/null || drifts+=("ユビキタス言語辞書に禁止語欄が定義されていません")
+  if [[ "$current_phase" -ge 3 ]]; then
+    adr_count=$(find "$ARCH_ROOT/設計判断記録" -name "*.md" 2>/dev/null | wc -l)
+    [[ "${adr_count:-0}" -lt 1 ]] && drifts+=("ADR が 1 件もありません（設計判断記録）")
   fi
-  if [[ -f "$DOMAIN_ROOT/集約.md" ]]; then
-    grep -q '対応テーブル' "$DOMAIN_ROOT/集約.md" 2>/dev/null || drifts+=("集約.md に「対応テーブル」欄がありません")
+
+  if [[ "$current_phase" -ge 2 ]]; then
+    if [[ ! -f "$DOMAIN_ROOT/ユビキタス言語辞書.md" ]]; then
+      drifts+=("ユビキタス言語辞書.md が存在しません")
+    else
+      grep -qE '禁止語|forbidden' "$DOMAIN_ROOT/ユビキタス言語辞書.md" 2>/dev/null || drifts+=("ユビキタス言語辞書に禁止語欄が定義されていません")
+    fi
+    if [[ -f "$DOMAIN_ROOT/集約.md" ]]; then
+      grep -q '対応テーブル' "$DOMAIN_ROOT/集約.md" 2>/dev/null || drifts+=("集約.md に「対応テーブル」欄がありません")
+    fi
   fi
 
   if [[ ! -f ".spec-runner/grade-history.json" ]]; then
@@ -334,13 +345,15 @@ 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" ]]; then
+    if [[ "$grade" == "A" && "$current_phase" -ge 4 ]]; then
       [[ ! -f "$INFRA_ROOT/schema.dbml" ]] && drifts+=("Grade A 必須: schema.dbml が存在しません")
       schema_sync_check >/dev/null 2>&1 || drifts+=("Prisma と schema.dbml のテーブルが一致していません（スキーマ同期チェック）")
     fi
   fi
 
-  [[ ! -f "$OPENAPI_PATH" ]] && drifts+=("openapi.yaml が存在しません")
+  if [[ "$current_phase" -ge 3 ]]; then
+    [[ ! -f "$OPENAPI_PATH" ]] && drifts+=("openapi.yaml が存在しません")
+  fi
 
   if [[ ${#drifts[@]} -eq 0 ]]; then
     ok "健全性確認: 問題なし"

package/templates/.spec-runner/steps//343/203/201/343/202/247/343/203/203/343/202/257/343/203/252/343/202/271/343/203/210.md

@@ -1,6 +1,6 @@
 ---
 step_id: checklist
-phase: quality
+phase: null
 ---
 
 # チェックリスト（品質フロー）

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

@@ -6,13 +6,13 @@ primary_output: docs/02_ユースケース仕様/<カテゴリ>/UC-N-xxx.md
 
 # ユースケース仕様（UC 仕様書）
 
-**やること**: 機能説明（`$ARGUMENTS`）から UC ブランチと UC 仕様書を作成し、テンプレに沿って埋める。その後 clarify → analyze / checklist → review-pass。
+**やること**: 機能説明（`$ARGUMENTS`）から UC ブランチと UC 仕様書を作成し、テンプレに沿って埋める。その後 quality フロー（clarify → analyze）を回し、必要に応じて checklist を実施して review-pass へ進む。
 
 | 項目 | 内容 |
 |------|------|
 | **成果物** | `docs/02_ユースケース仕様/<カテゴリ>/UC-N-xxx.md`（1 UC = 1 本） |
 | **main** | **必ず UC 用ブランチを作成してから**仕様を書く。main で直接編集しない |
-| **品質フロー** | clarify → analyze / checklist → review-pass |
+| **品質フロー** | `phase-locks.json` の `quality` を使って **clarify → analyze** を自動進行。必要なら checklist を追加で実施 |
 | **判断ログ（任意）** | `docs/02_.../<カテゴリ>/判断記録/UC-N-MMDD-題名.md`。テンプレ: `.spec-runner/templates/UC-N-MMDD-判断記録テンプレ.md` |
 
 ## ユーザー入力

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

@@ -54,13 +54,17 @@ $ARGUMENTS
 
 5. **回答ごとの反映（増分）**
    - メモリとファイル内容を保持
-   - 初回反映時: `## 解消事項` が無ければ概要直後に作成。`### Session YYYY-MM-DD` を今日で作成
-   - 採用直後: `- Q: <質問> → A: <回答>` を追記
-   - 内容を適切セクションへ（機能→機能要件、操作→ストーリー/アクター、データ→データモデル、非機能→測定可能な基準、エッジ→エッジケース、用語→統一・旧表記は一度だけ (旧: "X")）
-   - 古い曖昧記述は置換し矛盾を残さない。**各反映の直後にファイル保存**。見出し階層維持。新規見出しは **`## 解消事項`**, **`### Session YYYY-MM-DD`** のみ可
+   - **本文更新を必須**: 採用回答を必ず該当セクションへ反映（機能→機能要件、操作→ストーリー/アクター、データ→データモデル、非機能→測定可能な基準、エッジ→エッジケース、用語→統一・旧表記は一度だけ (旧: "X")）
+   - `## 解消事項` は任意。必要な場合のみ最小限を残す（本文の代替にしない）
+   - 記録する場合は次の改行形式:
+     ```markdown
+     - Q: <質問>
+       A: <回答>
+     ```
+   - 古い曖昧記述は置換し矛盾を残さない。**各反映の直後にファイル保存**。見出し階層維持。新規見出しは **`## 解消事項`** のみ可
 
 6. **検証（各書き込み後・最終）**
-   - 解消セッションは採用回答ごと 1 箇条（重複なし）
+   - 本文に解消済み内容が反映され、本文だけ読めば仕様が確定している
    - 質問数（採用分）≤ 5
    - 更新セクションに解消済みの曖昧プレースホルダが残っていない
    - 矛盾なし、Markdown 有効、用語一貫
@@ -77,7 +81,8 @@ $ARGUMENTS
 - 仕様ファイルがない: 対象仕様（憲章 / UC / ドメイン / アーキ）の作成を案内（ここでは新規作成しない）
 - `[要確認: ...]` が残っている項目を優先して質問対象にする
 - `[要確認: ...]` が無くても、文脈から曖昧・未決定な表現を検出して質問対象に含める
-- 完了時に `.spec-runner/phase-locks.json` の `quality.clarified.<scope>` に対象ドキュメントのベース名を追加する（scope: `charter` / `domain` / `architecture` / `uc`）
+- 実行状態は `.spec-runner/phase-locks.json` の `quality.clarified.<scope>` で管理し、本文に余計な状態メタ情報は残さない
+- `## 解消事項` を残す場合も最小限にし、判断の正本は常に本文とする
 - 質問は合計 5 を超えない（聞き直しは新規に数えない）
 - 機能の明確さを妨げない限り技術スタックの推測質問は避ける
 - 「ストップ」「完了」「進めて」等を尊重