spec-runner 1.0.0 → 1.0.2

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

@@ -27,8 +27,8 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 STATE_FILE="$PROJECT_ROOT/.spec-runner/state.json"
-DEBT_FILE="$PROJECT_ROOT/docs/review/debt.md"
-GLOSSARY="$PROJECT_ROOT/docs/glossary.md"
+DEBT_FILE="$PROJECT_ROOT/docs/振り返り/負債.md"
+GLOSSARY="$PROJECT_ROOT/docs/03_用語集.md"
 
 # ── フレームワーク設定を読み込む ───────────────────────────────────────────────
 # npx spec-runner によって生成された .spec-runner/config.sh を読み込む
@@ -197,10 +197,10 @@ check_debt() {
 # ── usecase/aggregate のパス計算 ───────────────────────────────────────────
 uc_slug()   { echo "$(state_get usecase)" | tr ' ' '-'; }
 agg_slug()  { echo "$(state_get aggregate)" | tr ' ' '-'; }
-uc_req()    { echo "$PROJECT_ROOT/docs/requirements/$(uc_slug).md"; }
-uc_high()   { echo "$PROJECT_ROOT/docs/high-level/$(uc_slug).md"; }
-uc_detail() { echo "$PROJECT_ROOT/docs/detailed/$(uc_slug)"; }
-uc_test()   { echo "$PROJECT_ROOT/docs/test-design/$(uc_slug).md"; }
+uc_req()    { echo "$PROJECT_ROOT/docs/01_要件/$(uc_slug).md"; }
+uc_high()   { echo "$PROJECT_ROOT/docs/02_概要設計/$(uc_slug).md"; }
+uc_detail() { echo "$PROJECT_ROOT/docs/03_詳細設計/$(uc_slug)"; }
+uc_test()   { echo "$PROJECT_ROOT/docs/04_テスト設計/$(uc_slug).md"; }
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # コマンド実装
@@ -282,7 +282,7 @@ cmd_init() {
   # 要件定義ファイルをテンプレートから生成（templates/requirement/template.md を必須とする）
   local req_file tmpl
   req_file=$(uc_req)
-  tmpl="$PROJECT_ROOT/templates/requirement/template.md"
+  tmpl="$PROJECT_ROOT/templates/01_要件定義/ひな形.md"
   [[ -f "$tmpl" ]] || die "要件テンプレートがありません: $tmpl （npx spec-runner でセットアップしてください）"
 
   mkdir -p "$(dirname "$req_file")"
@@ -331,7 +331,7 @@ cmd_design_high() {
 
   check_file "$req_file" "要件定義ファイル" || ((errors++))
   check_status "$req_file" "approved" "要件定義のステータス" || ((errors++))
-  check_gate "glossary_checked" "glossary.md の確認済み" || ((errors++))
+  check_gate "glossary_checked" "用語集.md の確認済み" || ((errors++))
 
   if [[ $errors -gt 0 ]]; then
     echo ""
@@ -374,7 +374,7 @@ updated: $(date +%Y-%m-%d)
 
 ## ドメインモデルの洗い出し
 
-<!-- glossary.md の日本語名で書く -->
+<!-- 用語集.md の日本語名で書く -->
 
 ### エンティティ候補
 
@@ -475,22 +475,22 @@ cmd_design_detail() {
   detail_dir=$(uc_detail)
   case "$sub" in
     usecase)
-      check_file "$detail_dir/domain.md" "ドメインモデル設計" || ((errors++))
-      check_status "$detail_dir/domain.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
+      check_file "$detail_dir/ドメイン.md" "ドメインモデル設計" || ((errors++))
+      check_status "$detail_dir/ドメイン.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
       ;;
     table)
-      check_file "$detail_dir/domain.md" "ドメインモデル設計" || ((errors++))
-      check_status "$detail_dir/domain.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
-      check_file "$detail_dir/usecase.md" "ユースケース設計" || ((errors++))
-      check_status "$detail_dir/usecase.md" "reviewed" "ユースケース設計のレビュー" || ((errors++))
+      check_file "$detail_dir/ドメイン.md" "ドメインモデル設計" || ((errors++))
+      check_status "$detail_dir/ドメイン.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
+      check_file "$detail_dir/ユースケース.md" "ユースケース設計" || ((errors++))
+      check_status "$detail_dir/ユースケース.md" "reviewed" "ユースケース設計のレビュー" || ((errors++))
       ;;
     infra)
-      check_file "$detail_dir/domain.md" "ドメインモデル設計" || ((errors++))
-      check_status "$detail_dir/domain.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
-      check_file "$detail_dir/usecase.md" "ユースケース設計" || ((errors++))
-      check_status "$detail_dir/usecase.md" "reviewed" "ユースケース設計のレビュー" || ((errors++))
-      check_file "$detail_dir/table.md" "テーブル設計" || ((errors++))
-      check_status "$detail_dir/table.md" "reviewed" "テーブル設計のレビュー" || ((errors++))
+      check_file "$detail_dir/ドメイン.md" "ドメインモデル設計" || ((errors++))
+      check_status "$detail_dir/ドメイン.md" "reviewed" "ドメインモデルのレビュー" || ((errors++))
+      check_file "$detail_dir/ユースケース.md" "ユースケース設計" || ((errors++))
+      check_status "$detail_dir/ユースケース.md" "reviewed" "ユースケース設計のレビュー" || ((errors++))
+      check_file "$detail_dir/テーブル.md" "テーブル設計" || ((errors++))
+      check_status "$detail_dir/テーブル.md" "reviewed" "テーブル設計のレビュー" || ((errors++))
       ;;
   esac
 
@@ -504,13 +504,23 @@ cmd_design_detail() {
   state_set_str "phase" "design-detail-$sub"
   state_push_history "design-detail-$sub フェーズ開始"
 
+  # サブ種別→日本語ファイル名（ドメイン駆動の用語をそのまま）
+  local sub_ja
+  case "$sub" in
+    domain)  sub_ja="ドメイン" ;;
+    usecase) sub_ja="ユースケース" ;;
+    table)   sub_ja="テーブル" ;;
+    infra)   sub_ja="インフラ" ;;
+    *)       sub_ja="$sub" ;;
+  esac
+
   # ファイルをテンプレートから生成
   local dest_file usecase
   usecase=$(state_get "usecase")
