spec-runner 1.1.0 → 1.1.4

package/README.md

@@ -22,7 +22,6 @@ curl -sSL https://raw.githubusercontent.com/TEEE88/spec-runner/main/install.sh |
 
 - `mkdocs.yml` / `requirements-docs.txt`
 - `docs/index.md`（サイトのホーム）
-- `docs/spec-runner-フロー.md`（`spec-runner` パッケージ同梱の手順書）
 
 `.spec-runner/` がすでにあり **2 回目以降はエラーで止まる** 場合も、**その手前**で上記 MkDocs 用ファイルの不足分だけ補完される（初回導入以前のリポジトリで MkDocs だけ足したいときに便利）。
 

package/bin/spec-runner.js

@@ -22,7 +22,6 @@
  * MkDocs（任意・プロジェクトルート）:
  * - templates/mkdocs-scaffold/ の mkdocs.yml / requirements-docs.txt / docs/index.md を
  *   未有効時のみコピー（憲章・設計書は既存の docs/01..06 をそのまま閲覧）
- * - パッケージ同梱の docs/flow.md を docs/spec-runner-フロー.md としてコピー（未存在時のみ）
  */
 
 const fs = require("fs");
@@ -35,7 +34,6 @@ const DEST_DIR = path.join(CWD, ".spec-runner");
 const TEMPLATES_DIR = path.join(TEMPLATE_SPEC_RUNNER_DIR, "templates");
 const PHASE_LOCKS_TEMPLATE = path.join(TEMPLATES_DIR, "phase-locks.json");
 const MKDOCS_SCAFFOLD_DIR = path.join(PKG_DIR, "templates", "mkdocs-scaffold");
-const FLOW_DOC_SRC = path.join(PKG_DIR, "docs", "flow.md");
 const SKILLS_TEMPLATE_DIR = path.join(PKG_DIR, "templates", "skills");
 
 /** コピー時はスキップし、FORCE 時は消さない（ユーザー状態を保持） */
@@ -234,9 +232,6 @@ function installMkdocsScaffold() {
     path.join(MKDOCS_SCAFFOLD_DIR, "docs", "index.md"),
     path.join(CWD, "docs", "index.md"),
   );
-  if (exists(FLOW_DOC_SRC)) {
-    copyFileIfMissing(FLOW_DOC_SRC, path.join(CWD, "docs", "spec-runner-フロー.md"));
-  }
   appendGitignoreVenvDocsIfNeeded();
 }
 

package/docs/flow.md

@@ -49,6 +49,7 @@
    - 全 UC レビュー済みなら `domain`（必要に応じ `clarify` / `analyze`）
 4. `architecture.completed` が false  
    - `architecture_plan`（必要に応じ `clarify` / `analyze`）
+   - lock が true でも、設計成果物（`docs/03` / `docs/04` の `.md`）が無い場合は該当設計フェーズに戻る
 5. 最新 UC がレビュー済みかつテスト準備済み  
    - `implement`  
    それ以外は `test_design`
@@ -68,3 +69,4 @@
 3. コミット前に `docs/work.md` の `- [ ]` を確認する
 4. 完了時に `docs/work.md` の検証結果を更新する
 5. UC を十分に作ってレビュー完了したら `uc_discovery.completed` を `true` にする
+6. カテゴリは箱として扱い、1カテゴリに UC を複数（目安 2〜3 件以上）用意してからドメインへ進む

package/package.json

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

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

