spec-runner 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/package.json +1 -1
  2. package/spec-runner/templates/.claude/rules/design-docs.md +34 -26
  3. package/spec-runner/templates/.claude/skills/architecture-definition/SKILL.md +12 -4
  4. package/spec-runner/templates/.claude/skills/architecture-skill-development/SKILL.md +18 -11
  5. package/spec-runner/templates/.claude/skills/ddd-seed/SKILL.md +11 -12
  6. 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 +1 -1
  7. 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 +1 -1
  8. 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 +1 -1
  9. 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 +1 -1
  10. 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 +0 -15
  11. package/spec-runner/templates/.claude/skills/design-change/SKILL.md +35 -20
  12. package/spec-runner/templates/.claude/skills/existing-project-to-docs/SKILL.md +45 -24
  13. package/spec-runner/templates/.claude/skills/frontend-seed/SKILL.md +121 -0
  14. package/spec-runner/templates/.claude/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 +35 -0
  15. package/spec-runner/templates/.claude/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 +19 -0
  16. package/spec-runner/templates/.claude/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 +25 -0
  17. package/spec-runner/templates/.claude/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 +23 -0
  18. package/spec-runner/templates/.claude/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 +65 -0
  19. package/spec-runner/templates/.claude/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 +41 -0
  20. package/spec-runner/templates/.claude/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 +46 -0
  21. package/spec-runner/templates/.claude/skills/simple-seed/SKILL.md +9 -10
  22. package/spec-runner/templates/.claude/skills/simple-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 +1 -1
  23. package/spec-runner/templates/.claude/skills/simple-seed/templates/03_/350/251/263/347/264/260/350/250/255/350/250/210/01_/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 +0 -15
  24. package/spec-runner/templates/.github/instructions/design-docs.instructions.md +33 -25
  25. package/spec-runner/templates/.github/skills/architecture-definition/SKILL.md +12 -4
  26. package/spec-runner/templates/.github/skills/architecture-skill-development/SKILL.md +18 -11
  27. package/spec-runner/templates/.github/skills/ddd-seed/SKILL.md +11 -12
  28. package/spec-runner/templates/.github/skills/design-change/SKILL.md +35 -20
  29. package/spec-runner/templates/.github/skills/existing-project-to-docs/SKILL.md +45 -24
  30. package/spec-runner/templates/.github/skills/frontend-seed/SKILL.md +121 -0
  31. 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 +35 -0
  32. 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 +19 -0
  33. 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 +25 -0
  34. 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 +23 -0
  35. 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 +65 -0
  36. 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 +41 -0
  37. 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 +46 -0
  38. package/spec-runner/templates/.github/skills/simple-seed/SKILL.md +9 -10
  39. package/spec-runner/templates/.claude/skills/design-change/references//345/275/261/351/237/277/347/257/204/345/233/262/343/203/201/343/202/247/343/203/203/343/202/257/343/203/252/343/202/271/343/203/210.md +0 -59
  40. package/spec-runner/templates/.claude/skills/spec-probe/SKILL.md +0 -12
  41. package/spec-runner/templates/.github/skills/design-change/references//345/275/261/351/237/277/347/257/204/345/233/262/343/203/201/343/202/247/343/203/203/343/202/257/343/203/252/343/202/271/343/203/210.md +0 -59
  42. package/spec-runner/templates/.github/skills/spec-probe/SKILL.md +0 -12