-  dest_file="$detail_dir/$sub.md"
+  dest_file="$detail_dir/${sub_ja}.md"
   mkdir -p "$detail_dir"
 
-  local tmpl="$PROJECT_ROOT/templates/detailed/$sub.md"
+  local tmpl="$PROJECT_ROOT/templates/03_詳細設計/${sub_ja}.md"
   if [[ ! -f "$dest_file" ]]; then
     if [[ -f "$tmpl" ]]; then
       sed "s/{{USECASE}}/$usecase/g; s/{{DATE}}/$(date +%Y-%m-%d)/g" "$tmpl" > "$dest_file"
@@ -553,16 +563,16 @@ cmd_test_design() {
   local detail_dir
   detail_dir=$(uc_detail)
 
-  for sub in domain usecase table infra; do
-    check_file "$detail_dir/$sub.md" "詳細設計/$sub.md" || ((errors++))
-    check_status "$detail_dir/$sub.md" "reviewed" "詳細設計/$sub.md のレビュー" || ((errors++))
+  for sub_ja in ドメイン ユースケース テーブル インフラ; do
+    check_file "$detail_dir/$sub_ja.md" "03_詳細設計/$sub_ja.md" || ((errors++))
+    check_status "$detail_dir/$sub_ja.md" "reviewed" "03_詳細設計/$sub_ja.md のレビュー" || ((errors++))
   done
 
-  # ADRチェック（必要なADRが作成されているか確認を促す）
+  # 設計判断記録チェック（ADR が 1 件もない場合に促す）
   local adr_count
-  adr_count=$(find "$PROJECT_ROOT/docs/adr" -name "*.md" ! -name "TEMPLATE.md" 2>/dev/null | wc -l | tr -d ' ')
+  adr_count=$(find "$PROJECT_ROOT/docs/99_設計判断記録" -name "*.md" ! -name "ひな形.md" 2>/dev/null | wc -l | tr -d ' ')
   if [[ "$adr_count" -eq 0 ]]; then
-    warn "docs/adr/ にADRが1件もありません。設計判断があればADRを作成してください"
+    warn "docs/99_設計判断記録/ にADRが1件もありません。設計判断があれば作成してください"
   fi
 
   if [[ $errors -gt 0 ]]; then
@@ -770,7 +780,7 @@ cmd_review_pass() {
   uc_slug_val=$(uc_slug)
 
   case "$file" in
-    *requirements*)
+    *01_要件*)
       state_set_bool "gates.require_approved" true
       state_set_str "phase" "require-approved"
       # statusもapprovedに（同一デバイス上で一時ファイル）
