spec-runner 1.0.22 → 1.0.24

package/package.json

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

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

@@ -18,6 +18,11 @@ 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
@@ -44,6 +49,17 @@ BRANCH_PREFIX="$(jq -r '.naming.branch_prefix' "$PROJECT_JSON")"
   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_ユースケース仕様"
@@ -158,8 +174,20 @@ if [[ "$YES_MODE" != true ]]; then
   esac
 fi
 
-git checkout "$MAIN_BRANCH"
-git pull --ff-only 2>/dev/null || true
+# 初回コミット前（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}$"

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

@@ -288,7 +288,11 @@ run_phase() {
     local kind="$1"   # clarified | analyzed
     local scope="$2"  # charter | domain | architecture | uc
     local key="$3"
-    jq -e --arg k "$key" --arg s "$scope" ".quality.${kind}[\$s][]? == \$k" "$LOCK_FILE" >/dev/null 2>&1
+    # 互換性のため、quality には「ベース名」と「.md 付き」の両方を許容する
+    local key_md="${key}.md"
+    jq -e --arg k "$key" --arg km "$key_md" --arg s "$scope" \
+      ".quality.${kind}[\$s][]? | select(. == \$k or . == \$km)" \
+      "$LOCK_FILE" >/dev/null 2>&1
   }
 
   resolve_step() {

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

@@ -18,6 +18,7 @@ primary_output: docs/02_ユースケース仕様/<カテゴリ>/UC-N-xxx.md
 ## ユーザー入力
 
 `$ARGUMENTS` が機能説明。空でコマンドしていない限り、繰り返し入力を求めない。
+ただし **`$ARGUMENTS` が空** の場合は停止せず、AI 側で候補提案を行ってユーザー選択に進む。
 
 ```text
 $ARGUMENTS
@@ -41,6 +42,17 @@ $ARGUMENTS
   - まず作る 1 件（最小価値）
 - 合意後は **1 件ずつ** `uc-next-start.sh` で作成する（CRUD は原則別 UC）。
 
+### 0.5. 引数なし時の候補提示（必須）
+
+- 条件: `$ARGUMENTS` が空。
+- 挙動:
+  1. AI がこのプロジェクト向けの機能案を **3〜5 件**提示する。
+  2. 各案は 1 行で、`案N: 目的 / 主な利用者 / 想定カテゴリ` の形式で簡潔に示す。
+  3. 「番号で選択」または「自由入力で別案指定」を案内する。
+  4. **ユーザーが選ぶまで `uc-next-start.sh` を実行しない**。
+- ユーザー回答後:
+  - 選択された案（または自由入力文）を今回の機能説明として扱い、以降のステップを通常どおり実行する。
+
 ### 1. ブランチ用短名（2〜4 語）
 
 - 機能説明からキーワード抽出。**ブランチ名は ASCII のみ**、kebab-case（例: order-placement, user-auth）。
@@ -50,6 +62,7 @@ $ARGUMENTS
 
 ### 2. ブランチと仕様の作成
 
+- `docs/01_憲章/憲章.md` は先に確定する。未コミット差分がある場合は、**AI が差分を確認してコミットメッセージを作成し、コミット完了後**に `uc-next-start.sh` を実行する。
 - `.spec-runner/scripts/branch/uc-next-start.sh [UC-ID] "$SLUG" "$TITLE" "$CATEGORY" [--yes]`
 - UC-ID は省略可（省略時は自動採番）。**SLUG / TITLE / CATEGORY は必須**（空文字禁止）。
 - CATEGORY で配置先が決まる（カテゴリ名は日本語可）。**機能ごとに 1 回だけ**。
@@ -65,7 +78,7 @@ $ARGUMENTS
 
 ### 4. 本文生成の内訳
 
-1. 入力パース。空なら ERROR「機能説明が指定されていません」
+1. 入力パース。空なら「0.5 引数なし時の候補提示」を実施し、選択後に続行する（即 ERROR にしない）
 2. 重要概念（アクター・アクション・データ・制約）
 3. 不明点: **推測で確定しない** → **`[要確認: ...]`**。付けるのは影響大・解釈複数・デフォルト無しのときのみ。**上限 3 個**。優先: スコープ > セキュリティ > UX > 技術詳細
 4. 「ユーザーシナリオとテスト」を埋める。フロー特定できなければ ERROR