spec-runner 1.6.0 → 1.8.0

package/spec-runner/templates/.github/skills/existing-project-to-docs/SKILL.md

@@ -23,6 +23,8 @@ Phase 5: architecture contract 化
 - 既存コードを正として観測する。推測する場合は明示する
 - `depends_on` を使って後続変更に耐える形へ整える
 - ユーザー承認なしに次フェーズへ進めない
+- バックエンドの設計はすべて `docs/バックエンド/` 配下に置く
+- `has_frontend: true` の場合、フロントエンドの設計は `docs/フロントエンド/` 配下に置く
 - `style: ddd` の場合: UC がドメインを使う。ドメインの中に UC を入れない
 - `style: ddd` の場合: 詳細設計は `01_ドメイン/` `02_ユースケース/` `03_DB・外部サービス/` の 3 層で構成する
 - `style: layered` の場合: ドメイン層は持たない。ビジネスロジックは UC / サービス層で表現する
@@ -32,8 +34,9 @@ Phase 5: architecture contract 化
 
 1. `src/`、`tests/`、設定ファイル、README、IaC を読む
 2. 現状システムの入口、主要フロー、外部依存を一覧化する
-3. `.spec-runner/intake/current-system-inventory.md` を作る
-4. ユーザーに確認・承認を得る
+3. フロントエンドの有無（Web UI・画面があるか）を判定する
+4. `.spec-runner/intake/current-system-inventory.md` を作る
+5. ユーザーに確認・承認を得る
 
 ## Phase 1.5: docs 構成の合意
 
@@ -41,34 +44,44 @@ Phase 5: architecture contract 化
 
 1. `current-system-inventory.md` を元に以下を提案する
    - `style`（`ddd` / `layered`）
-   - `docs/` のフォルダ構成
+   - `has_frontend`（`true` / `false`）
+   - `docs/` のフォルダ構成（`バックエンド/` + 必要なら `フロントエンド/`）
    - 作成予定ファイルの一覧
 2. ユーザーに確認・承認を得る
-3. 承認後、`.spec-runner/architecture/architecture.yaml` を新規作成し `style` だけ先に書き込む（残りは Phase 5 で完成させる）
+3. 承認後、`.spec-runner/architecture/architecture.yaml` を新規作成し `style` と `has_frontend` だけ先に書き込む（残りは Phase 5 で完成させる）
 
 ## Phase 2: 要件とユースケースの抽出
 
 要件定義テンプレートは `simple-seed` に存在しないため、`style` に関わらず `ddd-seed` のテンプレートを使う。
 
 1. `current-system-inventory.md` を起点に、既存機能からユースケースを逆算する
-2. `.claude/skills/ddd-seed/templates/01_要件定義/要件定義.md` を使い `docs/01_要件定義/要件定義.md` を作る
-3. `.claude/skills/ddd-seed/templates/02_概要設計/ユースケース一覧.md` を使い `docs/02_概要設計/ユースケース一覧.md` を作る
-4. ドメイン用語が識別できたら `.claude/skills/ddd-seed/templates/01_要件定義/ユビキタス言語辞書.md` を使い `docs/01_要件定義/ユビキタス言語辞書.md` を作る
-5. ユーザーに確認・承認を得る
+2. `.claude/skills/ddd-seed/templates/01_要件定義/要件定義.md` を使い `docs/バックエンド/01_要件定義/要件定義.md` を作る
+3. `.claude/skills/ddd-seed/templates/02_概要設計/ユースケース一覧.md` を使い `docs/バックエンド/02_概要設計/ユースケース一覧.md` を作る
+4. ドメイン用語が識別できたら `.claude/skills/ddd-seed/templates/01_要件定義/ユビキタス言語辞書.md` を使い `docs/バックエンド/01_要件定義/ユビキタス言語辞書.md` を作る
+5. `has_frontend: true` の場合: `.claude/skills/frontend-seed/templates/01_要件定義/要件定義.md` を使い `docs/フロントエンド/01_要件定義/要件定義.md` も作る
+6. ユーザーに確認・承認を得る
 
 ## Phase 3: 概要設計
 