@@ -778,35 +788,35 @@ cmd_review_pass() {
       tmp2="${file}.tmp.$$"
       sed "s/^status: .*/status: approved/" "$file" > "$tmp2" && mv "$tmp2" "$file"
       ok "ゲート更新: require_approved = true"
-      info "次: glossary.md を確認後 ./scripts/spec-runner.sh set-gate glossary_checked"
+      info "次: docs/03_用語集.md を確認後 ./scripts/spec-runner.sh set-gate glossary_checked"
       info "    ./scripts/spec-runner.sh design-high"
       ;;
-    *high-level*)
+    *02_概要設計*)
       state_set_bool "gates.high_level_reviewed" true
       ok "ゲート更新: high_level_reviewed = true"
       info "次: ./scripts/spec-runner.sh design-detail domain"
       ;;
-    *domain*)
+    *ドメイン*)
       state_set_bool "gates.domain_model_reviewed" true
       ok "ゲート更新: domain_model_reviewed = true"
       info "次: ./scripts/spec-runner.sh design-detail usecase"
       ;;
-    *usecase*)
+    *ユースケース*)
       state_set_bool "gates.usecase_design_reviewed" true
       ok "ゲート更新: usecase_design_reviewed = true"
       info "次: ./scripts/spec-runner.sh design-detail table"
       ;;
-    *table*)
+    *テーブル*)
       state_set_bool "gates.table_design_reviewed" true
       ok "ゲート更新: table_design_reviewed = true"
       info "次: ./scripts/spec-runner.sh design-detail infra"
       ;;
-    *infra*)
+    *インフラ*)
       state_set_bool "gates.infra_design_reviewed" true
       ok "ゲート更新: infra_design_reviewed = true"
       info "次: ./scripts/spec-runner.sh test-design"
       ;;
-    *test-design*)
+    *04_テスト設計*)
       state_set_bool "gates.test_design_reviewed" true
       ok "ゲート更新: test_design_reviewed = true"
       info "テストコードをコミット後: ./scripts/spec-runner.sh set-gate test_code_committed"
@@ -824,26 +834,102 @@ cmd_set_gate() {
   ok "ゲートフラグ設定: $gate = true"
 }
 