@@ -0,0 +1,121 @@
1
+ ---
2
+ name: frontend-seed
3
+ description: フロントエンド向け docs 正本開発フローの種。画面・コンポーネント設計を中心に、要件定義から詳細設計まで進める。architecture-skill-development でプロジェクト専用スキルに育てる。
4
+ ---
5
+
6
+ # frontend-seed
7
+
8
+ ## 前提: architecture.yaml の読み込み
9
+
10
+ 開始前に `.spec-runner/architecture/architecture.yaml` を読み、以下を確認する:
11
+
12
+ | キー | 用途 |
13
+ |------|------|
14
+ | `has_frontend` | `true` であることを確認 |
15
+ | `folder_structure` | `maps_to` パスの基準として参照する |
16
+
17
+ 設計フェーズで新たな方針・コンポーネントが確定したら、都度 architecture.yaml を最新状態に保つ。
18
+
19
+ ## 全体フロー
20
+
21
+ ```
22
+ Phase 1: 要件定義
23
+ Phase 2: 概要設計(画面一覧 + 画面遷移図 + コンポーネント一覧)
24
+ Phase 3: ADR(必要時のみ)
25
+ Phase 4: 詳細設計(画面 → コンポーネント)
26
+ Phase 5: TDD → 実装
27
+ ```
28
+
29
+ ## 前提ルール
30
+
31
+ - docs は正本とし、各ドキュメントに `spec_runner` ヘッダーを付ける
32
+ - 詳細設計は `01_画面/` `02_コンポーネント/` の 2 層で構成する
33
+ - 画面を先に設計し、コンポーネントは画面を参照する形で書く
34
+ - `maps_to` は必ず設定する。パス推定に頼らない
35
+ - ユーザー承認なしに次フェーズへ進めない
36
+
37
+ ## Phase 1: 要件定義
38
+
39
+ `architecture-definition` で完了済み。`docs/フロントエンド/01_要件定義/` が存在することを確認して次へ進む。
40
+
41
+ 存在しない場合はテンプレートから作成し、ユーザーに確認・承認を得る。
42
+
43
+ テンプレート: `templates/01_要件定義/要件定義.md`
44
+
45
+ ```
46
+ docs/フロントエンド/01_要件定義/
47
+ 要件定義.md
48
+ ```
49
+
50
+ ## Phase 2: 概要設計
51
+
52
+ ### 2-1. 画面一覧
53
+
54
+ 1. 要件定義から画面を洗い出す
55
+ 2. `docs/フロントエンド/02_概要設計/画面一覧.md` を作る
56
+ 3. ユーザーに確認・承認を得る
57
+
58
+ ### 2-2. 画面遷移図
59
+
60
+ 1. 画面一覧をもとに遷移フローを Mermaid で整理する
61
+ 2. `docs/フロントエンド/02_概要設計/画面遷移図.md` を作る
62
+ 3. ユーザーに確認・承認を得る
63
+
64
+ ### 2-3. コンポーネント一覧
65
+
66
+ 1. 画面一覧から共通コンポーネントを抽出する
67
+ 2. `docs/フロントエンド/02_概要設計/コンポーネント一覧.md` を作る
68
+ 3. ユーザーに確認・承認を得る
69
+
70
+ ### 出力
71
+
72
+ テンプレート: `templates/02_概要設計/画面一覧.md` / `templates/02_概要設計/画面遷移図.md` / `templates/02_概要設計/コンポーネント一覧.md`
73
+
74
+ ```
75
+ docs/フロントエンド/02_概要設計/
76
+ 画面一覧.md
77
+ 画面遷移図.md
78
+ コンポーネント一覧.md
79
+ 90_ADR/
80
+ ```
81
+
82
+ ## Phase 3: ADR(必要時のみ)
83
+
84
+ 1. 設計判断が必要な場合だけ ADR を作る
85
+ 2. 提案時に必ず 3 案を比較する。ドキュメントには採用案と採用理由のみ記録する
86
+ 3. ファイル名は `mmdd-{日本語タイトル}.md`、配置先は `90_ADR/`
87
+
88
+ 4. 採用案を概要設計へ反映してから次へ進む
89
+
90
+ ## Phase 4: 詳細設計
91
+
92
+ 画面 → コンポーネント の順に設計する。
93
+
94
+ ### 4-1. 画面
95
+
96
+ カテゴリ(機能ドメイン)でディレクトリを切り、画面ごとに 1 ファイル作成する。
97
+
98
+ テンプレート: `templates/03_詳細設計/01_画面/{カテゴリ名}/{画面名}.md`
99
+
100
+ ```
101
+ docs/フロントエンド/03_詳細設計/01_画面/
102
+ {カテゴリ名}/
103
+ {画面名}.md
104
+ ```
105
+
106
+ ### 4-2. コンポーネント
107
+
108
+ 概要設計のコンポーネント一覧をもとに、共通コンポーネントごとに 1 ファイル作成する。
109
+
110
+ テンプレート: `templates/03_詳細設計/02_コンポーネント/{コンポーネント名}.md`
111
+
112
+ ```
113
+ docs/フロントエンド/03_詳細設計/02_コンポーネント/
114
+ {コンポーネント名}.md
115
+ ```
116
+
117
+ ユーザーに確認・承認を得る。
118
+
119
+ ## Phase 5: TDD → 実装
120
+
121
+ `test-driven-development` スキルへ移行する。
@@ -0,0 +1,35 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.requirement.要件定義
4
+ kind: requirement
5
+ depends_on: []
6
+ maps_to:
7
+ - docs/フロントエンド/02_概要設計/
8
+ ---
9
+
10
+ # 要件定義
11
+
12
+ ## 解決すべき課題・提供価値
13
+
14
+ - {課題}
15
+ - {提供価値}
16
+
17
+ ## 対象ユーザー
18
+
19
+ - {ユーザー種別}: {説明}
20
+
21
+ ## 非機能要件
22
+
23
+ | 項目 | 内容 |
24
+ |------|------|
25
+ | {パフォーマンス} | {要件} |
26
+ | {アクセシビリティ} | {要件} |
27
+ | {対応デバイス} | {要件} |
28
+
29
+ ## スコープ外
30
+
31
+ - {スコープ外の機能・画面}
32
+
33
+ ## 技術・ビジネス制約
34
+
35
+ - {制約}
@@ -0,0 +1,19 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.overview.コンポーネント一覧
4
+ kind: overview_design
5
+ depends_on:
6
+ - frontend.overview.画面一覧
7
+ maps_to:
8
+ - docs/フロントエンド/03_詳細設計/02_コンポーネント/
9
+ ---
10
+
11
+ # コンポーネント一覧
12
+
13
+ <!-- 共通コンポーネントのみ記載。画面固有のものは各画面MDで管理する -->
14
+
15
+ ## {カテゴリ名}(例: フォーム、ナビゲーション、フィードバック)
16
+
17
+ | コンポーネントID | コンポーネント名 | 概要 | 使用画面 |
18
+ |----------------|----------------|------|---------|
19
+ | CMP-{番号} | {コンポーネント名} | {概要} | {画面名}, {画面名} |
@@ -0,0 +1,25 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.overview.画面一覧
4
+ kind: overview_design
5
+ depends_on:
6
+ - frontend.requirement.要件定義
7
+ maps_to:
8
+ - docs/フロントエンド/03_詳細設計/01_画面/
9
+ ---
10
+
11
+ # 画面一覧
12
+
13
+ <!-- カテゴリは機能領域で分ける。例: 認証、ダッシュボード、設定 など -->
14
+
15
+ ## {カテゴリ名}
16
+
17
+ | 画面ID | 画面名 | URL | 概要 |
18
+ |--------|--------|-----|------|
19
+ | SCR-{番号} | {画面名} | /{path} | {概要} |
20
+
21
+ ## {カテゴリ名}
22
+
23
+ | 画面ID | 画面名 | URL | 概要 |
24
+ |--------|--------|-----|------|
25
+ | SCR-{番号} | {画面名} | /{path} | {概要} |
@@ -0,0 +1,23 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.overview.画面遷移図
4
+ kind: overview_design
5
+ depends_on:
6
+ - frontend.overview.画面一覧
7
+ maps_to:
8
+ - docs/フロントエンド/03_詳細設計/01_画面/
9
+ ---
10
+
11
+ # 画面遷移図
12
+
13
+ ```mermaid
14
+ flowchart TD
15
+ {画面A}([{画面名}]) -->|{操作}| {画面B}([{画面名}])
16
+ {画面B} -->|{操作}| {画面C}([{画面名}])
17
+ ```
18
+
19
+ ## 遷移説明
20
+
21
+ | 遷移元 | 操作 | 遷移先 | 条件 |
22
+ |--------|------|--------|------|
23
+ | {画面名} | {操作} | {画面名} | {条件} |
@@ -0,0 +1,65 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.detail.画面.{画面名}
4
+ kind: detailed_design
5
+ depends_on:
6
+ - frontend.overview.画面一覧
7
+ - frontend.overview.画面遷移図
8
+ maps_to:
9
+ - src/app/{path}/page.tsx
10
+ ---
11
+
12
+ # {画面名}
13
+
14
+ ## 概要
15
+
16
+ - **画面ID**: SCR-{番号}
17
+ - **URL**: /{path}
18
+ - **目的**: {この画面が達成すること}
19
+
20
+ ## レイアウト
21
+
22
+ ```
23
+ +---------------------------+
24
+ | {ヘッダー} |
25
+ +---------------------------+
26
+ | {メインコンテンツ} |
27
+ | |
28
+ +---------------------------+
29
+ | {フッター} |
30
+ +---------------------------+
31
+ ```
32
+
33
+ ## 表示要素
34
+
35
+ | 要素 | 種別 | 概要 |
36
+ |------|------|------|
37
+ | {要素名} | テキスト / ボタン / フォーム / リスト | {概要} |
38
+
39
+ ## 使用コンポーネント
40
+
41
+ | コンポーネント | 用途 |
42
+ |--------------|------|
43
+ | CMP-{番号} {コンポーネント名} | {用途} |
44
+
45
+ ## インタラクション
46
+
47
+ | 操作 | 処理 | 遷移先 |
48
+ |------|------|--------|
49
+ | {操作} | {処理内容} | {画面名} / なし |
50
+
51
+ ## API連携
52
+
53
+ | API | 呼び出しタイミング | 概要 |
54
+ |-----|-----------------|------|
55
+ | {エンドポイント} | {タイミング} | {概要} |
56
+
57
+ ## バリデーション
58
+
59
+ - {バリデーションルール}
60
+
61
+ ## テスト観点
62
+
63
+ - {正常系の観点}
64
+ - {エラー表示の観点}
65
+ - {権限・認証の観点}
@@ -0,0 +1,41 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.detail.component.{コンポーネント名}
4
+ kind: detailed_design
5
+ depends_on:
6
+ - frontend.overview.コンポーネント一覧
7
+ maps_to:
8
+ - src/components/{コンポーネント名}/
9
+ ---
10
+
11
+ # {コンポーネント名}
12
+
13
+ ## 概要
14
+
15
+ - **コンポーネントID**: CMP-{番号}
16
+ - **目的**: {このコンポーネントが提供する UI・機能}
17
+ - **使用画面**: {画面名}, {画面名}
18
+
19
+ ## Props
20
+
21
+ | Prop名 | 型 | 必須 | デフォルト | 概要 |
22
+ |--------|-----|------|-----------|------|
23
+ | {prop名} | {型} | ○ / - | {値} | {概要} |
24
+
25
+ ## 表示パターン
26
+
27
+ | パターン | 条件 | 表示内容 |
28
+ |---------|------|---------|
29
+ | {パターン名} | {条件} | {表示内容} |
30
+
31
+ ## イベント
32
+
33
+ | イベント | 発火条件 | コールバック |
34
+ |---------|---------|------------|
35
+ | {イベント名} | {条件} | {コールバック名} |
36
+
37
+ ## テスト観点
38
+
39
+ - {正常表示の観点}
40
+ - {各パターンの観点}
41
+ - {アクセシビリティの観点}
@@ -0,0 +1,46 @@
1
+ ---
2
+ spec_runner:
3
+ node_id: frontend.adr.{decision_slug}
4
+ kind: adr
5
+ ---
6
+
7
+ # {決定内容のタイトル}
8
+
9
+ **ステータス**: 提案 / 採用 / 廃止 / 置換
10
+ **日付**: YYYY-MM-DD
11
+ **決定者**: {名前}
12
+
13
+ ## コンテキスト
14
+
15
+ | 項目 | 内容 |
16
+ |------|------|
17
+ | 現在の状況 | {問題・課題} |
18
+ | 要件 | {実現する必要があること} |
19
+ | 制約 | {技術的・ビジネス的制約} |
20
+
21
+ ## 決定
22
+
23
+ **採用案**: {案名}
24
+
25
+ ### 採用理由
26
+
27
+ - {理由1}
28
+ - {理由2}
29
+
30
+ ### 実装方針
31
+
32
+ 1. {方針1}
33
+ 2. {方針2}
34
+
35
+ ## 影響
36
+
37
+ | カテゴリ | 項目 | 内容 |
38
+ |----------|------|------|
39
+ | UI | 新規追加 | {コンポーネント / 画面} |
40
+ | UI | 変更 | {コンポーネント / 画面} |
41
+ | 制約 | 将来課題 | {課題} |
42
+
43
+ ### 反映が必要な文書
44
+
45
+ - `docs/フロントエンド/02_概要設計/{対象文書}.md`
46
+ - `docs/フロントエンド/03_詳細設計/{対象パス}.md`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: simple-seed
3
- description: レイヤードアーキテクチャ / CRUD 中心のプロジェクト向け docs 正本開発フロー。ドメイン層を持たず UC・サービス層で設計する。architecture.yaml の style: layered のときに使う。
3
+ description: レイヤードアーキテクチャ / CRUD 中心のプロジェクト向け docs 正本開発フロー(バックエンド担当)。ドメイン層を持たず UC・サービス層で設計する。architecture.yaml の style: layered のときに使う。
4
4
  ---