+### バックエンド
+
 `style: ddd` の場合:
 
-1. `.claude/skills/ddd-seed/templates/02_概要設計/システム全体俯瞰.md` を使い `docs/02_概要設計/システム全体俯瞰.md` を作る
-2. `.claude/skills/ddd-seed/templates/02_概要設計/ドメインモデル.md` を使い `docs/02_概要設計/ドメインモデル.md` を作る
+1. `.claude/skills/ddd-seed/templates/02_概要設計/システム全体俯瞰.md` を使い `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
+2. `.claude/skills/ddd-seed/templates/02_概要設計/ドメインモデル.md` を使い `docs/バックエンド/02_概要設計/ドメインモデル.md` を作る
 3. 必要なら ADR を作る（作成ルールは下記）
 
 `style: layered` の場合:
 
-1. `.claude/skills/simple-seed/templates/02_概要設計/システム全体俯瞰.md` を使い `docs/02_概要設計/システム全体俯瞰.md` を作る
+1. `.claude/skills/simple-seed/templates/02_概要設計/システム全体俯瞰.md` を使い `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
 2. 必要なら ADR を作る（作成ルールは下記）
 
+### フロントエンド（has_frontend: true のみ）
+
+1. `.claude/skills/frontend-seed/templates/02_概要設計/画面一覧.md` を使い `docs/フロントエンド/02_概要設計/画面一覧.md` を作る
+2. `.claude/skills/frontend-seed/templates/02_概要設計/画面遷移図.md` を使い `docs/フロントエンド/02_概要設計/画面遷移図.md` を作る
+3. `.claude/skills/frontend-seed/templates/02_概要設計/コンポーネント一覧.md` を使い `docs/フロントエンド/02_概要設計/コンポーネント一覧.md` を作る
+
 ### ADR 作成ルール（必要時のみ）
 
 1. 提案時に必ず 3 案を比較する。ドキュメントには採用案と採用理由のみ記録する
@@ -78,18 +91,20 @@ Phase 5: architecture contract 化
 
 | 対象 | 配置先 |
 |------|--------|
-| システム横断の決定 | `90_ADR/全体/` |
-| ドメイン設計の決定 | `90_ADR/ドメイン/` |
-| UC フローの決定 | `90_ADR/UC/` |
-| DB・外部サービスの決定 | `90_ADR/DB/` |
+| システム横断の決定 | `docs/バックエンド/02_概要設計/90_ADR/全体/` |
+| ドメイン設計の決定 | `docs/バックエンド/02_概要設計/90_ADR/ドメイン/` |
+| UC フローの決定 | `docs/バックエンド/02_概要設計/90_ADR/UC/` |
+| DB・外部サービスの決定 | `docs/バックエンド/02_概要設計/90_ADR/DB/` |
+| フロントエンドの決定 | `docs/フロントエンド/02_概要設計/90_ADR/` |
 
 `style: layered` の場合:
 
 | 対象 | 配置先 |
 |------|--------|
-| システム横断の決定 | `90_ADR/全体/` |
-| UC フローの決定 | `90_ADR/UC/` |
-| DB・外部サービスの決定 | `90_ADR/DB/` |
+| システム横断の決定 | `docs/バックエンド/02_概要設計/90_ADR/全体/` |
+| UC フローの決定 | `docs/バックエンド/02_概要設計/90_ADR/UC/` |
+| DB・外部サービスの決定 | `docs/バックエンド/02_概要設計/90_ADR/DB/` |
+| フロントエンドの決定 | `docs/フロントエンド/02_概要設計/90_ADR/` |
 
 3. 採用案を概要設計へ反映してから次へ進む
 
@@ -97,16 +112,23 @@ Phase 5: architecture contract 化
 
 ## Phase 4: 詳細設計
 
+### バックエンド
+
 `style: ddd` の場合（ドメイン → UC → DB・外部サービス の順に設計する）:
 