+# ── status 表示用：フェーズ・ゲートの日本語ラベル ─────────────────────────────
+phase_ja() {
+  case "$1" in
+    require) echo "要件定義" ;;
+    require-approved) echo "要件承認済み" ;;
+    design-high) echo "概要設計" ;;
+    design-detail*) echo "詳細設計" ;;
+    test-design) echo "テスト設計" ;;
+    implement) echo "実装" ;;
+    complete) echo "完了" ;;
+    fix) echo "修正" ;;
+    *) echo "$1" ;;
+  esac
+}
+gate_ja() {
+  case "$1" in
+    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 "テストコードコミット済み" ;;
+    *) echo "$1" ;;
+  esac
+}
+
+# ── status: プロジェクト土台（憲章・仕様）の未記入チェック ─────────────────────
+# プレースホルダーが残っている＝テンプレートのまま＝未記入とみなす
+CONSTITUTION_PLACEHOLDER="この節を編集"
+SPECIFY_PLACEHOLDER="（1〜2文で。例:"
+
+is_foundation_written() {
+  local kind="$1"
+  case "$kind" in
+    constitution)
+      [[ -f "$PROJECT_ROOT/docs/01_憲章.md" ]] && ! grep -q "$CONSTITUTION_PLACEHOLDER" "$PROJECT_ROOT/docs/01_憲章.md" 2>/dev/null
+      ;;
+    specify)
+      [[ -f "$PROJECT_ROOT/docs/02_仕様.md" ]] && ! grep -q "$SPECIFY_PLACEHOLDER" "$PROJECT_ROOT/docs/02_仕様.md" 2>/dev/null
+      ;;
+    *) return 1 ;;
+  esac
+}
+
+# 憲章・仕様の未記入案内を表示。mode: no_state（ユースケースなし） or has_state（開始済み）
+status_show_foundation_reminder() {
+  local mode="${1:-no_state}"
+  local c_ok s_ok
+  is_foundation_written constitution && c_ok=1 || c_ok=0
+  is_foundation_written specify && s_ok=1 || s_ok=0
+  [[ $c_ok -eq 1 && $s_ok -eq 1 ]] && return
+
+  if [[ "$mode" == "no_state" ]]; then
+    info "プロジェクトの土台（init の前推奨）:"
+    [[ $c_ok -eq 0 ]] && info "  ✗ 憲章がまだ記入されていません → docs/01_憲章.md （/sr-憲章 で編集）"
+    [[ $s_ok -eq 0 ]] && info "  ✗ 仕様がまだ記入されていません   → docs/02_仕様.md （/sr-仕様 で編集）"
+  else
+    info "💡 プロジェクトの土台:"
+    [[ $c_ok -eq 0 ]] && info "  憲章がまだ → /sr-憲章"
+    [[ $s_ok -eq 0 ]] && info "  仕様がまだ → /sr-仕様"
+  fi
+  info ""
+}
+
 # ── status ─────────────────────────────────────────────────────────────────────
 cmd_status() {
   if [[ ! -f "$STATE_FILE" ]]; then
     info "作業中のユースケースはありません"
-    info "開始するには: ./scripts/spec-runner.sh init <ユースケース名>"
+    info ""
+    status_show_foundation_reminder no_state
+    info "開始するには: チャットで /sr-初期化 <ユースケース名> またはターミナルで下記を実行してください。"
+    info "  例（チャット）: /sr-初期化 会員登録 会員"
+    info "  例（ターミナル）: ./scripts/spec-runner.sh init 会員登録 会員"
     return
   fi
 
+  status_show_foundation_reminder has_state
+
   local usecase phase branch agg_branch
   usecase=$(state_get "usecase")
   phase=$(state_get "phase")
   branch=$(state_get "branch")
   agg_branch=$(state_get "aggregate_branch")
 
+  local phase_ja_label
+  phase_ja_label=$(phase_ja "$phase")
+
   echo ""
   echo -e "${BOLD}════════════════════════════════════════${NC}"
   echo -e "${BOLD} 現在の作業状況${NC}"
   echo -e "${BOLD}════════════════════════════════════════${NC}"
   echo -e "  ユースケース : ${CYAN}$usecase${NC}"
-  echo -e "  フェーズ    : ${YELLOW}$phase${NC}"
+  echo -e "  フェーズ    : ${YELLOW}$phase_ja_label${NC}"
   echo -e "  ブランチ    : ${BLUE}$branch${NC}"
   [[ -n "$agg_branch" ]] && echo -e "  集約ブランチ: ${BLUE}$agg_branch${NC}"
   echo ""
@@ -854,63 +940,64 @@ cmd_status() {
               domain_model_reviewed usecase_design_reviewed \
               table_design_reviewed infra_design_reviewed \
               test_design_reviewed test_code_committed; do
-    local val
+    local val gate_label
     val=$(state_get "gates.$gate")
+    gate_label=$(gate_ja "$gate")
     if [[ "$val" == "true" ]]; then
-      echo -e "  ${GREEN}✓${NC} $gate"
+      echo -e "  ${GREEN}✓${NC} $gate_label"
     else
-      echo -e "  ${RED}✗${NC} $gate"
+      echo -e "  ${RED}✗${NC} $gate_label"
     fi
   done
 
   echo ""
-  echo -e "${BOLD} 次にやるべきこと${NC}"
+  echo -e "${BOLD} 次にやるべきこと${NC} ${CYAN}（チャットでは /sr-* スラッシュコマンドが使えます）${NC}"
   local req_file high_file
   req_file=$(uc_req)
   high_file=$(uc_high)
   case "$phase" in
     require)
       echo -e "  1. ${CYAN}$req_file${NC} を編集"
-      echo -e "  2. ./scripts/spec-runner.sh review-pass $req_file"
-      echo -e "  3. ./scripts/spec-runner.sh set-gate glossary_checked"
-      echo -e "  4. ./scripts/spec-runner.sh design-high"
+      echo -e "  2. /sr-レビュー $req_file"
+      echo -e "  3. /sr-ゲート設定 glossary_checked"
+      echo -e "  4. /sr-概要設計"
       ;;
     design-high)
       echo -e "  1. ${CYAN}$high_file${NC} を編集"
