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.
- package/package.json +1 -1
- package/spec-runner/templates/.claude/rules/design-docs.md +34 -26
- package/spec-runner/templates/.claude/skills/architecture-definition/SKILL.md +12 -4
- package/spec-runner/templates/.claude/skills/architecture-skill-development/SKILL.md +18 -11
- package/spec-runner/templates/.claude/skills/ddd-seed/SKILL.md +11 -12
- 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
- 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
- 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
- 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
- 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
- package/spec-runner/templates/.claude/skills/design-change/SKILL.md +35 -20
- package/spec-runner/templates/.claude/skills/existing-project-to-docs/SKILL.md +45 -24
- package/spec-runner/templates/.claude/skills/frontend-seed/SKILL.md +121 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/spec-runner/templates/.claude/skills/simple-seed/SKILL.md +9 -10
- 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
- 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
- package/spec-runner/templates/.github/instructions/design-docs.instructions.md +33 -25
- package/spec-runner/templates/.github/skills/architecture-definition/SKILL.md +12 -4
- package/spec-runner/templates/.github/skills/architecture-skill-development/SKILL.md +18 -11
- package/spec-runner/templates/.github/skills/ddd-seed/SKILL.md +11 -12
- package/spec-runner/templates/.github/skills/design-change/SKILL.md +35 -20
- package/spec-runner/templates/.github/skills/existing-project-to-docs/SKILL.md +45 -24
- package/spec-runner/templates/.github/skills/frontend-seed/SKILL.md +121 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/spec-runner/templates/.github/skills/simple-seed/SKILL.md +9 -10
- 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
- package/spec-runner/templates/.claude/skills/spec-probe/SKILL.md +0 -12
- 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
- package/spec-runner/templates/.github/skills/spec-probe/SKILL.md +0 -12
|
@@ -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
|
|
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` なら
|
|
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
|
|
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
|
|
48
|
-
3. コンポーネント全体図・外部 IF を整理し `docs
|
|
48
|
+
2. テンプレートをコピーして `docs/バックエンド/02_概要設計/ユースケース一覧.md` を作る
|
|
49
|
+
3. コンポーネント全体図・外部 IF を整理し `docs/バックエンド/02_概要設計/システム全体俯瞰.md` を作る
|
|
49
50
|
4. ユーザーに確認・承認を得る
|
|
50
51
|
|
|
51
52
|
### 出力
|
|
52
53
|
|
|
53
54
|
```
|
|
54
|
-
docs
|
|
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
|
|
87
|
+
docs/バックエンド/03_詳細設計/01_ユースケース/
|
|
89
88
|
UC-{日本語名}.md
|
|
90
89
|
```
|
|
91
90
|
|
|
92
91
|
### 4-2. DB・外部サービス(必要時のみ)
|
|
93
92
|
|
|
94
93
|
```
|
|
95
|
-
docs
|
|
94
|
+
docs/バックエンド/03_詳細設計/02_DB・外部サービス/
|
|
96
95
|
スキーマ定義.dbml
|
|
97
96
|
外部サービス.md
|
|
98
97
|
```
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
# 影響範囲チェックリスト
|
|
2
|
-
|
|
3
|
-
> このファイルはテンプレートです。`architecture-skill-development` でプロジェクトの変更カテゴリと詳細設計パスに合わせて書き換えてください。
|
|
4
|
-
|
|
5
|
-
design-change の Phase 3(影響ドキュメントの確定)で参照する。
|
|
6
|
-
変更の種類に応じて、修正が必要なドキュメントを網羅的に特定する。
|
|
7
|
-
|
|
8
|
-
## 変更種別ごとのチェック項目
|
|
9
|
-
|
|
10
|
-
### ユースケース(UC)の追加・変更・削除
|
|
11
|
-
|
|
12
|
-
| ドキュメント | パス | チェック |
|
|
13
|
-
|------------|------|------|
|
|
14
|
-
| ユースケース一覧 | `docs/02_概要設計/ユースケース一覧.md` | UC の追加・修正・削除を反映 |
|
|
15
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | 責務分割・外部 IF への影響 |
|
|
16
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | シーケンス・入出力・判断条件の変更 |
|
|
17
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | UC が利用するスキーマ・外部 IF への影響 |
|
|
18
|
-
|
|
19
|
-
### ドメイン設計の変更(style: ddd のみ)
|
|
20
|
-
|
|
21
|
-
| ドキュメント | パス | チェック |
|
|
22
|
-
|------------|------|------|
|
|
23
|
-
| ドメインモデル | `docs/02_概要設計/ドメインモデル.md` | 集約・境界コンテキストへの影響 |
|
|
24
|
-
| ドメイン詳細設計 | `docs/03_詳細設計/<ドメイン詳細設計パス>/{ドメイン名}.md` | エンティティ・値オブジェクト・不変条件の変更 |
|
|
25
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | ドメイン変更が UC フローに影響する場合 |
|
|
26
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | スキーマ・保存方針への影響 |
|
|
27
|
-
|
|
28
|
-
### DB・外部サービスの変更
|
|
29
|
-
|
|
30
|
-
| ドキュメント | パス | チェック |
|
|
31
|
-
|------------|------|------|
|
|
32
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | テーブル定義・外部 API 仕様の変更 |
|
|
33
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | 保存フロー・外部呼び出しへの影響 |
|
|
34
|
-
| ドメイン詳細設計 | `docs/03_詳細設計/<ドメイン詳細設計パス>/{ドメイン名}.md` | ドメインモデルへの影響(style: ddd のみ) |
|
|
35
|
-
|
|
36
|
-
### アーキテクチャ・設計方針の変更
|
|
37
|
-
|
|
38
|
-
| ドキュメント | パス | チェック |
|
|
39
|
-
|------------|------|------|
|
|
40
|
-
| ADR | `docs/02_概要設計/90_ADR/全体/` | 横断的な決定を記録 |
|
|
41
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | 技術方針・全体構成の変更 |
|
|
42
|
-
| 要件定義 | `docs/01_要件定義/要件定義.md` | 要件レベルの変更がある場合 |
|
|
43
|
-
| 詳細設計一式 | `docs/03_詳細設計/**` | 方針変更の具体反映 |
|
|
44
|
-
|
|
45
|
-
### 要件の変更
|
|
46
|
-
|
|
47
|
-
| ドキュメント | パス | チェック |
|
|
48
|
-
|------------|------|------|
|
|
49
|
-
| 要件定義 | `docs/01_要件定義/要件定義.md` | 要件・スコープの変更 |
|
|
50
|
-
| ユビキタス言語辞書 | `docs/01_要件定義/ユビキタス言語辞書.md` | 用語の追加・変更 |
|
|
51
|
-
| ユースケース一覧 | `docs/02_概要設計/ユースケース一覧.md` | 要件変更に伴う UC の追加・削除 |
|
|
52
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | スコープ変更による構成への影響 |
|
|
53
|
-
|
|
54
|
-
## 二次影響の確認観点
|
|
55
|
-
|
|
56
|
-
- **ユースケース一覧 ↔ 詳細設計**: 一覧に記載の UC が詳細設計でカバーされているか
|
|
57
|
-
- **システム全体俯瞰 ↔ 詳細設計**: 責務分割が詳細設計に落ちているか
|
|
58
|
-
- **ドメイン設計 ↔ DB スキーマ**: ドメインのフィールドが DB カラムと対応しているか(style: ddd のみ)
|
|
59
|
-
- **ヘッダー ↔ 実ファイル**: `depends_on` と `maps_to` が現状に追随しているか
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
# 影響範囲チェックリスト
|
|
2
|
-
|
|
3
|
-
> このファイルはテンプレートです。`architecture-skill-development` でプロジェクトの変更カテゴリと詳細設計パスに合わせて書き換えてください。
|
|
4
|
-
|
|
5
|
-
design-change の Phase 3(影響ドキュメントの確定)で参照する。
|
|
6
|
-
変更の種類に応じて、修正が必要なドキュメントを網羅的に特定する。
|
|
7
|
-
|
|
8
|
-
## 変更種別ごとのチェック項目
|
|
9
|
-
|
|
10
|
-
### ユースケース(UC)の追加・変更・削除
|
|
11
|
-
|
|
12
|
-
| ドキュメント | パス | チェック |
|
|
13
|
-
|------------|------|------|
|
|
14
|
-
| ユースケース一覧 | `docs/02_概要設計/ユースケース一覧.md` | UC の追加・修正・削除を反映 |
|
|
15
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | 責務分割・外部 IF への影響 |
|
|
16
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | シーケンス・入出力・判断条件の変更 |
|
|
17
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | UC が利用するスキーマ・外部 IF への影響 |
|
|
18
|
-
|
|
19
|
-
### ドメイン設計の変更(style: ddd のみ)
|
|
20
|
-
|
|
21
|
-
| ドキュメント | パス | チェック |
|
|
22
|
-
|------------|------|------|
|
|
23
|
-
| ドメインモデル | `docs/02_概要設計/ドメインモデル.md` | 集約・境界コンテキストへの影響 |
|
|
24
|
-
| ドメイン詳細設計 | `docs/03_詳細設計/<ドメイン詳細設計パス>/{ドメイン名}.md` | エンティティ・値オブジェクト・不変条件の変更 |
|
|
25
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | ドメイン変更が UC フローに影響する場合 |
|
|
26
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | スキーマ・保存方針への影響 |
|
|
27
|
-
|
|
28
|
-
### DB・外部サービスの変更
|
|
29
|
-
|
|
30
|
-
| ドキュメント | パス | チェック |
|
|
31
|
-
|------------|------|------|
|
|
32
|
-
| DB・外部サービス | `docs/03_詳細設計/<DB・外部サービスパス>/` | テーブル定義・外部 API 仕様の変更 |
|
|
33
|
-
| UC 詳細設計 | `docs/03_詳細設計/<UC詳細設計パス>/UC-{日本語名}.md` | 保存フロー・外部呼び出しへの影響 |
|
|
34
|
-
| ドメイン詳細設計 | `docs/03_詳細設計/<ドメイン詳細設計パス>/{ドメイン名}.md` | ドメインモデルへの影響(style: ddd のみ) |
|
|
35
|
-
|
|
36
|
-
### アーキテクチャ・設計方針の変更
|
|
37
|
-
|
|
38
|
-
| ドキュメント | パス | チェック |
|
|
39
|
-
|------------|------|------|
|
|
40
|
-
| ADR | `docs/02_概要設計/90_ADR/全体/` | 横断的な決定を記録 |
|
|
41
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | 技術方針・全体構成の変更 |
|
|
42
|
-
| 要件定義 | `docs/01_要件定義/要件定義.md` | 要件レベルの変更がある場合 |
|
|
43
|
-
| 詳細設計一式 | `docs/03_詳細設計/**` | 方針変更の具体反映 |
|
|
44
|
-
|
|
45
|
-
### 要件の変更
|
|
46
|
-
|
|
47
|
-
| ドキュメント | パス | チェック |
|
|
48
|
-
|------------|------|------|
|
|
49
|
-
| 要件定義 | `docs/01_要件定義/要件定義.md` | 要件・スコープの変更 |
|
|
50
|
-
| ユビキタス言語辞書 | `docs/01_要件定義/ユビキタス言語辞書.md` | 用語の追加・変更 |
|
|
51
|
-
| ユースケース一覧 | `docs/02_概要設計/ユースケース一覧.md` | 要件変更に伴う UC の追加・削除 |
|
|
52
|
-
| システム全体俯瞰 | `docs/02_概要設計/システム全体俯瞰.md` | スコープ変更による構成への影響 |
|
|
53
|
-
|
|
54
|
-
## 二次影響の確認観点
|
|
55
|
-
|
|
56
|
-
- **ユースケース一覧 ↔ 詳細設計**: 一覧に記載の UC が詳細設計でカバーされているか
|
|
57
|
-
- **システム全体俯瞰 ↔ 詳細設計**: 責務分割が詳細設計に落ちているか
|
|
58
|
-
- **ドメイン設計 ↔ DB スキーマ**: ドメインのフィールドが DB カラムと対応しているか(style: ddd のみ)
|
|
59
|
-
- **ヘッダー ↔ 実ファイル**: `depends_on` と `maps_to` が現状に追随しているか
|