-1. `.claude/skills/ddd-seed/templates/03_詳細設計/01_ドメイン/{ドメイン名}.md` を使い、ドメインごとにビジネスルール・集約を整理し `docs/03_詳細設計/01_ドメイン/{ドメイン名}.md` を作る
-2. `.claude/skills/ddd-seed/templates/03_詳細設計/02_ユースケース/UC-{日本語名}.md` を使い、UC ごとに `docs/03_詳細設計/02_ユースケース/UC-{日本語名}.md` を作る（シーケンス図は Mermaid で埋め込む）
-3. DB・外部サービスの仕様が必要なら `docs/03_詳細設計/03_DB・外部サービス/` を作る
+1. `.claude/skills/ddd-seed/templates/03_詳細設計/01_ドメイン/{ドメイン名}.md` を使い、ドメインごとにビジネスルール・集約を整理し `docs/バックエンド/03_詳細設計/01_ドメイン/{ドメイン名}.md` を作る
+2. `.claude/skills/ddd-seed/templates/03_詳細設計/02_ユースケース/UC-{日本語名}.md` を使い、UC ごとに `docs/バックエンド/03_詳細設計/02_ユースケース/UC-{日本語名}.md` を作る（シーケンス図は Mermaid で埋め込む）
+3. DB・外部サービスの仕様が必要なら `docs/バックエンド/03_詳細設計/03_DB・外部サービス/` を作る
 
 `style: layered` の場合（UC → DB・外部サービス の順に設計する）:
 
-1. `.claude/skills/simple-seed/templates/03_詳細設計/01_ユースケース/UC-{日本語名}.md` を使い、UC ごとに `docs/03_詳細設計/01_ユースケース/UC-{日本語名}.md` を作る
-2. DB・外部サービスの仕様が必要なら `docs/03_詳細設計/02_DB・外部サービス/` を作る
+1. `.claude/skills/simple-seed/templates/03_詳細設計/01_ユースケース/UC-{日本語名}.md` を使い、UC ごとに `docs/バックエンド/03_詳細設計/01_ユースケース/UC-{日本語名}.md` を作る
+2. DB・外部サービスの仕様が必要なら `docs/バックエンド/03_詳細設計/02_DB・外部サービス/` を作る
+
+### フロントエンド（has_frontend: true のみ）
+
+1. `.claude/skills/frontend-seed/templates/03_詳細設計/01_画面/{カテゴリ名}/{画面名}.md` を使い、カテゴリごとに画面 MD を `docs/フロントエンド/03_詳細設計/01_画面/` に作る
+2. `.claude/skills/frontend-seed/templates/03_詳細設計/02_コンポーネント/{コンポーネント名}.md` を使い、共通コンポーネントを `docs/フロントエンド/03_詳細設計/02_コンポーネント/` に作る
 
 各ファイルの `maps_to` に対応コードとテストを必ず入れる。ユーザーに確認・承認を得る。
 
@@ -115,4 +137,3 @@ Phase 5: architecture contract 化
 1. `.spec-runner/architecture/architecture.yaml` を完成させる
 2. 現状構造を project 専用 skill へ渡せる粒度に整える
 3. `architecture-skill-development` へ引き渡す
-