-      echo -e "  2. ./scripts/spec-runner.sh review-pass $high_file"
-      echo -e "  3. ./scripts/spec-runner.sh design-detail domain"
+      echo -e "  2. /sr-レビュー $high_file"
+      echo -e "  3. /sr-詳細設計 domain"
       ;;
-    design-detail)
+    design-detail*)
       if [[ "$(state_get "gates.domain_model_reviewed")" != "true" ]]; then
-        echo -e "  1. docs/detailed/$(uc_slug)/domain.md を編集"
-        echo -e "  2. review-pass のあと ./scripts/spec-runner.sh design-detail usecase"
+        echo -e "  1. docs/03_詳細設計/$(uc_slug)/ドメイン.md を編集"
+        echo -e "  2. /sr-レビュー のあと /sr-詳細設計 usecase"
       elif [[ "$(state_get "gates.usecase_design_reviewed")" != "true" ]]; then
-        echo -e "  1. docs/detailed/$(uc_slug)/usecase.md を編集"
-        echo -e "  2. review-pass のあと ./scripts/spec-runner.sh design-detail table"
+        echo -e "  1. docs/03_詳細設計/$(uc_slug)/ユースケース.md を編集"
+        echo -e "  2. /sr-レビュー のあと /sr-詳細設計 table"
       elif [[ "$(state_get "gates.table_design_reviewed")" != "true" ]]; then
-        echo -e "  1. docs/detailed/$(uc_slug)/table.md を編集"
-        echo -e "  2. review-pass のあと ./scripts/spec-runner.sh design-detail infra"
+        echo -e "  1. docs/03_詳細設計/$(uc_slug)/テーブル.md を編集"
+        echo -e "  2. /sr-レビュー のあと /sr-詳細設計 infra"
       elif [[ "$(state_get "gates.infra_design_reviewed")" != "true" ]]; then
-        echo -e "  1. docs/detailed/$(uc_slug)/infra.md を編集"
-        echo -e "  2. review-pass のあと ./scripts/spec-runner.sh test-design"
+        echo -e "  1. docs/03_詳細設計/$(uc_slug)/インフラ.md を編集"
+        echo -e "  2. /sr-レビュー のあと /sr-テスト設計"
       else
-        echo -e "  ./scripts/spec-runner.sh test-design"
+        echo -e "  /sr-テスト設計"
       fi
       ;;
     test-design)
-      echo -e "  1. docs/test-design/$(uc_slug).md を編集し、テストコードを書く（Red）"
-      echo -e "  2. テストコードをコミット → ./scripts/spec-runner.sh set-gate test_code_committed"
-      echo -e "  3. ./scripts/spec-runner.sh review-pass docs/test-design/$(uc_slug).md"
-      echo -e "  4. ./scripts/spec-runner.sh implement"
+      echo -e "  1. docs/04_テスト設計/$(uc_slug).md を編集し、テストコードを書く（Red）"
+      echo -e "  2. テストコードをコミット → /sr-ゲート設定 test_code_committed"
+      echo -e "  3. /sr-レビュー docs/04_テスト設計/$(uc_slug).md"
+      echo -e "  4. /sr-実装"
       ;;
     implement)