5
5
 
6
6
  # simple-seed
@@ -12,7 +12,7 @@ description: レイヤードアーキテクチャ / CRUD 中心のプロジェ
12
12
  | キー | 用途 |
13
13
  |------|------|
14
14
  | `style` | このスキル(`layered`)が適切かを確認 |
15
- | `has_frontend` | `true` なら UC ファイルに「画面レイアウト」セクションを含める |
15
+ | `has_frontend` | `true` なら `frontend-seed` が並走していることを確認 |
16
16
  | `folder_structure` | `maps_to` パスの基準として参照する |
17
17
 
18
18
  設計フェーズで新たな方針・コンポーネントが確定したら、都度 architecture.yaml を最新状態に保つ。
@@ -30,6 +30,7 @@ Phase 5: TDD → 実装
30
30
  ## 前提ルール
31
31
 
32
32
  - docs は正本とし、各ドキュメントに `spec_runner`ヘッダーを付ける
33
+ - バックエンドの設計はすべて `docs/バックエンド/` 配下に置く
33
34
  - 詳細設計は `01_ユースケース/` `02_DB・外部サービス/` の 2 層で構成する
34
35
  - `maps_to` は必ず設定する。パス推定に頼らない
35
36
  - 実装ファイルのパスは UC ドキュメント本文に書かない。`maps_to` ヘッダーで管理する