package/spec-runner/templates/.github/skills/frontend-seed/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: frontend-seed
+description: フロントエンド向け docs 正本開発フローの種。画面・コンポーネント設計を中心に、要件定義から詳細設計まで進める。architecture-skill-development でプロジェクト専用スキルに育てる。
+---
+
+# frontend-seed
+
+## 前提: architecture.yaml の読み込み
+
+開始前に `.spec-runner/architecture/architecture.yaml` を読み、以下を確認する:
+
+| キー | 用途 |
+|------|------|
+| `has_frontend` | `true` であることを確認 |
+| `folder_structure` | `maps_to` パスの基準として参照する |
+
+設計フェーズで新たな方針・コンポーネントが確定したら、都度 architecture.yaml を最新状態に保つ。
+
+## 全体フロー
+
+```
+Phase 1: 要件定義
+Phase 2: 概要設計（画面一覧 + 画面遷移図 + コンポーネント一覧）
+Phase 3: ADR（必要時のみ）
+Phase 4: 詳細設計（画面 → コンポーネント）
+Phase 5: TDD → 実装
+```
+
+## 前提ルール
+
+- docs は正本とし、各ドキュメントに `spec_runner` ヘッダーを付ける
+- 詳細設計は `01_画面/` `02_コンポーネント/` の 2 層で構成する
+- 画面を先に設計し、コンポーネントは画面を参照する形で書く
+- `maps_to` は必ず設定する。パス推定に頼らない
+- ユーザー承認なしに次フェーズへ進めない
+
+## Phase 1: 要件定義
+
+`architecture-definition` で完了済み。`docs/フロントエンド/01_要件定義/` が存在することを確認して次へ進む。
+
+存在しない場合はテンプレートから作成し、ユーザーに確認・承認を得る。
+
+テンプレート: `templates/01_要件定義/要件定義.md`
+
+```
+docs/フロントエンド/01_要件定義/
+  要件定義.md
+```
+
+## Phase 2: 概要設計
+
+### 2-1. 画面一覧
+
+1. 要件定義から画面を洗い出す
+2. `docs/フロントエンド/02_概要設計/画面一覧.md` を作る
+3. ユーザーに確認・承認を得る
+
+### 2-2. 画面遷移図
+
+1. 画面一覧をもとに遷移フローを Mermaid で整理する
+2. `docs/フロントエンド/02_概要設計/画面遷移図.md` を作る
+3. ユーザーに確認・承認を得る
+
+### 2-3. コンポーネント一覧
+
+1. 画面一覧から共通コンポーネントを抽出する
+2. `docs/フロントエンド/02_概要設計/コンポーネント一覧.md` を作る
+3. ユーザーに確認・承認を得る
+
+### 出力
+
+テンプレート: `templates/02_概要設計/画面一覧.md` / `templates/02_概要設計/画面遷移図.md` / `templates/02_概要設計/コンポーネント一覧.md`
+
+```
+docs/フロントエンド/02_概要設計/
+  画面一覧.md
+  画面遷移図.md
+  コンポーネント一覧.md
+  90_ADR/
+```
+
+## Phase 3: ADR（必要時のみ）
+
+1. 設計判断が必要な場合だけ ADR を作る
+2. 提案時に必ず 3 案を比較する。ドキュメントには採用案と採用理由のみ記録する
+3. ファイル名は `mmdd-{日本語タイトル}.md`、配置先は `90_ADR/`
+
+4. 採用案を概要設計へ反映してから次へ進む
+
+## Phase 4: 詳細設計
+
+画面 → コンポーネント の順に設計する。
+
+### 4-1. 画面
+
+カテゴリ（機能ドメイン）でディレクトリを切り、画面ごとに 1 ファイル作成する。
+
+テンプレート: `templates/03_詳細設計/01_画面/{カテゴリ名}/{画面名}.md`
+
+```
+docs/フロントエンド/03_詳細設計/01_画面/
+  {カテゴリ名}/
+    {画面名}.md
+```
+
+### 4-2. コンポーネント
+
+概要設計のコンポーネント一覧をもとに、共通コンポーネントごとに 1 ファイル作成する。
+
+テンプレート: `templates/03_詳細設計/02_コンポーネント/{コンポーネント名}.md`
+
+```
+docs/フロントエンド/03_詳細設計/02_コンポーネント/
+  {コンポーネント名}.md
+```
+
+ユーザーに確認・承認を得る。
+
+## Phase 5: TDD → 実装
+
+`test-driven-development` スキルへ移行する。

package/spec-runner/templates/.github/skills/frontend-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

@@ -0,0 +1,35 @@
+---
+spec_runner:
+  node_id: frontend.requirement.要件定義
+  kind: requirement
+  depends_on: []
+  maps_to:
+    - docs/フロントエンド/02_概要設計/
+---
+
+# 要件定義
+
+## 解決すべき課題・提供価値
+
+- {課題}
+- {提供価値}
+
+## 対象ユーザー
+
+- {ユーザー種別}: {説明}
+
+## 非機能要件
+
+| 項目 | 内容 |
+|------|------|
+| {パフォーマンス} | {要件} |
+| {アクセシビリティ} | {要件} |
+| {対応デバイス} | {要件} |
+
+## スコープ外
+
+- {スコープ外の機能・画面}
+
+## 技術・ビジネス制約
+
+- {制約}