-      echo -e "  実装してテストを Green にしたら: ./scripts/spec-runner.sh complete"
+      echo -e "  実装してテストを Green にしたら: /sr-完了"
       ;;
     complete)
       echo -e "  完了。PR を作成してマージしてください。"
       ;;
     fix)
-      echo -e "  案内に従って該当ドキュメントを修正し、必要なら design-detail 等から再実行。"
+      echo -e "  案内に従って該当ドキュメントを修正し、必要なら /sr-詳細設計 等から再実行。"
       ;;
     *)
       echo -e "  ./scripts/spec-runner.sh help でコマンド一覧を確認"
@@ -962,22 +1049,22 @@ cmd_fix() {
     1)
       info "ドメインモデルから再設計します"
       info "修正ファイル:"
-      info "  docs/detailed/$(uc_slug)/domain.md → status: draft に戻す"
-      info "  docs/detailed/$(uc_slug)/usecase.md → 再確認"
-      info "  docs/test-design/$(uc_slug).md → 再確認"
+      info "  docs/03_詳細設計/$(uc_slug)/ドメイン.md → status: draft に戻す"
+      info "  docs/03_詳細設計/$(uc_slug)/ユースケース.md → 再確認"
+      info "  docs/04_テスト設計/$(uc_slug).md → 再確認"
       ;;
     2)
       info "ユースケース設計から修正します"
-      info "  docs/detailed/$(uc_slug)/usecase.md → status: draft に戻す"
-      info "  docs/test-design/$(uc_slug).md → 再確認"
+      info "  docs/03_詳細設計/$(uc_slug)/ユースケース.md → status: draft に戻す"
+      info "  docs/04_テスト設計/$(uc_slug).md → 再確認"
       ;;
     3)
       info "インフラ設計から修正します"
-      info "  docs/detailed/$(uc_slug)/infra.md → status: draft に戻す"
+      info "  docs/03_詳細設計/$(uc_slug)/インフラ.md → status: draft に戻す"
       ;;
     4)
       info "テーブル設計から修正します"
-      info "  docs/detailed/$(uc_slug)/table.md → status: draft に戻す"
+      info "  docs/03_詳細設計/$(uc_slug)/テーブル.md → status: draft に戻す"
       ;;
     5)
       info "テストを追加して実装を修正します"

package/templates/base/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210//343/202/244/343/203/263/343/203/225/343/203/251.md

@@ -0,0 +1,14 @@
+---
+title: {{USECASE}} インフラ設計
+status: draft
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# {{USECASE}} インフラ設計
+
+## API エンドポイント
+
+## リポジトリ実装方針
+
+## フロントエンド構成（該当時）

package/templates/base/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210//343/203/206/343/203/274/343/203/226/343/203/253.md

@@ -0,0 +1,17 @@
+---
+title: {{USECASE}} テーブル設計
+status: draft
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# {{USECASE}} テーブル設計
+
+## ER（Mermaid）
+
+```mermaid
+erDiagram
+  <!-- ドメインモデル ≠ テーブル。用途で分けてよい -->
+```
+
+## カラム・制約

package/templates/base/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210//343/203/211/343/203/241/343/202/244/343/203/263.md

@@ -0,0 +1,18 @@
+---
+title: {{USECASE}} ドメインモデル設計
+status: draft
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# {{USECASE}} ドメインモデル設計
+
+## エンティティ・値オブジェクト
+
+<!-- docs/03_用語集.md の用語を使う -->
+
+## 集約・リポジトリ IF
+
+## ドメインイベント
+
+## 振る舞い（メソッド）

package/templates/base/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md

@@ -0,0 +1,12 @@
+---
+title: {{USECASE}} ユースケース設計
+status: draft
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# {{USECASE}} ユースケース設計
+
+## Command / Query の入出力
+
+## シーケンス（ドメインモデル参照）

