spec-runner 1.6.0 → 1.8.0

package/bin/spec-runner-installer.js

@@ -25,15 +25,13 @@ const DEST_GITHUB_DIR = path.join(CWD, ".github");
 
 const FORCE = process.env.SPEC_RUNNER_FORCE === "1";
 const TARGET = (process.env.SPEC_RUNNER_TARGET || "").trim().toLowerCase();
-const MODE = (process.env.SPEC_RUNNER_MODE || "").trim().toLowerCase();
-const ARCH_STATUS = (process.env.SPEC_RUNNER_ARCH_STATUS || "").trim().toLowerCase();
 
 const TEMPLATE_ROOT = path.join(PKG_DIR, "spec-runner", "templates");
 const CLAUDE_TEMPLATE_DIR = path.join(TEMPLATE_ROOT, ".claude");
 const COPILOT_TEMPLATE_DIR = path.join(TEMPLATE_ROOT, ".github");
 
 function parseArgs(argv) {
-  const out = { target: "", mode: "", archStatus: "" };
+  const out = { target: "" };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
     if (a === "--target" && i + 1 < argv.length) {
@@ -45,24 +43,6 @@ function parseArgs(argv) {
       out.target = a.slice("--target=".length).trim().toLowerCase();
       continue;
     }
-    if (a === "--mode" && i + 1 < argv.length) {
-      out.mode = String(argv[i + 1] || "").trim().toLowerCase();
-      i += 1;
-      continue;
-    }
-    if (a.startsWith("--mode=")) {
-      out.mode = a.slice("--mode=".length).trim().toLowerCase();
-      continue;
-    }
-    if (a === "--arch-status" && i + 1 < argv.length) {
-      out.archStatus = String(argv[i + 1] || "").trim().toLowerCase();
-      i += 1;
-      continue;
-    }
-    if (a.startsWith("--arch-status=")) {
-      out.archStatus = a.slice("--arch-status=".length).trim().toLowerCase();
-      continue;
-    }
   }
   return out;
 }
@@ -196,48 +176,6 @@ function promptTargetInteractive() {
   return "claude";
 }
 