@@ -37,21 +38,21 @@ Phase 5: TDD → 実装
37
38
 
38
39
  ## Phase 1: 要件定義
39
40
 
40
- `architecture-definition` で完了済み。`docs/01_要件定義/` が存在することを確認して次へ進む。
41
+ `architecture-definition` で完了済み。`docs/バックエンド/01_要件定義/` が存在することを確認して次へ進む。
41
42
 
42
43
  ## Phase 2: 概要設計
43
44
 
44
45
  テンプレート: `templates/02_概要設計/`
45
46
 
46
47
  1. 要件定義からユースケースを洗い出す(Query / Command を意識)
47
- 2. テンプレートをコピーして `docs/02_概要設計/ユースケース一覧.md` を作る
48
- 3. コンポーネント全体図・外部 IF を整理し `docs/02_概要設計/システム全体俯瞰.md` を作る
48
+ 2. テンプレートをコピーして `docs/バックエンド/02_概要設計/ユースケース一覧.md` を作る
49
+ 3. コンポーネント全体図・外部 IF を整理し `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
49
50
  4. ユーザーに確認・承認を得る
50
51
 
51
52
  ### 出力
52
53
 
53
54
  ```
54
- docs/02_概要設計/
55
+ docs/バックエンド/02_概要設計/
55
56
  ユースケース一覧.md