package/spec-runner/templates/.github/skills/frontend-seed/templates/02_/346/246/202/350/246/201/350/250/255/350/250/210//343/202/263/343/203/263/343/203/235/343/203/274/343/203/215/343/203/263/343/203/210/344/270/200/350/246/247.md

@@ -0,0 +1,19 @@
+---
+spec_runner:
+  node_id: frontend.overview.コンポーネント一覧
+  kind: overview_design
+  depends_on:
+    - frontend.overview.画面一覧
+  maps_to:
+    - docs/フロントエンド/03_詳細設計/02_コンポーネント/
+---
+
+# コンポーネント一覧
+
+<!-- 共通コンポーネントのみ記載。画面固有のものは各画面MDで管理する -->
+
+## {カテゴリ名}（例: フォーム、ナビゲーション、フィードバック）
+
+| コンポーネントID | コンポーネント名 | 概要 | 使用画面 |
+|----------------|----------------|------|---------|
+| CMP-{番号} | {コンポーネント名} | {概要} | {画面名}, {画面名} |

package/spec-runner/templates/.github/skills/frontend-seed/templates/02_/346/246/202/350/246/201/350/250/255/350/250/210//347/224/273/351/235/242/344/270/200/350/246/247.md

@@ -0,0 +1,25 @@
+---
+spec_runner:
+  node_id: frontend.overview.画面一覧
+  kind: overview_design
+  depends_on:
+    - frontend.requirement.要件定義
+  maps_to:
+    - docs/フロントエンド/03_詳細設計/01_画面/
+---
+
+# 画面一覧
+
+<!-- カテゴリは機能領域で分ける。例: 認証、ダッシュボード、設定 など -->
+
+## {カテゴリ名}
+
+| 画面ID | 画面名 | URL | 概要 |
+|--------|--------|-----|------|
+| SCR-{番号} | {画面名} | /{path} | {概要} |
+
+## {カテゴリ名}
+
+| 画面ID | 画面名 | URL | 概要 |
+|--------|--------|-----|------|
+| SCR-{番号} | {画面名} | /{path} | {概要} |

package/spec-runner/templates/.github/skills/frontend-seed/templates/02_/346/246/202/350/246/201/350/250/255/350/250/210//347/224/273/351/235/242/351/201/267/347/247/273/345/233/263.md

@@ -0,0 +1,23 @@
+---
+spec_runner:
+  node_id: frontend.overview.画面遷移図
+  kind: overview_design
+  depends_on:
+    - frontend.overview.画面一覧
+  maps_to:
+    - docs/フロントエンド/03_詳細設計/01_画面/
+---
+
+# 画面遷移図
+
+```mermaid
+flowchart TD
+  {画面A}([{画面名}]) -->|{操作}| {画面B}([{画面名}])
+  {画面B} -->|{操作}| {画面C}([{画面名}])
+```
+
+## 遷移説明
+
+| 遷移元 | 操作 | 遷移先 | 条件 |
+|--------|------|--------|------|
+| {画面名} | {操作} | {画面名} | {条件} |

package/spec-runner/templates/.github/skills/frontend-seed/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210/01_/347/224/273/351/235/242/{/343/202/253/343/203/206/343/202/264/343/203/252/345/220/215}/{/347/224/273/351/235/242/345/220/215}.md