package/templates/base/{docs/adr/TEMPLATE.md → templates/99_/350/250/255/350/250/210/345/210/244/346/226/255/350/250/230/351/214/262//343/201/262/343/201/252/345/275/242.md}

@@ -43,4 +43,4 @@ CIがこのセクションを読んでファイル存在チェックする。
 
 ## 影響
 
-<!-- 他の設計・ADRへの影響 -->
+<!-- 他の設計・ADRへの影響 -->

package/templates/base/templates/README.md

@@ -0,0 +1,32 @@
+# templates/ の役割
+
+DDD の用語をそのまま表すため、**フォルダ名・ファイル名はすべて日本語**。  
+ドキュメントの並び順のため **先頭に番号**（01_〜04_、99_）を付けている。
+
+---
+
+## 1. 生成用テンプレート（スクリプトが参照してファイルを生成する）
+
+| フォルダ | 用途 | 生成先 |
+|----------|------|--------|
+| `01_要件定義/` | init | `docs/01_要件/<ユースケース名>.md`（1 UC ごとに 1 本） |
+| `99_設計判断記録/` | 手動でコピー | `docs/99_設計判断記録/001-xxx.md` など（ADR を増やすとき） |
+| `03_詳細設計/` | design-detail | `docs/03_詳細設計/<UC>/ドメイン.md` など（1 UC ごとに 4 本） |
+
+→ ユーザー側でも **`templates/` に残ったまま**。スクリプトがここを**参照**して生成する。
+
+---
+
+## 2. 初期ドキュメント（deploy 時に docs/ へそのままコピーする）
+
+| フォルダ | 内容 |
+|----------|------|
+| `初期ドキュメント/` | 01_憲章・02_仕様・03_用語集・テンプレート一覧・振り返り・99_設計判断記録用 .gitkeep |
+
+コピー後はユーザーが **`docs/01_憲章.md` などを直接編集**する。
+
+→ ユーザー側では **`docs/`** に現れる。`templates/初期ドキュメント/` は deploy 後も残るが、編集するのは `docs/` の方。
+
+---
+
+**まとめ**: 「生成用」= テンプレートを**元に**スクリプトがファイルを**生成**する。「初期ドキュメント」= 中身を**そのまま** `docs/` に**コピー**して初期状態にする。**99_** は設計判断記録（ADR）用で最後に並ぶ。

package/templates/base/templates//345/210/235/346/234/237/343/203/211/343/202/255/343/203/245/343/203/241/343/203/263/343/203/210/01_/346/206/262/347/253/240.md

@@ -0,0 +1,48 @@
+# プロジェクト憲章（Constitution）
+
+> このプロジェクト全体に適用する**不変の原則**。技術やツールに依存しない。  
+> 機能ごとの仕様は `docs/02_仕様.md` と各ユースケースの `docs/01_要件/` に書く。
+
+---
+
+## 目的・スコープの原則
+
+- このプロジェクトで**何を**作るか・**誰のため**かは、憲章ではなく `docs/02_仕様.md` で定義する。
+- 憲章は「**どういうルールで**開発するか」だけを定める。
+
+---
+
+## 品質・開発ルール（非交渉可能）
+
+1. **設計先行**  
+   実装前に要件・概要設計・詳細設計のいずれかを書く。フェーズゲートを通過するまで実装に進まない。
+
+2. **用語の一意性**  
+   ドメインの概念は `docs/03_用語集.md` に定義し、設計・実装で一貫して使う。
+
+3. **レビュー通過**  
+   各フェーズの成果物は `review-pass` で通過してから次に進む。スキップしない。
+
+4. **変更のトレーサビリティ**  
+   設計判断は `docs/99_設計判断記録/` に記録する。大きな方針変更は憲章の改訂として扱う。
+
+---
+
+## 改訂・バージョン
+
+- 憲章の変更は**意図を明示**し、必要なら履歴をこのファイルの末尾に追記する。
+- 破壊的なルール変更は、チームの合意のうえで行う。
+
+---
+
+## フォルダ・アートファクトの原則（例）
+
+- ドメインは UseCase / Infrastructure に依存しない。
+- 設計ドキュメント（`docs/`）はコードと同期し、変更時は同時に更新する。
+- 上記は例。プロジェクトに合わせて**この節を編集**し、「このプロジェクトのフォルダ構成や成果物のルール」を書く。
+
+---
+
+<!-- 改訂履歴（任意）
+- YYYY-MM-DD: 初版
+-->

package/templates/base/templates//345/210/235/346/234/237/343/203/211/343/202/255/343/203/245/343/203/241/343/203/263/343/203/210/02_/344/273/225/346/247/230.md

@@ -0,0 +1,39 @@
+# プロジェクト仕様（Specify）
+
+> **何を作るか・なぜ作るか**をプロジェクト全体のスコープとして書く。  
+> 個別機能の詳細は各ユースケースの `docs/01_要件/<ユースケース名>.md` に書く。
+
+---
+
+## このプロジェクトで作るもの
+
+（1〜2文で。例: 「会員向けのタスク管理 Web アプリ。ログイン・タスクの CRUD・共有機能を提供する。」）
+
+---
+
+## 作る理由・背景
+
+（なぜこれが必要か。誰の課題を解くか。ビジネス・文脈を短く。）
+
+---
+
+## スコープ（含む / 含まない）
+
+| 含む | 含まない |
+|------|----------|
+| （例: 会員登録・ログイン・タスク CRUD） | （例: 課金・他システム連携） |
+
+---
+
+## 想定ユーザー・コンテキスト
+
+- **誰が**使うか
+- **どのような状況**で使うか（任意）
+
+---
+
+## 参照
+
+- プロジェクトの不変原則: `docs/01_憲章.md`
+- 用語定義: `docs/03_用語集.md`
+- 各機能の要件: `docs/01_要件/<ユースケース名>.md`

package/templates/base/{docs/glossary.md → templates//345/210/235/346/234/237/343/203/211/343/202/255/343/203/245/343/203/241/343/203/263/343/203/210/03_/347/224/250/350/252/236/351/233/206.md}

@@ -48,4 +48,4 @@
 1. 新しい概念 → 実装前にここへ追加
 2. 日本語名変更 → 設計ドキュメントの全使用箇所も更新
 3. 英語名変更 → コードの全使用箇所もリネーム
-4. 「初出」列 → 最初に定義したドキュメントのパスを記載
+4. 「初出」列 → 最初に定義したドキュメントのパスを記載

package/templates/base/templates//345/210/235/346/234/237/343/203/211/343/202/255/343/203/245/343/203/241/343/203/263/343/203/210//343/203/206/343/203/263/343/203/227/343/203/254/343/203/274/343/203/210/344/270/200/350/246/247.md

@@ -0,0 +1,14 @@
+# 生成用テンプレート一覧
+
+すべて **`templates/`** 以下に集約されている。スクリプトがここからファイルを生成する。
+
+| パス | 用途 |
+|------|------|
+| `templates/01_要件定義/ひな形.md` | init 時に `docs/01_要件/<ユースケース名>.md` を生成。`{{USECASE}}`, `{{DATE}}` を置換。 |
+| `templates/99_設計判断記録/ひな形.md` | 新規 ADR のひな形。`docs/99_設計判断記録/` にもコピー済み。手動でコピーして番号・タイトルを付ける。 |
+| `templates/03_詳細設計/ドメイン.md` | design-detail domain 時に `docs/03_詳細設計/<UC>/ドメイン.md` を生成。 |
+| `templates/03_詳細設計/ユースケース.md` | design-detail usecase 時に `docs/03_詳細設計/<UC>/ユースケース.md` を生成。 |
+| `templates/03_詳細設計/テーブル.md` | design-detail table 時に `docs/03_詳細設計/<UC>/テーブル.md` を生成。 |
+| `templates/03_詳細設計/インフラ.md` | design-detail infra 時に `docs/03_詳細設計/<UC>/インフラ.md` を生成。 |
+
+詳細設計テンプレートは `{{USECASE}}`, `{{DATE}}` をスクリプトが置換する。

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

@@ -1,6 +1,6 @@
-# /sr-set-gate
+# /sr-ゲート設定
 
-以下を**必ずターミナルで実行**してください。$ARGUMENTS にはゲート名を指定します（例: `/sr-set-gate glossary_checked`）。
+**チャットで使うコマンド**。$ARGUMENTS にゲート名を指定し、以下を**ターミナルで実行**してください（例: `/sr-ゲート設定 glossary_checked`）。
 
 ```bash
 ./scripts/spec-runner.sh set-gate $ARGUMENTS