@@ -91,7 +91,7 @@ latest_unreviewed_uc_spec() {
   local f key
   while IFS= read -r f; do
     key="$(basename "$f" .md)"
-    jq -e --arg u "$key" '.uc_reviewed[]? == $u' "$LOCK_FILE" >/dev/null 2>&1 && continue
+    jq -e --arg u "$key" 'any(.uc_reviewed[]?; . == $u)' "$LOCK_FILE" >/dev/null 2>&1 && continue
     echo "$f"
     return 0
   done < <(find docs/02_ユースケース仕様 -mindepth 2 -maxdepth 2 -type f -name "UC-*.md" 2>/dev/null | sort -V)
@@ -143,6 +143,8 @@ run_phase() {
   charter_doc="$(get_steps_common_doc "charter")"
   domain_root="$(get_steps_common_doc "domain_root")"
   architecture_root="$(get_steps_common_doc "architecture_root")"
+  domain_spec_present=0
+  arch_spec_present=0
 
   doc_key() { basename "$1" .md; }
   first_md_in_dir() {
@@ -153,6 +155,12 @@ run_phase() {
 
   uc_count_total=$(find docs/02_ユースケース仕様 -mindepth 2 -maxdepth 2 -name "UC-*.md" 2>/dev/null | wc -l | tr -d ' ')
   uc_count_total=${uc_count_total:-0}
+  [[ -n "$(first_md_in_dir "$domain_root" || true)" ]] && domain_spec_present=1
+  [[ -n "$(first_md_in_dir "$architecture_root" || true)" ]] && arch_spec_present=1
+
+  # lock が先に立っていても、設計成果物が無い場合は必ず設計フェーズへ戻す
+  [[ $domain_spec_present -eq 0 ]] && has_domain_lock=0
+  [[ $arch_spec_present -eq 0 ]] && has_arch_lock=0
 
   if [[ $has_charter_lock -eq 0 ]]; then
     if [[ -f "$charter_doc" ]]; then
@@ -240,7 +248,7 @@ run_phase() {
       feature_dir="$(dirname "$uc_spec")"
       uc_key="$(doc_key "$uc_spec")"
       reviewed=0
-      jq -e --arg u "$uc_key" '.uc_reviewed[]? == $u' "$LOCK_FILE" 2>/dev/null | grep -q true && reviewed=1
+      jq -e --arg u "$uc_key" 'any(.uc_reviewed[]?; . == $u)' "$LOCK_FILE" >/dev/null 2>&1 && reviewed=1
       if [[ $reviewed -eq 0 ]]; then
         if ! quality_done "clarified" "uc" "$uc_key"; then
           phase=1; phase_name_ja="ユースケース仕様（曖昧さ解消）"; resolve_step "clarify"

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

@@ -45,11 +45,12 @@ UC_ID_RE="$(jq -r '.naming.uc_id_pattern' "$PROJECT_JSON")"
   exit 1
 }
 
-next_uc_id() {
-  local dir="$REPO_ROOT/docs/02_ユースケース仕様"
+next_uc_id_for_category() {
+  local category="$1"
+  local dir="$REPO_ROOT/docs/02_ユースケース仕様/${category}"
   mkdir -p "$dir"
   local max=0
-  for f in "$dir"/*/UC-*.md; do
+  for f in "$dir"/UC-*.md; do
     [[ -e "$f" ]] || continue
     base=$(basename "$f" .md)
     if [[ "$base" =~ ^(${UC_ID_RE})- ]]; then
@@ -63,7 +64,8 @@ next_uc_id() {
   printf "UC-%d\n" $((max + 1))
 }
 
-NEXT_UC="$(next_uc_id)"
+NEXT_UC=""
+UC_ID_EXPLICIT=0
 SLUG=""
 TITLE=""
 CATEGORY=""
@@ -74,6 +76,7 @@ if [[ ${#ARGS[@]} -ge 1 ]] && [[ "${ARGS[0]}" =~ ^${UC_ID_RE}$ ]]; then
     exit 1
   }
   NEXT_UC="${ARGS[0]}"
+  UC_ID_EXPLICIT=1
   SLUG="${ARGS[1]}"
   TITLE="${ARGS[2]}"
   CATEGORY="${ARGS[3]}"
@@ -113,6 +116,10 @@ if [[ -z "$CATEGORY" ]]; then
   exit 1
 fi
 
+if [[ $UC_ID_EXPLICIT -eq 0 ]]; then
+  NEXT_UC="$(next_uc_id_for_category "$CATEGORY")"
+fi
+
 FEATURE_DIR="docs/02_ユースケース仕様/${CATEGORY}"
 UC_DOC="${FEATURE_DIR}/${NEXT_UC}-${DOC_TITLE}.md"
 

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

@@ -28,9 +28,10 @@ $ARGUMENTS
 
 ## フォルダの作成
 
-- **`docs/02_ユースケース仕様/`** が無ければ新規作成。**カテゴリごとにフォルダ**（例: タスク管理、認証）を切り、その中に **UC-N-xxx.md を 1 本**。
+- **`docs/02_ユースケース仕様/`** が無ければ新規作成。**カテゴリごとにフォルダ**（例: タスク管理、認証）を切り、その中に **UC-N-xxx.md を複数本**作る（カテゴリは 1 UC で終わらせない）。
 - `uc-next-start.sh` でカテゴリ指定するとそのフォルダ内に作成される。
 - **CRUD は原則別 UC**（作成 / 編集 / 削除を分ける）。同一フロー・同一権限・同一受入条件で差分が小さい場合のみ統合可。
+- 目安: 1カテゴリにつき最低 2〜3 UC。MVP は最小 1 UC でも可だが、次に必ず細分化候補を洗い出す。
 
 ## 実行フロー
 

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

@@ -13,7 +13,7 @@
 | インフラ設計 | `docs/05_インフラ設計/` |
 | API 仕様 | `docs/06_API仕様/` |
 
-手順・コマンド・ロックの考え方は **[spec-runner のフロー](spec-runner-フロー.md)** を参照してください（`npx spec-runner` 時にコピーされます）。
+手順・コマンド・ロックの考え方は、リポジトリの `docs/flow.md` を参照してください。
 
 ---