@@ -0,0 +1,65 @@
+---
+spec_runner:
+  node_id: frontend.detail.画面.{画面名}
+  kind: detailed_design
+  depends_on:
+    - frontend.overview.画面一覧
+    - frontend.overview.画面遷移図
+  maps_to:
+    - src/app/{path}/page.tsx
+---
+
+# {画面名}
+
+## 概要
+
+- **画面ID**: SCR-{番号}
+- **URL**: /{path}
+- **目的**: {この画面が達成すること}
+
+## レイアウト
+
+```
++---------------------------+
+| {ヘッダー}                |
++---------------------------+
+| {メインコンテンツ}         |
+|                           |
++---------------------------+
+| {フッター}                |
++---------------------------+
+```
+
+## 表示要素
+
+| 要素 | 種別 | 概要 |
+|------|------|------|
+| {要素名} | テキスト / ボタン / フォーム / リスト | {概要} |
+
+## 使用コンポーネント
+
+| コンポーネント | 用途 |
+|--------------|------|
+| CMP-{番号} {コンポーネント名} | {用途} |
+
+## インタラクション
+
+| 操作 | 処理 | 遷移先 |
+|------|------|--------|
+| {操作} | {処理内容} | {画面名} / なし |
+
+## API連携
+
+| API | 呼び出しタイミング | 概要 |
+|-----|-----------------|------|
+| {エンドポイント} | {タイミング} | {概要} |
+
+## バリデーション
+
+- {バリデーションルール}
+
+## テスト観点
+
+- {正常系の観点}
+- {エラー表示の観点}
+- {権限・認証の観点}

package/spec-runner/templates/.github/skills/frontend-seed/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210/02_/343/202/263/343/203/263/343/203/235/343/203/274/343/203/215/343/203/263/343/203/210/{/343/202/263/343/203/263/343/203/235/343/203/274/343/203/215/343/203/263/343/203/210/345/220/215}.md

@@ -0,0 +1,41 @@
+---
+spec_runner:
+  node_id: frontend.detail.component.{コンポーネント名}
+  kind: detailed_design
+  depends_on:
+    - frontend.overview.コンポーネント一覧
+  maps_to:
+    - src/components/{コンポーネント名}/
+---
+
+# {コンポーネント名}
+
+## 概要
+
+- **コンポーネントID**: CMP-{番号}
+- **目的**: {このコンポーネントが提供する UI・機能}
+- **使用画面**: {画面名}, {画面名}
+
+## Props
+
+| Prop名 | 型 | 必須 | デフォルト | 概要 |
+|--------|-----|------|-----------|------|
+| {prop名} | {型} | ○ / - | {値} | {概要} |
+
+## 表示パターン
+
+| パターン | 条件 | 表示内容 |
+|---------|------|---------|
+| {パターン名} | {条件} | {表示内容} |
+
+## イベント
+
+| イベント | 発火条件 | コールバック |
+|---------|---------|------------|
+| {イベント名} | {条件} | {コールバック名} |
+
+## テスト観点
+
+- {正常表示の観点}
+- {各パターンの観点}
+- {アクセシビリティの観点}

package/spec-runner/templates/.github/skills/frontend-seed/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210/90_ADR/ADR-{/346/227/245/346/234/254/350/252/236/345/220/215}.md

@@ -0,0 +1,46 @@
+---
+spec_runner:
+  node_id: frontend.adr.{decision_slug}
+  kind: adr
+---
+
+# {決定内容のタイトル}
+
+**ステータス**: 提案 / 採用 / 廃止 / 置換
+**日付**: YYYY-MM-DD
+**決定者**: {名前}
+
+## コンテキスト
+
+| 項目 | 内容 |
+|------|------|
+| 現在の状況 | {問題・課題} |
+| 要件 | {実現する必要があること} |
+| 制約 | {技術的・ビジネス的制約} |
+
+## 決定
+
+**採用案**: {案名}
+
+### 採用理由
+
+- {理由1}
+- {理由2}
+
+### 実装方針
+
+1. {方針1}
+2. {方針2}
+
+## 影響
+
+| カテゴリ | 項目 | 内容 |
+|----------|------|------|
+| UI | 新規追加 | {コンポーネント / 画面} |
+| UI | 変更 | {コンポーネント / 画面} |
+| 制約 | 将来課題 | {課題} |
+
+### 反映が必要な文書
+
+- `docs/フロントエンド/02_概要設計/{対象文書}.md`
+- `docs/フロントエンド/03_詳細設計/{対象パス}.md`