56
57
  システム全体俯瞰.md
57
58
  90_ADR/
@@ -82,17 +83,15 @@ UC → DB・外部サービス の順に設計する。
82
83
 
83
84
  テンプレート: `templates/03_詳細設計/01_ユースケース/UC-{日本語名}.md`
84
85
 
85
- > `has_frontend: true` の場合は各 UC ファイルに「画面レイアウト」セクションを含める。`false` なら削除する。
86
-
87
86
  ```
88
- docs/03_詳細設計/01_ユースケース/
87
+ docs/バックエンド/03_詳細設計/01_ユースケース/
89
88
  UC-{日本語名}.md
90
89
  ```
91
90
 
92
91
  ### 4-2. DB・外部サービス(必要時のみ)
93
92
 
94
93
  ```
95
- docs/03_詳細設計/02_DB・外部サービス/
94
+ docs/バックエンド/03_詳細設計/02_DB・外部サービス/
96
95
  スキーマ定義.dbml
97
96
  外部サービス.md
98
97
  ```
@@ -5,7 +5,7 @@ spec_runner:
5
5
  depends_on:
6
6
  - requirement.要件定義
7
7
  maps_to:
8
- - docs/03_詳細設計/01_ユースケース/
8
+ - docs/バックエンド/03_詳細設計/01_ユースケース/
9
9
  ---