-function normalizeMode(t) {
-  if (!t) return "";
-  const x = String(t).trim().toLowerCase();
-  if (x === "new" || x === "n") return "new";
-  if (x === "existing" || x === "exist" || x === "e") return "existing";
-  return "";
-}
-
-function promptModeInteractive() {
-  if (!isTTY()) return "new";
-
-  const ans = promptLine(
-    "\nプロジェクトの状態を選んでください:\n" +
-    "  1) 新規プロジェクト\n" +
-    "  2) 既存プロジェクト\n" +
-    "選択 [1/2] : "
-  );
-  if (ans === "2") return "existing";
-  return "new";
-}
-
-function normalizeArchStatus(t) {
-  if (!t) return "";
-  const x = String(t).trim().toLowerCase();
-  if (x === "undecided" || x === "u") return "undecided";
-  if (x === "decided" || x === "d") return "decided";
-  return "";
-}
-
-function promptArchStatusInteractive() {
-  if (!isTTY()) return "undecided";
-
-  const ans = promptLine(
-    "\nアーキテクチャの状態を選んでください:\n" +
-    "  1) 未決定（これから決める）\n" +
-    "  2) 既に決まっている\n" +
-    "選択 [1/2] : "
-  );
-  if (ans === "2") return "decided";
-  return "undecided";
-}
-
 function archivePathFor(destPath, archiveRoot) {
   // destPath は CWD の配下を想定
   const rel = path.relative(CWD, destPath);
@@ -390,21 +328,12 @@ function printBanner() {
   console.log("");
 }
 
-function printNextSteps(archStatus) {
+function printNextSteps() {
   console.log("─────────────────────────────────────────");
-  if (archStatus === "decided") {
-    console.log("次のステップ:");
-    console.log("");
-    console.log("  1. .spec-runner/architecture/architecture.yaml を用意してください。");
-    console.log("     （既に決まっているアーキテクチャを記述）");
-    console.log("");
-    console.log("  2. Claude Code を開いて /architecture-skill-development を実行してください。");
-  } else {
-    console.log("次のステップ:");
-    console.log("");
-    console.log("  Claude Code を開いて、作りたいものを伝えてください。");
-    console.log("  セットアップが自動で始まります。");
-  }
+  console.log("次のステップ:");
+  console.log("");
+  console.log("  Claude Code を開いて、作りたいものを伝えてください。");
+  console.log("  セットアップが自動で始まります。");
   console.log("─────────────────────────────────────────");
 }
 
@@ -415,13 +344,6 @@ function main() {
   let target = normalizeTarget(args.target) || normalizeTarget(TARGET);
   if (!target) target = promptTargetInteractive();
 
-  let mode = normalizeMode(args.mode) || normalizeMode(MODE);
-  if (!mode) mode = promptModeInteractive();
-
-  let archStatus = normalizeArchStatus(args.archStatus) || normalizeArchStatus(ARCH_STATUS);
-  if (!archStatus && mode === "new") archStatus = promptArchStatusInteractive();
-  if (!archStatus) archStatus = "undecided";
-
   const ts = FORCE ? isoTimestampSafe() : null;
   const archiveRoot = ts ? path.join(CWD, ".spec-runner", "archive", ts) : null;
 
@@ -466,7 +388,7 @@ function main() {
   else if (target === "copilot") console.log("完了: .github/ を導入しました。");
   else console.log("完了: .claude/ と .github/ を導入しました。");
   console.log("");
-  printNextSteps(archStatus);
+  printNextSteps();
 }
 
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-runner",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "docs を正本にした開発運用ハーネスを Claude / Copilot に導入する",
   "license": "MIT",
   "bin": {

package/spec-runner/templates/.claude/rules/agent-delegation.md

@@ -14,6 +14,7 @@ description: メインエージェントがサブエージェントへ委任す
 | コーディング規約チェック | `@review-code` | 実装・修正が完了したとき |
 | テスト実行＋失敗分析 | `@run-tests` | 実装・修正が完了したとき |
 | 変更の影響範囲調査 | `@analyze-impact` | design-change で影響範囲を洗うとき |
+| エラー・技術的な詰まりの調査 | サブエージェント（WebSearch） | 解決策が不明なとき。`.spec-runner/references/resources.md` に記載された URL を起点に検索する |
 
 ## 並行起動
 

package/spec-runner/templates/.claude/rules/design-docs.md

@@ -1,20 +1,10 @@
 ---
-description: 設計書共通ルール（ヘッダー・命名規則・ADR・文書品質）
+description: 設計書共通ルール（ヘッダー・node_id 体系・命名規則・文書品質）
 paths: ["docs/**"]
 ---
 
 # 設計書共通ルール
 
-## フェーズ管理
-
-- ユーザー承認なしにフェーズを進めない
-- フェーズは必ず `要件定義 -> 概要設計 -> 詳細設計 -> TDD -> 実装` の順に進める
-
-## テンプレート
-
-- 設計書は必ずテンプレートをコピーして生成する。独自にゼロから作成しない
-- 手順: テンプレートを読む → 出力先へコピーする → プレースホルダーを埋める
-
 ## ヘッダー
 
 - `docs/**` の全設計書にヘッダーを付ける
@@ -41,6 +31,8 @@ spec_runner:
 
 ### node_id 体系
 
+#### バックエンド
+
 | 対象 | node_id 形式 | 例 |
 |------|-------------|-----|
 | 要件定義 | `requirement.{名前}` | `requirement.要件定義` |
@@ -52,26 +44,42 @@ spec_runner:
 | UC 詳細設計 | `detail.usecase.{UC名}` | `detail.usecase.注文確定` |
 | DB・外部サービス | `detail.db.{名前}` | `detail.db.スキーマ定義` |
 
+#### フロントエンド（has_frontend: true のみ）
+
+| 対象 | node_id 形式 | 例 |
+|------|-------------|-----|
+| 要件定義 | `frontend.requirement.{名前}` | `frontend.requirement.要件定義` |
+| 画面一覧 | `frontend.overview.画面一覧` | — |
+| 画面遷移図 | `frontend.overview.画面遷移図` | — |
+| コンポーネント一覧 | `frontend.overview.コンポーネント一覧` | — |
+| ADR | `frontend.adr.{slug}` | `frontend.adr.0404-UIフレームワーク選定` |
+| 画面詳細設計 | `frontend.detail.画面.{画面名}` | `frontend.detail.画面.ログイン` |
+| コンポーネント詳細設計 | `frontend.detail.component.{名前}` | `frontend.detail.component.ボタン` |
+
 ## 命名規則
 
+### バックエンド
+
 | 対象 | 規則 | 例 |
 |------|------|-----|
-| `docs/01_要件定義` | 日本語 | `要件定義.md`, `ユビキタス言語辞書.md` |
-| `docs/02_概要設計` | 日本語 | `ユースケース一覧.md`, `システム全体俯瞰.md` |
-| `docs/02_概要設計`（style: ddd のみ） | 日本語 | `ドメインモデル.md` |
-| `docs/02_概要設計/90_ADR/{対象}/` | `mmdd-{日本語タイトル}.md` | `0404-注文集約の設計.md` |
+| `docs/バックエンド/01_要件定義` | 日本語 | `要件定義.md`, `ユビキタス言語辞書.md` |
+| `docs/バックエンド/02_概要設計` | 日本語 | `ユースケース一覧.md`, `システム全体俯瞰.md` |
+| `docs/バックエンド/02_概要設計`（style: ddd のみ） | 日本語 | `ドメインモデル.md` |
+| `docs/バックエンド/02_概要設計/90_ADR/{対象}/` | `mmdd-{日本語タイトル}.md` | `0404-注文集約の設計.md` |
 | `{対象}` の選択肢 | `全体` / `ドメイン` / `UC` / `DB` | — |
-| `docs/03_詳細設計/01_ドメイン`（style: ddd のみ） | 日本語 | `注文.md`, `在庫.md` |
-| `docs/03_詳細設計/02_ユースケース`（style: ddd） / `01_ユースケース`（style: layered） | `UC-{日本語名}.md` | `UC-注文確定.md` |
-| `docs/03_詳細設計/03_DB・外部サービス`（style: ddd） / `02_DB・外部サービス`（style: layered） | 日本語 | `スキーマ定義.dbml`, `外部サービス.md` |
+| `docs/バックエンド/03_詳細設計/01_ドメイン`（style: ddd のみ） | 日本語 | `注文.md`, `在庫.md` |
+| `docs/バックエンド/03_詳細設計/02_ユースケース`（style: ddd） / `01_ユースケース`（style: layered） | `UC-{日本語名}.md` | `UC-注文確定.md` |
+| `docs/バックエンド/03_詳細設計/03_DB・外部サービス`（style: ddd） / `02_DB・外部サービス`（style: layered） | 日本語 | `スキーマ定義.dbml`, `外部サービス.md` |
 
-## ADR
+### フロントエンド（has_frontend: true のみ）
 
-- ADR は提案時に必ず 3 案を比較してから採用案を決める。ドキュメントには採用案と採用理由のみ記録する
-- ADR は `docs/02_概要設計/90_ADR/{対象}/` で管理する（`全体` / `ドメイン` / `UC` / `DB`）
-- ファイル名は `mmdd-{日本語タイトル}.md`。対象はフォルダで表す
-- ADR は理由の記録であり、詳細設計の代わりにしない
-- 廃止 UC の理由も ADR に記録する（UC ファイル本体は削除）
+| 対象 | 規則 | 例 |
+|------|------|-----|
+| `docs/フロントエンド/01_要件定義` | 日本語 | `要件定義.md` |
+| `docs/フロントエンド/02_概要設計` | 日本語 | `画面一覧.md`, `画面遷移図.md`, `コンポーネント一覧.md` |
+| `docs/フロントエンド/02_概要設計/90_ADR/` | `mmdd-{日本語タイトル}.md` | `0404-UIフレームワーク選定.md` |
+| `docs/フロントエンド/03_詳細設計/01_画面/{カテゴリ名}/` | 日本語 | `ログイン.md`, `ダッシュボード.md` |
+| `docs/フロントエンド/03_詳細設計/02_コンポーネント/` | 日本語 | `ボタン.md`, `モーダル.md` |
 
 ## 文書品質
 
@@ -91,8 +99,8 @@ spec_runner:
 
 | 種別 | 内容 | 置き場所 |
 |------|------|---------|
-| ドメインモデル | ビジネスルール・集約・値オブジェクト・不変条件 | `docs/03_詳細設計/01_ドメイン/` |
-| データモデル | DBスキーマ・テーブル定義・カラム定義・インデックス | `docs/03_詳細設計/03_DB・外部サービス/` |
+| ドメインモデル | ビジネスルール・集約・値オブジェクト・不変条件 | `docs/バックエンド/03_詳細設計/01_ドメイン/` |
+| データモデル | DBスキーマ・テーブル定義・カラム定義・インデックス | `docs/バックエンド/03_詳細設計/03_DB・外部サービス/` |
 
 - `01_ドメイン/` に DB スキーマ・テーブル定義・カラム定義を書かない
 - `03_DB・外部サービス/` にビジネスルール・ドメインロジックを書かない

package/spec-runner/templates/.claude/skills/architecture-definition/SKILL.md

@@ -20,10 +20,12 @@ Phase 5: architecture-skill-development へ自動移行
 
 テンプレート: `.claude/skills/ddd-seed/templates/01_要件定義/`
 
-1. 曖昧な前提があれば `spec-probe` スキルで先に整理する
+1. 背景・提供価値・制約・スコープ外について、曖昧な点があれば一問一答で深掘りする（各質問に推奨回答を添える。コードで確認できることは質問しない）
 2. ユーザーから背景、提供価値、制約、スコープ外を確認する
-3. テンプレートをコピーして `docs/01_要件定義/要件定義.md` を作る
-4. ドメイン用語が出てきたら `docs/01_要件定義/ユビキタス言語辞書.md` に随時追記する
+3. テンプレートをコピーして以下を作る
+   - `docs/バックエンド/01_要件定義/要件定義.md`
+   - `has_frontend: true` の場合は `docs/フロントエンド/01_要件定義/要件定義.md` も作る
+4. ドメイン用語が出てきたら `docs/バックエンド/01_要件定義/ユビキタス言語辞書.md` に随時追記する
 5. アーキテクチャスタイルを選択する
 
    | スタイル | 選ぶ基準 |
@@ -87,4 +89,10 @@ Phase 4 が承認されたら、ユーザーにコマンドを打たせずに `a
 1. `architecture-skill-development` に渡す前提（docs・architecture.yaml・確定済みフォルダ構造）を要約する
 2. project 専用 skill に切り出すべき反復フローを列挙する
 3. 確認なしに `architecture-skill-development` Phase 1 へ進む
-4. スキル整備完了後、プロジェクト専用スキルを使って概要設計へ進む
+4. スキル整備完了後、以下のスキルで概要設計へ進む
+
+   | 条件 | 起動するスキル |
+   |------|--------------|
+   | `style: ddd` | `ddd-seed`（バックエンド） |
+   | `style: layered` | `simple-seed`（バックエンド） |
+   | `has_frontend: true` | 上記に加えて `frontend-seed` を並走させる |

package/spec-runner/templates/.claude/skills/architecture-skill-development/SKILL.md

@@ -18,7 +18,7 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 
 ## Phase 1: 入力の確認
 
-1. `docs/01_要件定義/**` を読む
+1. `docs/バックエンド/01_要件定義/**` を読む。`has_frontend: true` の場合は `docs/フロントエンド/01_要件定義/**` も読む
 2. `.spec-runner/architecture/architecture.yaml` を読む
 3. 固定化すべき判断と project 固有判断を切り分ける
 
@@ -37,18 +37,19 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 2. 常時守る約束は rule にする
 3. 毎回コピーする設計書は template にする
 
-### seed の選択
+### プロジェクト専用スキルの作成
 
-`architecture.yaml` の `style` と `has_frontend` を読み、使う seed を決める。
+`architecture.yaml` の `style` に応じた seed（`ddd-seed` / `simple-seed`）がインストール済みの場合、どのように専用スキルを作るかをユーザーに確認する。
 
-| style | 使う seed | 説明 |
-|-------|----------|------|
-| `ddd` | `ddd-seed` | ドメイン層（集約・値オブジェクト）を持つ DDD 向けフロー |
-| `layered` | `simple-seed` | ドメイン層を持たない UC・サービス層中心のフロー |
+| 選択肢 | 内容 |
+|--------|------|
+| 新規に作る | `harness-format.md` を基に、このプロジェクトのフローをゼロから記述する |
+| リネームだけ | seed ファイルをプロジェクト専用名に変更する |
+| リネーム＋構成変更 | seed をリネームしたうえでフェーズ構成・テンプレートパスをプロジェクトの実態に合わせて書き換える |
 
-`has_frontend: true` の場合、seed から生成するプロジェクト専用スキルに「UC ファイルに画面レイアウトセクションを含める」旨を明記する。
+seed が存在しない場合は「新規に作る」で進める。
 
-選んだ seed の SKILL.md をコピーし、フェーズ構成・テンプレートパス・用語をこのプロジェクトの実態に合わせて書き換えたプロジェクト専用 skill を作る（Phase 1 は完了済みのため削除する。元の seed はアーカイブ候補とする）。
+`has_frontend: true` の場合は、`frontend-seed` と バックエンド seed の両方を並走させる旨を専用スキルに明記する。
 
 4. ユーザーに確認・承認を得る
 
@@ -57,12 +58,25 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 インストール時に配布された基盤 skill のプレースホルダーを、このプロジェクトの実態に書き換える。
 以降の書き換えはすべて `architecture.yaml` の `integrations` に従う（`claude` のみなら `.claude/` だけ、`github` のみなら `.github/` だけ、両方なら対で更新する）。
 
+### インフラ構成ファイルの整備
+
+`architecture.yaml` の `language` / `folder_structure` / `testing_policy` を参照して以下を作成する。
+
+1. **`.gitignore`**: 言語・フレームワーク固有のパターン（依存パッケージ・ビルド成果物・キャッシュ）と、プロジェクト固有の除外パス（`.env`、`docs/` 等）をユーザーと確認して作成する
+2. **`.dockerignore`**: `.git`・`docs/`・`tests/`・依存パッケージ・ビルド成果物をビルドコンテキストから除外する。ユーザーに追加除外パスを確認する
+3. **`Dockerfile.test`**: テスト実行専用イメージを作成する
+   - ベースイメージをユーザーに確認する（例: `python:3.12-slim`, `node:20-alpine`）
+   - テスト依存（テストフレームワーク・カバレッジツール等）をインストールする
+   - `has_frontend: true` の場合はフロントエンド用も作成する
+
 ### test-config.md の書き換え
 
 `rules/test-config.md`（GitHub Copilot は `instructions/test-config.instructions.md`）はテスト実行コマンドの単一ソースとして `test-driven-development` スキルと `run-tests` エージェントの両方から参照される。`architecture.yaml` の `testing_policy` を参照して書き換える。
 
-1. **テスト実行コマンド**: `<your-unit-test-command>` / `<your-integration-test-command>` 等を実際のコマンドに書き換える
-2. **テスト構成**: `tests/` のディレクトリ構成が実態と異なる場合は書き換える
+1. **Docker Compose サービス名の確認**: バックエンド・フロントエンドそれぞれのサービス名をユーザーに確認する（例: `backend`, `frontend`）
+2. **LocalStack の確認**: AWS サービスを使うか確認する。使う場合は対象サービス（S3, SQS, DynamoDB 等）と LocalStack のサービス名をユーザーに確認する
+3. **テスト実行コマンド**: `docker compose run --rm <service> <test-command>` の形式で各コマンドを書き換える
+4. **テスト構成**: `tests/` のディレクトリ構成が実態と異なる場合は書き換える
 
 ### test-driven-development の書き換え
 
@@ -71,13 +85,6 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 1. **fixture / テストデータ**: このプロジェクトの実際のクラス名・DB 接続方法・ヘルパ関数パターンを記述する
 2. **モックのルール**: 使用する外部サービスとモック手段（ライブラリ名など）を具体化する
 
-### 影響範囲チェックリストの書き換え
-
-`.claude/skills/design-change/references/影響範囲チェックリスト.md` をプロジェクト固有の変更カテゴリとパスに合わせて書き換える。
-
-1. 変更カテゴリをプロジェクトの構成要素（モジュール・サービス・ドメインなど）に合わせて追加・削除する
-2. 詳細設計のパスを `architecture.yaml` の `folder_structure` に合わせて書き換える
-
 ### code-style.md の書き換え
 
 `architecture.yaml` の `language` と `folder_structure` を参照して、以下を実際の値に置き換える。
@@ -88,6 +95,19 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 3. **言語・型固有ルール**: `<your-language-and-type-rules>` を言語・フレームワークに合わせた具体的なルールに書き換える
 4. **プロジェクト構造**: `<your-project-structure>` を `folder_structure` の実際のディレクトリ構成に書き換える
 
+### リファレンス URL の登録
+
+`.spec-runner/references/resources.md` に、このプロジェクトで使う公式ドキュメントの URL を登録する。
+
+1. ユーザーに以下を確認する:
+   - 言語・フレームワーク・ツールの公式ドキュメント URL
+   - 参考にしているサンプルリポジトリ・リファレンス実装
+   - API 仕様（OpenAPI など）
+   - 社内 Wiki・Notion などの内部ドキュメント
+   - その他ベストプラクティス記事・移行ガイドなど
+2. 教えてもらった情報を名前・カテゴリとともに `.spec-runner/references/resources.md` の該当テーブルに書き込む
+3. ユーザーが追加を終えたら次へ進む
+
 ### その他の基盤 skill
 
 同様のプレースホルダーや汎用記述が他の skill にあれば、同じ要領で書き換える。
@@ -109,8 +129,8 @@ Phase 6: セットアップ専用 skill のアーカイブ提案
 |---|---|
 | `architecture-definition` | 新規プロジェクト初期化専用。アーキテクチャ確定後は不要 |
 | `existing-project-to-docs` | 既存プロジェクト取り込み専用。docs 生成後は不要 |
-| `ddd-seed` | style: ddd で seed 使用後は不要。ただし `architecture-definition` も同時アーカイブする場合のみ `templates/01_要件定義/` を削除可 |
-| `simple-seed` | style: layered で seed 使用後は不要 |
+| `ddd-seed` / `simple-seed` | プロジェクト専用スキル作成後は不要 |
+| `frontend-seed` | `has_frontend: true` かつプロジェクト専用スキル作成後は不要 |
 | `architecture-skill-development`（このファイル自身） | project 専用 skill が安定したら不要。アーキテクチャ大変更時は再利用可 |
 
 ### 手順

package/spec-runner/templates/.claude/skills/ddd-seed/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ddd-seed
-description: UC/DDD 駆動の docs 正本開発フローの種。新規プロジェクトの初期テンプレートとして使い、architecture-skill-development でプロジェクト専用スキルに育てる。
+description: UC/DDD 駆動の docs 正本開発フローの種（バックエンド担当）。新規プロジェクトの初期テンプレートとして使い、architecture-skill-development でプロジェクト専用スキルに育てる。
 ---
 
 # ddd-seed
@@ -12,7 +12,7 @@ description: UC/DDD 駆動の docs 正本開発フローの種。新規プロジ
 | キー | 用途 |
 |------|------|
 | `style` | このスキル（`ddd`）が適切かを確認 |
-| `has_frontend` | `true` なら UC ファイルに「画面レイアウト」セクションを含める |
+| `has_frontend` | `true` なら `frontend-seed` が並走していることを確認 |
 | `folder_structure` | `maps_to` パスの基準として参照する |
 
 設計フェーズで新たな方針・コンポーネントが確定したら、都度 architecture.yaml を最新状態に保つ。
@@ -30,6 +30,7 @@ Phase 5: TDD → 実装
 ## 前提ルール
 
 - docs は正本とし、各ドキュメントに `spec_runner`ヘッダーを付ける
+- バックエンドの設計はすべて `docs/バックエンド/` 配下に置く
 - 詳細設計は `01_ドメイン/` `02_ユースケース/` `03_DB・外部サービス/` の 3 層で構成する
 - ドメインを先に設計し、UC はドメインを参照する形で書く。ドメインの中に UC は入れない
 - `maps_to` は必ず設定する。パス推定に頼らない
@@ -38,20 +39,20 @@ Phase 5: TDD → 実装
 
 ## Phase 1: 要件定義
 
-`architecture-definition` で完了済み。`docs/01_要件定義/` が存在することを確認して次へ進む。
+`architecture-definition` で完了済み。`docs/バックエンド/01_要件定義/` が存在することを確認して次へ進む。
 
 ## Phase 2: 概要設計
 
 ### 2-1. ユースケース一覧
 
 1. 要件定義からユースケースを洗い出す（Query / Command を意識）
-2. `docs/02_概要設計/ユースケース一覧.md` を作る
+2. `docs/バックエンド/02_概要設計/ユースケース一覧.md` を作る
 3. ユーザーに確認・承認を得る
 
 ### 2-2. ドメインモデル + システム全体俯瞰
 
-1. UC から集約・境界コンテキストを整理し `docs/02_概要設計/ドメインモデル.md` を作る
-2. コンポーネント全体図・外部 IF を整理し `docs/02_概要設計/システム全体俯瞰.md` を作る
+1. UC から集約・境界コンテキストを整理し `docs/バックエンド/02_概要設計/ドメインモデル.md` を作る
+2. コンポーネント全体図・外部 IF を整理し `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
 3. ユーザーに確認・承認を得る
 
 ### 出力
@@ -59,7 +60,7 @@ Phase 5: TDD → 実装
 テンプレート: `templates/02_概要設計/ユースケース一覧.md` / `templates/02_概要設計/ドメインモデル.md` / `templates/02_概要設計/システム全体俯瞰.md`
 
 ```
-docs/02_概要設計/
+docs/バックエンド/02_概要設計/
   ユースケース一覧.md
   ドメインモデル.md
   システム全体俯瞰.md
@@ -94,7 +95,7 @@ docs/02_概要設計/
 テンプレート: `templates/03_詳細設計/01_ドメイン/{ドメイン名}.md`
 
 ```
-docs/03_詳細設計/01_ドメイン/
+docs/バックエンド/03_詳細設計/01_ドメイン/
   {ドメイン名}.md
 ```
 
@@ -104,17 +105,15 @@ docs/03_詳細設計/01_ドメイン/
 
 テンプレート: `templates/03_詳細設計/02_ユースケース/UC-{日本語名}.md`
 
-> `has_frontend: true` の場合は各 UC ファイルに「画面レイアウト」セクションを含める。`false` なら削除する。
-
 ```
-docs/03_詳細設計/02_ユースケース/
+docs/バックエンド/03_詳細設計/02_ユースケース/
   UC-{日本語名}.md
 ```
 
 ### 4-3. DB・外部サービス（必要時のみ）
 
 ```
-docs/03_詳細設計/03_DB・外部サービス/
+docs/バックエンド/03_詳細設計/03_DB・外部サービス/
   スキーマ定義.dbml
   外部サービス.md
 ```

package/spec-runner/templates/.claude/skills/ddd-seed/templates/01_/350/246/201/344/273/266/345/256/232/347/276/251//343/203/246/343/203/223/343/202/255/343/202/277/343/202/271/350/250/200/350/252/236/350/276/236/346/233/270.md

@@ -5,7 +5,7 @@ spec_runner:
   depends_on:
     - requirement.要件定義
   maps_to:
-    - docs/03_詳細設計/01_ドメイン/
+    - docs/バックエンド/03_詳細設計/01_ドメイン/
 ---
 
 # ユビキタス言語辞書

package/spec-runner/templates/.claude/skills/ddd-seed/templates/01_/350/246/201/344/273/266/345/256/232/347/276/251//350/246/201/344/273/266/345/256/232/347/276/251.md

@@ -4,7 +4,7 @@ spec_runner:
   kind: requirement
   depends_on: []
   maps_to:
-    - docs/02_概要設計/
+    - docs/バックエンド/02_概要設計/
 ---
 
 # 要件定義

package/spec-runner/templates/.claude/skills/ddd-seed/templates/02_/346/246/202/350/246/201/350/250/255/350/250/210//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253.md

@@ -5,7 +5,7 @@ spec_runner:
   depends_on:
     - overview.use_case_list
   maps_to:
-    - docs/03_詳細設計/01_ドメイン/
+    - docs/バックエンド/03_詳細設計/01_ドメイン/
 ---
 
 # ドメインモデル

package/spec-runner/templates/.claude/skills/ddd-seed/templates/02_/346/246/202/350/246/201/350/250/255/350/250/210//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/270/200/350/246/247.md

@@ -5,7 +5,7 @@ spec_runner:
   depends_on:
     - requirement.要件定義
   maps_to:
-    - docs/03_詳細設計/02_ユースケース/
+    - docs/バックエンド/03_詳細設計/02_ユースケース/
 ---
 
 # ユースケース一覧

package/spec-runner/templates/.claude/skills/ddd-seed/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210/02_/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/UC-{/346/227/245/346/234/254/350/252/236/345/220/215}.md

@@ -48,21 +48,6 @@ sequenceDiagram
 |------------|---------|------|
 | {エラーケース} | {発生条件} | {対応} |
 
-## 画面レイアウト
-
-> `has_frontend: true` のときのみ記載する。不要なら削除する。
-
-- 画面名: {画面名}
-- 遷移元: {前の画面 or -}
-- 遷移先: {次の画面 or -}
-
-```
-{画面レイアウト概要 — ASCII art / Markdown テーブルで表現}
-```
-
-- 主要 UI 要素:
-  - {入力フォーム・ボタン・一覧表示など}
-
 ## テスト観点
 
 - {正常系の観点}