package/spec-runner/templates/.github/skills/simple-seed/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: simple-seed
-description: レイヤードアーキテクチャ / CRUD 中心のプロジェクト向け docs 正本開発フロー。ドメイン層を持たず UC・サービス層で設計する。architecture.yaml の style: layered のときに使う。
+description: レイヤードアーキテクチャ / CRUD 中心のプロジェクト向け docs 正本開発フロー（バックエンド担当）。ドメイン層を持たず UC・サービス層で設計する。architecture.yaml の style: layered のときに使う。
 ---
 
 # simple-seed
@@ -12,7 +12,7 @@ description: レイヤードアーキテクチャ / CRUD 中心のプロジェ
 | キー | 用途 |
 |------|------|
 | `style` | このスキル（`layered`）が適切かを確認 |
-| `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_DB・外部サービス/` の 2 層で構成する
 - `maps_to` は必ず設定する。パス推定に頼らない
 - 実装ファイルのパスは UC ドキュメント本文に書かない。`maps_to` ヘッダーで管理する
@@ -37,21 +38,21 @@ Phase 5: TDD → 実装
 
 ## Phase 1: 要件定義
 
-`architecture-definition` で完了済み。`docs/01_要件定義/` が存在することを確認して次へ進む。
+`architecture-definition` で完了済み。`docs/バックエンド/01_要件定義/` が存在することを確認して次へ進む。
 
 ## Phase 2: 概要設計
 
 テンプレート: `templates/02_概要設計/`
 
 1. 要件定義からユースケースを洗い出す（Query / Command を意識）
-2. テンプレートをコピーして `docs/02_概要設計/ユースケース一覧.md` を作る
-3. コンポーネント全体図・外部 IF を整理し `docs/02_概要設計/システム全体俯瞰.md` を作る
+2. テンプレートをコピーして `docs/バックエンド/02_概要設計/ユースケース一覧.md` を作る
+3. コンポーネント全体図・外部 IF を整理し `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
 4. ユーザーに確認・承認を得る
 
 ### 出力
 
 ```
-docs/02_概要設計/
+docs/バックエンド/02_概要設計/
   ユースケース一覧.md
   システム全体俯瞰.md
   90_ADR/
@@ -82,17 +83,15 @@ UC → DB・外部サービス の順に設計する。
 
 テンプレート: `templates/03_詳細設計/01_ユースケース/UC-{日本語名}.md`
 
-> `has_frontend: true` の場合は各 UC ファイルに「画面レイアウト」セクションを含める。`false` なら削除する。
-
 ```
-docs/03_詳細設計/01_ユースケース/
+docs/バックエンド/03_詳細設計/01_ユースケース/
   UC-{日本語名}.md
 ```
 
 ### 4-2. DB・外部サービス（必要時のみ）
 
 ```
-docs/03_詳細設計/02_DB・外部サービス/
+docs/バックエンド/03_詳細設計/02_DB・外部サービス/
   スキーマ定義.dbml
   外部サービス.md
 ```

package/spec-runner/templates/.spec-runner/references/resources.md

@@ -0,0 +1,46 @@
+# Resources
+
+エラーや調査が必要なときにサブエージェントが参照する外部リソース一覧。
+`architecture-skill-development` 実行時に登録する。
+
+## 言語・ランタイム
+
+| 名前 | URL |
+|------|-----|
+| {言語名} | {公式ドキュメントURL} |
+
+## フレームワーク・ライブラリ
+
+| 名前 | URL |
+|------|-----|
+| {フレームワーク名} | {公式ドキュメントURL} |
+
+## インフラ・ツール
+
+| 名前 | URL |
+|------|-----|
+| {ツール名} | {公式ドキュメントURL} |
+
+## サンプル・リファレンス実装
+
+| 名前 | URL |
+|------|-----|
+| {リポジトリ名} | {URL} |
+
+## API 仕様
+
+| 名前 | URL |
+|------|-----|
+| {API名} | {URL} |
+
+## 社内ドキュメント・Wiki
+
+| 名前 | URL |
+|------|-----|
+| {ドキュメント名} | {URL} |
+
+## その他（移行ガイド・ベストプラクティス記事など）
+
+| 名前 | URL |
+|------|-----|
+| {タイトル} | {URL} |