10
10
 
11
11
  # ユースケース一覧
@@ -46,21 +46,6 @@ sequenceDiagram
46
46
  |------------|---------|------|
47
47
  | {エラーケース} | {発生条件} | {対応} |
48
48
 
49
- ## 画面レイアウト
50
-
51
- > `has_frontend: true` のときのみ記載する。不要なら削除する。
52
-
53
- - 画面名: {画面名}
54
- - 遷移元: {前の画面 or -}
55
- - 遷移先: {次の画面 or -}
56
-
57
- ```
58
- {画面レイアウト概要 — ASCII art / Markdown テーブルで表現}
59
- ```
60
-
61
- - 主要 UI 要素:
62
- - {入力フォーム・ボタン・一覧表示など}
63
-
64
49
  ## テスト観点
65
50
 
66
51
  - {正常系の観点}
@@ -4,16 +4,6 @@ applyTo: "docs/**"
4
4
 
5
5
  # 設計書共通ルール
6
6
 
7
- ## フェーズ管理
8
-
9
- - ユーザー承認なしにフェーズを進めない
10
- - フェーズは必ず `要件定義 -> 概要設計 -> 詳細設計 -> TDD -> 実装` の順に進める
11
-
12
- ## テンプレート
13
-
14
- - 設計書は必ずテンプレートをコピーして生成する。独自にゼロから作成しない
15
- - 手順: テンプレートを読む → 出力先へコピーする → プレースホルダーを埋める
16
-
17
7
  ## ヘッダー
18
8
 
19
9
  - `docs/**` の全設計書にヘッダーを付ける
@@ -40,6 +30,8 @@ spec_runner:
40
30
 
41
31
  ### node_id 体系
42
32
 
33
+ #### バックエンド
34
+
43
35
  | 対象 | node_id 形式 | 例 |
44
36
  |------|-------------|-----|
45
37
  | 要件定義 | `requirement.{名前}` | `requirement.要件定義` |
@@ -51,26 +43,42 @@ spec_runner:
51
43
  | UC 詳細設計 | `detail.usecase.{UC名}` | `detail.usecase.注文確定` |
52
44
  | DB・外部サービス | `detail.db.{名前}` | `detail.db.スキーマ定義` |
53
45
 
46
+ #### フロントエンド(has_frontend: true のみ)
47
+
48
+ | 対象 | node_id 形式 | 例 |
49
+ |------|-------------|-----|
50
+ | 要件定義 | `frontend.requirement.{名前}` | `frontend.requirement.要件定義` |
51
+ | 画面一覧 | `frontend.overview.画面一覧` | — |
52
+ | 画面遷移図 | `frontend.overview.画面遷移図` | — |
53
+ | コンポーネント一覧 | `frontend.overview.コンポーネント一覧` | — |
54
+ | ADR | `frontend.adr.{slug}` | `frontend.adr.0404-UIフレームワーク選定` |
55
+ | 画面詳細設計 | `frontend.detail.画面.{画面名}` | `frontend.detail.画面.ログイン` |
56
+ | コンポーネント詳細設計 | `frontend.detail.component.{名前}` | `frontend.detail.component.ボタン` |
57
+
54
58
  ## 命名規則
55
59
 
60
+ ### バックエンド
61
+
56
62
  | 対象 | 規則 | 例 |
57
63
  |------|------|-----|
58
- | `docs/01_要件定義` | 日本語 | `要件定義.md`, `ユビキタス言語辞書.md` |
59
- | `docs/02_概要設計` | 日本語 | `ユースケース一覧.md`, `システム全体俯瞰.md` |
60
- | `docs/02_概要設計`(style: ddd のみ) | 日本語 | `ドメインモデル.md` |
61
- | `docs/02_概要設計/90_ADR/{対象}/` | `mmdd-{日本語タイトル}.md` | `0404-注文集約の設計.md` |
64
+ | `docs/バックエンド/01_要件定義` | 日本語 | `要件定義.md`, `ユビキタス言語辞書.md` |
65
+ | `docs/バックエンド/02_概要設計` | 日本語 | `ユースケース一覧.md`, `システム全体俯瞰.md` |
66
+ | `docs/バックエンド/02_概要設計`(style: ddd のみ) | 日本語 | `ドメインモデル.md` |
67
+ | `docs/バックエンド/02_概要設計/90_ADR/{対象}/` | `mmdd-{日本語タイトル}.md` | `0404-注文集約の設計.md` |
62
68
  | `{対象}` の選択肢 | `全体` / `ドメイン` / `UC` / `DB` | — |
63
- | `docs/03_詳細設計/01_ドメイン`(style: ddd のみ) | 日本語 | `注文.md`, `在庫.md` |
64
- | `docs/03_詳細設計/02_ユースケース`(style: ddd) / `01_ユースケース`(style: layered) | `UC-{日本語名}.md` | `UC-注文確定.md` |
65
- | `docs/03_詳細設計/03_DB・外部サービス`(style: ddd) / `02_DB・外部サービス`(style: layered) | 日本語 | `スキーマ定義.dbml`, `外部サービス.md` |
69
+ | `docs/バックエンド/03_詳細設計/01_ドメイン`(style: ddd のみ) | 日本語 | `注文.md`, `在庫.md` |
70
+ | `docs/バックエンド/03_詳細設計/02_ユースケース`(style: ddd) / `01_ユースケース`(style: layered) | `UC-{日本語名}.md` | `UC-注文確定.md` |
71
+ | `docs/バックエンド/03_詳細設計/03_DB・外部サービス`(style: ddd) / `02_DB・外部サービス`(style: layered) | 日本語 | `スキーマ定義.dbml`, `外部サービス.md` |
66
72
 
67
- ## ADR
73
+ ### フロントエンド(has_frontend: true のみ)
68
74
 
69
- - ADR は提案時に必ず 3 案を比較してから採用案を決める。ドキュメントには採用案と採用理由のみ記録する
70
- - ADR は `docs/02_概要設計/90_ADR/{対象}/` で管理する(`全体` / `ドメイン` / `UC` / `DB`)
71
- - ファイル名は `mmdd-{日本語タイトル}.md`。対象はフォルダで表す
72
- - ADR は理由の記録であり、詳細設計の代わりにしない
73
- - 廃止 UC の理由も ADR に記録する(UC ファイル本体は削除)
75
+ | 対象 | 規則 | 例 |
76
+ |------|------|-----|
77
+ | `docs/フロントエンド/01_要件定義` | 日本語 | `要件定義.md` |
78
+ | `docs/フロントエンド/02_概要設計` | 日本語 | `画面一覧.md`, `画面遷移図.md`, `コンポーネント一覧.md` |
79
+ | `docs/フロントエンド/02_概要設計/90_ADR/` | `mmdd-{日本語タイトル}.md` | `0404-UIフレームワーク選定.md` |
80
+ | `docs/フロントエンド/03_詳細設計/01_画面/{カテゴリ名}/` | 日本語 | `ログイン.md`, `ダッシュボード.md` |
81
+ | `docs/フロントエンド/03_詳細設計/02_コンポーネント/` | 日本語 | `ボタン.md`, `モーダル.md` |
74
82
 
75
83
  ## 文書品質
76
84
 
@@ -90,8 +98,8 @@ spec_runner:
90
98
 
91
99
  | 種別 | 内容 | 置き場所 |
92
100
  |------|------|---------|
93
- | ドメインモデル | ビジネスルール・集約・値オブジェクト・不変条件 | `docs/03_詳細設計/01_ドメイン/` |
94
- | データモデル | DBスキーマ・テーブル定義・カラム定義・インデックス | `docs/03_詳細設計/03_DB・外部サービス/` |
101
+ | ドメインモデル | ビジネスルール・集約・値オブジェクト・不変条件 | `docs/バックエンド/03_詳細設計/01_ドメイン/` |
102
+ | データモデル | DBスキーマ・テーブル定義・カラム定義・インデックス | `docs/バックエンド/03_詳細設計/03_DB・外部サービス/` |
95
103
 
96
104
  - `01_ドメイン/` に DB スキーマ・テーブル定義・カラム定義を書かない
97
105
  - `03_DB・外部サービス/` にビジネスルール・ドメインロジックを書かない
@@ -20,10 +20,12 @@ Phase 5: architecture-skill-development へ自動移行
20
20
 
21
21
  テンプレート: `.claude/skills/ddd-seed/templates/01_要件定義/`
22
22
 
23
- 1. 曖昧な前提があれば `spec-probe` スキルで先に整理する
23
+ 1. 背景・提供価値・制約・スコープ外について、曖昧な点があれば一問一答で深掘りする(各質問に推奨回答を添える。コードで確認できることは質問しない)
24
24
  2. ユーザーから背景、提供価値、制約、スコープ外を確認する
25
- 3. テンプレートをコピーして `docs/01_要件定義/要件定義.md` を作る
26
- 4. ドメイン用語が出てきたら `docs/01_要件定義/ユビキタス言語辞書.md` に随時追記する
25
+ 3. テンプレートをコピーして以下を作る
26
+ - `docs/バックエンド/01_要件定義/要件定義.md`
27
+ - `has_frontend: true` の場合は `docs/フロントエンド/01_要件定義/要件定義.md` も作る
28
+ 4. ドメイン用語が出てきたら `docs/バックエンド/01_要件定義/ユビキタス言語辞書.md` に随時追記する
27
29
  5. アーキテクチャスタイルを選択する
28
30
 
29
31
  | スタイル | 選ぶ基準 |
@@ -87,4 +89,10 @@ Phase 4 が承認されたら、ユーザーにコマンドを打たせずに `a
87
89
  1. `architecture-skill-development` に渡す前提(docs・architecture.yaml・確定済みフォルダ構造)を要約する
88
90
  2. project 専用 skill に切り出すべき反復フローを列挙する
89
91
  3. 確認なしに `architecture-skill-development` Phase 1 へ進む
90
- 4. スキル整備完了後、プロジェクト専用スキルを使って概要設計へ進む
92
+ 4. スキル整備完了後、以下のスキルで概要設計へ進む
93
+
94
+ | 条件 | 起動するスキル |
95
+ |------|--------------|
96
+ | `style: ddd` | `ddd-seed`(バックエンド) |
97
+ | `style: layered` | `simple-seed`(バックエンド) |
98
+ | `has_frontend: true` | 上記に加えて `frontend-seed` を並走させる |