yodogawa 2.1.0 → 2.1.1
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/LICENSE +21 -0
- package/README.md +6 -0
- package/package.json +2 -2
- package/scripts/create-task.sh +77 -0
- package/scripts/init-project-docs.sh +90 -0
- package/scripts/init-task-doc.sh +77 -0
- package/skills/a-001-setup-doc-structure/SKILL.md +1 -1
- package/skills/a-001-setup-doc-structure/reference/directory-structure.md +4 -8
- package/skills/a-002-initialize-project/SKILL.md +37 -36
- package/skills/a-002-initialize-project/reference/structure-check.md +7 -7
- package/skills/a-003-create-scenarios/SKILL.md +11 -11
- package/skills/a-003-create-scenarios/reference/structure-check.md +5 -5
- package/skills/a-004-define-domain-model/SKILL.md +9 -9
- package/skills/a-004-define-domain-model/reference/event-storming-guide.md +3 -3
- package/skills/a-005-create-domain-diagram/SKILL.md +7 -7
- package/skills/a-005-create-domain-diagram/reference/structure-check.md +4 -4
- package/skills/a-006-review-requirements-domain/SKILL.md +4 -4
- package/skills/a-006-review-requirements-domain/reference/consistency-checks.md +5 -5
- package/skills/a-007-define-tech-stack/SKILL.md +11 -11
- package/skills/a-007-define-tech-stack/reference/structure-check.md +5 -5
- package/skills/a-008-define-repository-structure/SKILL.md +12 -12
- package/skills/a-008-define-repository-structure/reference/structure-check.md +5 -5
- package/skills/a-009-define-screen-design/SKILL.md +14 -14
- package/skills/a-009-define-screen-design/reference/structure-check.md +5 -5
- package/skills/a-010-define-design-system/SKILL.md +9 -9
- package/skills/a-011-define-data-model/SKILL.md +15 -15
- package/skills/a-011-define-data-model/reference/structure-check.md +5 -5
- package/skills/a-012-define-api-spec/SKILL.md +15 -15
- package/skills/a-012-define-api-spec/reference/structure-check.md +5 -5
- package/skills/a-013-define-architecture/SKILL.md +13 -13
- package/skills/a-013-define-architecture/reference/structure-check.md +5 -5
- package/skills/a-014-define-infrastructure/SKILL.md +13 -13
- package/skills/a-014-define-infrastructure/reference/structure-check.md +5 -5
- package/skills/a-015-review-design/SKILL.md +8 -8
- package/skills/a-015-review-design/reference/consistency-checks.md +2 -2
- package/skills/b-001-create-task-directory/SKILL.md +19 -25
- package/skills/b-002-create-task-definition/SKILL.md +4 -4
- package/skills/b-003-create-task-research/SKILL.md +4 -5
- package/skills/b-004-create-task-implementation/SKILL.md +5 -3
- package/skills/c-001-implement-task/SKILL.md +1 -1
|
@@ -53,11 +53,11 @@ SKILL.md 手順3〜6で使うドメインモデル定義の観点集。
|
|
|
53
53
|
## 構造確認コマンド
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
|
-
grep "Bounded Context:" docs/project/domain/01-domain-model.md \
|
|
56
|
+
grep "Bounded Context:" docs/project/03-domain/01-domain-model.md \
|
|
57
57
|
&& echo "OK" || echo "MISSING: Bounded Context definition"
|
|
58
|
-
grep "### Aggregates" docs/project/domain/01-domain-model.md \
|
|
58
|
+
grep "### Aggregates" docs/project/03-domain/01-domain-model.md \
|
|
59
59
|
&& echo "OK" || echo "MISSING: Aggregates section"
|
|
60
|
-
grep "| 用語 | 定義 |" docs/project/domain/02-ubiquitous-language.md \
|
|
60
|
+
grep "| 用語 | 定義 |" docs/project/03-domain/02-ubiquitous-language.md \
|
|
61
61
|
&& echo "OK" || echo "MISSING: Terminology table"
|
|
62
62
|
```
|
|
63
63
|
|
|
@@ -15,7 +15,7 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
15
15
|
|
|
16
16
|
## 前提
|
|
17
17
|
|
|
18
|
-
- `docs/project/domain/01-domain-model.md` が作成されていること(`/a-004-define-domain-model` 実行済み)。
|
|
18
|
+
- `docs/project/03-domain/01-domain-model.md` が作成されていること(`/a-004-define-domain-model` 実行済み)。
|
|
19
19
|
- ドメインモデルドキュメントに Bounded Context の一覧と関係性が記述されていること。
|
|
20
20
|
|
|
21
21
|
## 手順
|
|
@@ -23,14 +23,14 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
23
23
|
### 1. ドキュメントの確認
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
ls -la docs/project/domain/01-domain-model.md 2>/dev/null || echo "ファイルが存在しません"
|
|
26
|
+
ls -la docs/project/03-domain/01-domain-model.md 2>/dev/null || echo "ファイルが存在しません"
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
未作成の場合、`/a-004-define-domain-model` の実行を促す。
|
|
30
30
|
|
|
31
31
|
### 2. Context Map の情報収集と提案
|
|
32
32
|
|
|
33
|
-
`docs/project/domain/01-domain-model.md` から以下を抽出し、構成案を提示する:
|
|
33
|
+
`docs/project/03-domain/01-domain-model.md` から以下を抽出し、構成案を提示する:
|
|
34
34
|
|
|
35
35
|
- Bounded Context のリスト
|
|
36
36
|
- 戦略的分類(Core / Supporting / Generic)
|
|
@@ -59,8 +59,8 @@ ls -la docs/project/domain/01-domain-model.md 2>/dev/null || echo "ファイル
|
|
|
59
59
|
### 6. 構造チェック
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
grep "\`\`\`mermaid" docs/project/domain/01-domain-model.md \
|
|
63
|
-
&& grep "## Context Map" docs/project/domain/01-domain-model.md \
|
|
62
|
+
grep "\`\`\`mermaid" docs/project/03-domain/01-domain-model.md \
|
|
63
|
+
&& grep "## Context Map" docs/project/03-domain/01-domain-model.md \
|
|
64
64
|
&& echo "OK" || echo "MISSING SECTION"
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -69,7 +69,7 @@ grep "\`\`\`mermaid" docs/project/domain/01-domain-model.md \
|
|
|
69
69
|
### 7. Git への追加(任意)
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
git add docs/project/domain/01-domain-model.md
|
|
72
|
+
git add docs/project/03-domain/01-domain-model.md
|
|
73
73
|
git commit -m "docs: ドメインモデル図(Context Map)の追加"
|
|
74
74
|
```
|
|
75
75
|
|
|
@@ -77,7 +77,7 @@ git commit -m "docs: ドメインモデル図(Context Map)の追加"
|
|
|
77
77
|
|
|
78
78
|
## 完了条件
|
|
79
79
|
|
|
80
|
-
- `docs/project/domain/01-domain-model.md` に Context Map 図が追加されている。
|
|
80
|
+
- `docs/project/03-domain/01-domain-model.md` に Context Map 図が追加されている。
|
|
81
81
|
- Bounded Context 間の関係性が正しく表現されている。
|
|
82
82
|
- 戦略的分類が視覚的に区別されている。
|
|
83
83
|
- オプションの詳細図(Aggregate 図、シーケンス図)が必要に応じて追加されている。
|
|
@@ -6,14 +6,14 @@ SKILL.md 手順5〜7 で使用する確認コマンドとレビュー観点。
|
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
# Mermaid ブロックの存在確認
|
|
9
|
-
grep "\`\`\`mermaid" docs/project/domain/01-domain-model.md && echo "OK" || echo "MISSING: Mermaid diagram"
|
|
9
|
+
grep "\`\`\`mermaid" docs/project/03-domain/01-domain-model.md && echo "OK" || echo "MISSING: Mermaid diagram"
|
|
10
10
|
# Context Map セクションの確認
|
|
11
|
-
grep "## Context Map" docs/project/domain/01-domain-model.md && echo "OK" || echo "MISSING: Context Map section"
|
|
11
|
+
grep "## Context Map" docs/project/03-domain/01-domain-model.md && echo "OK" || echo "MISSING: Context Map section"
|
|
12
12
|
```
|
|
13
13
|
|
|
14
14
|
## チェックリスト
|
|
15
15
|
|
|
16
|
-
- [ ] `docs/project/domain/01-domain-model.md` に Context Map 図が含まれている
|
|
16
|
+
- [ ] `docs/project/03-domain/01-domain-model.md` に Context Map 図が含まれている
|
|
17
17
|
- [ ] Mermaid 図が正しくレンダリングされる(構文エラーがない)
|
|
18
18
|
- [ ] 戦略的分類に応じて色分けされている(Core / Supporting / Generic)
|
|
19
19
|
- [ ] 関係パターン(Customer/Supplier など)と通信方法がエッジに記載されている
|
|
@@ -29,7 +29,7 @@ grep "## Context Map" docs/project/domain/01-domain-model.md && echo "OK" || ech
|
|
|
29
29
|
## Git への追加(任意)
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
git add docs/project/domain/01-domain-model.md
|
|
32
|
+
git add docs/project/03-domain/01-domain-model.md
|
|
33
33
|
git status
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -19,16 +19,16 @@ allowed-tools: Read, Grep, Glob, Write, Bash
|
|
|
19
19
|
|
|
20
20
|
以下のドキュメントが作成されていること:
|
|
21
21
|
|
|
22
|
-
- `docs/project/requirements/01-system-overview.md` 〜 `05-user-stories.md`
|
|
23
|
-
- `docs/project/behavior/01-scenarios.md`
|
|
24
|
-
- `docs/project/domain/01-domain-model.md`, `02-ubiquitous-language.md`
|
|
22
|
+
- `docs/project/01-requirements/01-system-overview.md` 〜 `05-user-stories.md`
|
|
23
|
+
- `docs/project/02-behavior/01-scenarios.md`
|
|
24
|
+
- `docs/project/03-domain/01-domain-model.md`, `02-ubiquitous-language.md`
|
|
25
25
|
|
|
26
26
|
## 手順
|
|
27
27
|
|
|
28
28
|
### 1. ドキュメント存在確認
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
|
-
ls -l docs/project/requirements/*.md docs/project/behavior/*.md docs/project/domain/*.md
|
|
31
|
+
ls -l docs/project/01-requirements/*.md docs/project/02-behavior/*.md docs/project/03-domain/*.md
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
不足があれば、対応する `/a-002`, `/a-003`, `/a-004` スキルの実行を促す。
|
|
@@ -9,9 +9,9 @@ SKILL.md 手順2 で実施する各チェック項目の詳細。自動検索(
|
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
# 全ユーザーストーリーの ID 抽出
|
|
12
|
-
grep -oE "US-[0-9]+" docs/project/requirements/05-user-stories.md | sort -u
|
|
12
|
+
grep -oE "US-[0-9]+" docs/project/01-requirements/05-user-stories.md | sort -u
|
|
13
13
|
# シナリオ側の参照
|
|
14
|
-
grep -oE "US-[0-9]+" docs/project/behavior/01-scenarios.md | sort -u
|
|
14
|
+
grep -oE "US-[0-9]+" docs/project/02-behavior/01-scenarios.md | sort -u
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## 2.2 実装済み機能・予定機能 ↔ シナリオ
|
|
@@ -37,9 +37,9 @@ grep -oE "US-[0-9]+" docs/project/behavior/01-scenarios.md | sort -u
|
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
39
|
# 禁止用語の簡易検索
|
|
40
|
-
grep -rn "Data" docs/project/domain/ || echo "No 'Data' found"
|
|
41
|
-
grep -rn "Process" docs/project/domain/ || echo "No 'Process' found"
|
|
42
|
-
grep -rn "Manager" docs/project/domain/ || echo "No 'Manager' found"
|
|
40
|
+
grep -rn "Data" docs/project/03-domain/ || echo "No 'Data' found"
|
|
41
|
+
grep -rn "Process" docs/project/03-domain/ || echo "No 'Process' found"
|
|
42
|
+
grep -rn "Manager" docs/project/03-domain/ || echo "No 'Manager' found"
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
## 2.6 目的との整合性
|
|
@@ -15,16 +15,16 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
15
15
|
|
|
16
16
|
## 前提
|
|
17
17
|
|
|
18
|
-
- `docs/project/requirements/` 配下のドキュメントが作成されていること。
|
|
19
|
-
- `docs/project/domain/` 配下のドキュメントが作成されていること。
|
|
20
|
-
- `docs/project/design/` ディレクトリが存在すること(未作成なら `/a-001-setup-doc-structure`)。
|
|
18
|
+
- `docs/project/01-requirements/` 配下のドキュメントが作成されていること。
|
|
19
|
+
- `docs/project/03-domain/` 配下のドキュメントが作成されていること。
|
|
20
|
+
- `docs/project/04-design/` ディレクトリが存在すること(未作成なら `/a-001-setup-doc-structure`)。
|
|
21
21
|
|
|
22
22
|
## 手順
|
|
23
23
|
|
|
24
24
|
### 1. ドキュメントと前提条件の確認
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
ls -la docs/project/design/ 2>/dev/null || echo "ディレクトリが存在しません"
|
|
27
|
+
ls -la docs/project/04-design/ 2>/dev/null || echo "ディレクトリが存在しません"
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
要件ドキュメント(`01-system-overview.md`, `03-features-planned.md`, `04-non-functional-requirements.md`)とドメインモデル(`01-domain-model.md`)を読み込む。
|
|
@@ -32,8 +32,8 @@ ls -la docs/project/design/ 2>/dev/null || echo "ディレクトリが存在し
|
|
|
32
32
|
### 2. テンプレートの準備
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
SCRIPT_DIR=$(for d in .
|
|
36
|
-
cp "$SCRIPT_DIR/templates/project/04-design/01-tech-stack.md" "docs/project/design/01-tech-stack.md"
|
|
35
|
+
SCRIPT_DIR=$(for d in .claude .agents; do [ -d "$d" ] && echo "$d" && break; done)
|
|
36
|
+
cp "$SCRIPT_DIR/templates/project/04-design/01-tech-stack.md" "docs/project/04-design/01-tech-stack.md"
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
### 3. 要件分析と推奨技術スタックの生成
|
|
@@ -56,7 +56,7 @@ cp "$SCRIPT_DIR/templates/project/04-design/01-tech-stack.md" "docs/project/desi
|
|
|
56
56
|
|
|
57
57
|
### 5. ドキュメント作成
|
|
58
58
|
|
|
59
|
-
ヒアリング結果を `docs/project/design/01-tech-stack.md` に記入する。必須項目:
|
|
59
|
+
ヒアリング結果を `docs/project/04-design/01-tech-stack.md` に記入する。必須項目:
|
|
60
60
|
|
|
61
61
|
- 技術名、バージョン
|
|
62
62
|
- 選定理由(要件とのマッピング)
|
|
@@ -67,8 +67,8 @@ cp "$SCRIPT_DIR/templates/project/04-design/01-tech-stack.md" "docs/project/desi
|
|
|
67
67
|
### 6. 構造チェック
|
|
68
68
|
|
|
69
69
|
```bash
|
|
70
|
-
grep "### フロントエンド" docs/project/design/01-tech-stack.md \
|
|
71
|
-
&& grep "### バックエンド" docs/project/design/01-tech-stack.md \
|
|
70
|
+
grep "### フロントエンド" docs/project/04-design/01-tech-stack.md \
|
|
71
|
+
&& grep "### バックエンド" docs/project/04-design/01-tech-stack.md \
|
|
72
72
|
&& echo "OK" || echo "MISSING SECTION"
|
|
73
73
|
```
|
|
74
74
|
|
|
@@ -77,7 +77,7 @@ grep "### フロントエンド" docs/project/design/01-tech-stack.md \
|
|
|
77
77
|
### 7. Git への追加(任意)
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
git add docs/project/design/01-tech-stack.md
|
|
80
|
+
git add docs/project/04-design/01-tech-stack.md
|
|
81
81
|
git commit -m "docs: 技術スタック選定ドキュメントの作成"
|
|
82
82
|
```
|
|
83
83
|
|
|
@@ -85,7 +85,7 @@ git commit -m "docs: 技術スタック選定ドキュメントの作成"
|
|
|
85
85
|
|
|
86
86
|
## 完了条件
|
|
87
87
|
|
|
88
|
-
- `docs/project/design/01-tech-stack.md` が作成されている。
|
|
88
|
+
- `docs/project/04-design/01-tech-stack.md` が作成されている。
|
|
89
89
|
- すべてのレイヤーについて技術選定が完了している(または「保留」として記録されている)。
|
|
90
90
|
- 選定理由とバージョンが明確になっている。
|
|
91
91
|
- ユーザーが内容を承認している。
|
|
@@ -6,16 +6,16 @@ SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
|
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
# フロントエンドセクションの確認
|
|
9
|
-
grep "### フロントエンド" docs/project/design/01-tech-stack.md && echo "OK" || echo "MISSING: Frontend section"
|
|
9
|
+
grep "### フロントエンド" docs/project/04-design/01-tech-stack.md && echo "OK" || echo "MISSING: Frontend section"
|
|
10
10
|
# バックエンドセクションの確認
|
|
11
|
-
grep "### バックエンド" docs/project/design/01-tech-stack.md && echo "OK" || echo "MISSING: Backend section"
|
|
11
|
+
grep "### バックエンド" docs/project/04-design/01-tech-stack.md && echo "OK" || echo "MISSING: Backend section"
|
|
12
12
|
# 技術選定理由の確認(表形式)
|
|
13
|
-
grep "|" docs/project/design/01-tech-stack.md | head -n 5
|
|
13
|
+
grep "|" docs/project/04-design/01-tech-stack.md | head -n 5
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## チェックリスト
|
|
17
17
|
|
|
18
|
-
- [ ] `docs/project/design/01-tech-stack.md` が作成されている
|
|
18
|
+
- [ ] `docs/project/04-design/01-tech-stack.md` が作成されている
|
|
19
19
|
- [ ] 主要レイヤー(FE, BE, DB, Infra, 監視/テスト)の技術が選定されている
|
|
20
20
|
- [ ] 各技術にバージョンが記載されている
|
|
21
21
|
- [ ] 選定理由が要件とマッピングされている
|
|
@@ -37,7 +37,7 @@ grep "|" docs/project/design/01-tech-stack.md | head -n 5
|
|
|
37
37
|
## Git への追加(任意)
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
|
-
git add docs/project/design/01-tech-stack.md
|
|
40
|
+
git add docs/project/04-design/01-tech-stack.md
|
|
41
41
|
git status
|
|
42
42
|
```
|
|
43
43
|
|
|
@@ -15,16 +15,16 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
15
15
|
|
|
16
16
|
## 前提
|
|
17
17
|
|
|
18
|
-
- `docs/project/design/01-tech-stack.md` が作成されていること(`/a-007-define-tech-stack` 実行済み)。
|
|
19
|
-
- `docs/project/domain/01-domain-model.md` が作成されていること(推奨)。
|
|
20
|
-
- `docs/project/design/` ディレクトリが存在すること。
|
|
18
|
+
- `docs/project/04-design/01-tech-stack.md` が作成されていること(`/a-007-define-tech-stack` 実行済み)。
|
|
19
|
+
- `docs/project/03-domain/01-domain-model.md` が作成されていること(推奨)。
|
|
20
|
+
- `docs/project/04-design/` ディレクトリが存在すること。
|
|
21
21
|
|
|
22
22
|
## 手順
|
|
23
23
|
|
|
24
24
|
### 1. ドキュメントと前提条件の確認
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
ls -la docs/project/design/01-tech-stack.md 2>/dev/null || echo "ファイルが存在しません"
|
|
27
|
+
ls -la docs/project/04-design/01-tech-stack.md 2>/dev/null || echo "ファイルが存在しません"
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
`01-tech-stack.md` を読み込み、技術スタックを把握する。
|
|
@@ -32,8 +32,8 @@ ls -la docs/project/design/01-tech-stack.md 2>/dev/null || echo "ファイルが
|
|
|
32
32
|
### 2. テンプレートの準備
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
SCRIPT_DIR=$(for d in .
|
|
36
|
-
cp "$SCRIPT_DIR/templates/project/04-design/02-repository-structure.md" "docs/project/design/02-repository-structure.md"
|
|
35
|
+
SCRIPT_DIR=$(for d in .claude .agents; do [ -d "$d" ] && echo "$d" && break; done)
|
|
36
|
+
cp "$SCRIPT_DIR/templates/project/04-design/02-repository-structure.md" "docs/project/04-design/02-repository-structure.md"
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
### 3. アーキテクチャパターンの提案
|
|
@@ -56,7 +56,7 @@ cp "$SCRIPT_DIR/templates/project/04-design/02-repository-structure.md" "docs/pr
|
|
|
56
56
|
|
|
57
57
|
### 5. ドキュメント作成
|
|
58
58
|
|
|
59
|
-
`docs/project/design/02-repository-structure.md` に以下を記入する:
|
|
59
|
+
`docs/project/04-design/02-repository-structure.md` に以下を記入する:
|
|
60
60
|
|
|
61
61
|
- ディレクトリツリー図(`tree` 形式)
|
|
62
62
|
- 各ディレクトリの役割説明
|
|
@@ -66,9 +66,9 @@ cp "$SCRIPT_DIR/templates/project/04-design/02-repository-structure.md" "docs/pr
|
|
|
66
66
|
### 6. 構造チェック
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
grep "project-root/" docs/project/design/02-repository-structure.md \
|
|
70
|
-
&& grep "## アーキテクチャパターン" docs/project/design/02-repository-structure.md \
|
|
71
|
-
&& grep "## 命名規則" docs/project/design/02-repository-structure.md \
|
|
69
|
+
grep "project-root/" docs/project/04-design/02-repository-structure.md \
|
|
70
|
+
&& grep "## アーキテクチャパターン" docs/project/04-design/02-repository-structure.md \
|
|
71
|
+
&& grep "## 命名規則" docs/project/04-design/02-repository-structure.md \
|
|
72
72
|
&& echo "OK" || echo "MISSING SECTION"
|
|
73
73
|
```
|
|
74
74
|
|
|
@@ -77,13 +77,13 @@ grep "project-root/" docs/project/design/02-repository-structure.md \
|
|
|
77
77
|
### 7. Git への追加(任意)
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
git add docs/project/design/02-repository-structure.md
|
|
80
|
+
git add docs/project/04-design/02-repository-structure.md
|
|
81
81
|
git commit -m "docs: リポジトリ構造とアーキテクチャ定義の作成"
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
## 完了条件
|
|
85
85
|
|
|
86
|
-
- `docs/project/design/02-repository-structure.md` が作成されている。
|
|
86
|
+
- `docs/project/04-design/02-repository-structure.md` が作成されている。
|
|
87
87
|
- プロジェクトのディレクトリ構造が明確に定義されている。
|
|
88
88
|
- チーム開発に必要なルール(命名、配置、依存)が文書化されている。
|
|
89
89
|
- ユーザーが内容を承認している。
|
|
@@ -6,16 +6,16 @@ SKILL.md 手順6〜7 で使う確認コマンドとレビュー観点。
|
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
# ディレクトリ構造図の確認
|
|
9
|
-
grep "project-root/" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Directory tree"
|
|
9
|
+
grep "project-root/" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Directory tree"
|
|
10
10
|
# アーキテクチャパターンセクションの確認
|
|
11
|
-
grep "## アーキテクチャパターン" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Architecture section"
|
|
11
|
+
grep "## アーキテクチャパターン" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Architecture section"
|
|
12
12
|
# 命名規則セクションの確認
|
|
13
|
-
grep "## 命名規則" docs/project/design/02-repository-structure.md && echo "OK" || echo "MISSING: Naming convention section"
|
|
13
|
+
grep "## 命名規則" docs/project/04-design/02-repository-structure.md && echo "OK" || echo "MISSING: Naming convention section"
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## チェックリスト
|
|
17
17
|
|
|
18
|
-
- [ ] `docs/project/design/02-repository-structure.md` が作成されている
|
|
18
|
+
- [ ] `docs/project/04-design/02-repository-structure.md` が作成されている
|
|
19
19
|
- [ ] ディレクトリツリーが技術スタックと整合している
|
|
20
20
|
- [ ] 各ディレクトリの責務が定義されている
|
|
21
21
|
- [ ] 採用アーキテクチャパターンの理由が記載されている
|
|
@@ -41,7 +41,7 @@ grep "## 命名規則" docs/project/design/02-repository-structure.md && echo "O
|
|
|
41
41
|
## Git への追加(任意)
|
|
42
42
|
|
|
43
43
|
```bash
|
|
44
|
-
git add docs/project/design/02-repository-structure.md
|
|
44
|
+
git add docs/project/04-design/02-repository-structure.md
|
|
45
45
|
git status
|
|
46
46
|
```
|
|
47
47
|
|
|
@@ -16,9 +16,9 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
16
16
|
|
|
17
17
|
## 前提
|
|
18
18
|
|
|
19
|
-
- `docs/project/requirements/05-user-stories.md` が作成されていること。
|
|
20
|
-
- `docs/project/behavior/01-scenarios.md` が作成されていること。
|
|
21
|
-
- `docs/project/design/` ディレクトリが存在すること。
|
|
19
|
+
- `docs/project/01-requirements/05-user-stories.md` が作成されていること。
|
|
20
|
+
- `docs/project/02-behavior/01-scenarios.md` が作成されていること。
|
|
21
|
+
- `docs/project/04-design/` ディレクトリが存在すること。
|
|
22
22
|
|
|
23
23
|
## 手順
|
|
24
24
|
|
|
@@ -26,17 +26,17 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
26
26
|
|
|
27
27
|
以下を読み込む:
|
|
28
28
|
|
|
29
|
-
- `docs/project/requirements/05-user-stories.md`
|
|
30
|
-
- `docs/project/behavior/01-scenarios.md`
|
|
31
|
-
- `docs/project/design/01-tech-stack.md`(存在する場合)
|
|
29
|
+
- `docs/project/01-requirements/05-user-stories.md`
|
|
30
|
+
- `docs/project/02-behavior/01-scenarios.md`
|
|
31
|
+
- `docs/project/04-design/01-tech-stack.md`(存在する場合)
|
|
32
32
|
|
|
33
33
|
不足があれば対応スキル(`/a-002`, `/a-003`, `/a-007`)の実行を促す。
|
|
34
34
|
|
|
35
35
|
### 2. テンプレートの準備
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
SCRIPT_DIR=$(for d in .
|
|
39
|
-
cp "$SCRIPT_DIR/templates/project/04-design/03-screen-design.md" "docs/project/design/03-screen-design.md"
|
|
38
|
+
SCRIPT_DIR=$(for d in .claude .agents; do [ -d "$d" ] && echo "$d" && break; done)
|
|
39
|
+
cp "$SCRIPT_DIR/templates/project/04-design/03-screen-design.md" "docs/project/04-design/03-screen-design.md"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
### 3. 画面の抽出と提案
|
|
@@ -63,7 +63,7 @@ cp "$SCRIPT_DIR/templates/project/04-design/03-screen-design.md" "docs/project/d
|
|
|
63
63
|
|
|
64
64
|
### 6. ドキュメント作成
|
|
65
65
|
|
|
66
|
-
`docs/project/design/03-screen-design.md` に以下を記入する:
|
|
66
|
+
`docs/project/04-design/03-screen-design.md` に以下を記入する:
|
|
67
67
|
|
|
68
68
|
- 画面一覧テーブル
|
|
69
69
|
- 画面遷移図(Mermaid)
|
|
@@ -72,9 +72,9 @@ cp "$SCRIPT_DIR/templates/project/04-design/03-screen-design.md" "docs/project/d
|
|
|
72
72
|
### 7. 構造チェック
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
grep "## 画面一覧" docs/project/design/03-screen-design.md \
|
|
76
|
-
&& grep "\`\`\`mermaid" docs/project/design/03-screen-design.md \
|
|
77
|
-
&& grep "## レスポンシブデザインポリシー" docs/project/design/03-screen-design.md \
|
|
75
|
+
grep "## 画面一覧" docs/project/04-design/03-screen-design.md \
|
|
76
|
+
&& grep "\`\`\`mermaid" docs/project/04-design/03-screen-design.md \
|
|
77
|
+
&& grep "## レスポンシブデザインポリシー" docs/project/04-design/03-screen-design.md \
|
|
78
78
|
&& echo "OK" || echo "MISSING SECTION"
|
|
79
79
|
```
|
|
80
80
|
|
|
@@ -83,13 +83,13 @@ grep "## 画面一覧" docs/project/design/03-screen-design.md \
|
|
|
83
83
|
### 8. Git への追加(任意)
|
|
84
84
|
|
|
85
85
|
```bash
|
|
86
|
-
git add docs/project/design/03-screen-design.md
|
|
86
|
+
git add docs/project/04-design/03-screen-design.md
|
|
87
87
|
git commit -m "docs: 画面設計ドキュメントの作成"
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
## 完了条件
|
|
91
91
|
|
|
92
|
-
- `docs/project/design/03-screen-design.md` が作成されている。
|
|
92
|
+
- `docs/project/04-design/03-screen-design.md` が作成されている。
|
|
93
93
|
- 全画面のリストと役割が定義されている。
|
|
94
94
|
- 画面遷移が可視化されている。
|
|
95
95
|
- レスポンシブ対応方針が明確になっている。
|
|
@@ -6,16 +6,16 @@ SKILL.md 手順7〜8 で使う確認コマンドとレビュー観点。
|
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
# 画面一覧セクションの確認
|
|
9
|
-
grep "## 画面一覧" docs/project/design/03-screen-design.md && echo "OK" || echo "MISSING: Screen list"
|
|
9
|
+
grep "## 画面一覧" docs/project/04-design/03-screen-design.md && echo "OK" || echo "MISSING: Screen list"
|
|
10
10
|
# 画面遷移図の確認
|
|
11
|
-
grep "\`\`\`mermaid" docs/project/design/03-screen-design.md && echo "OK" || echo "MISSING: Flowchart"
|
|
11
|
+
grep "\`\`\`mermaid" docs/project/04-design/03-screen-design.md && echo "OK" || echo "MISSING: Flowchart"
|
|
12
12
|
# レスポンシブポリシーの確認
|
|
13
|
-
grep "## レスポンシブデザインポリシー" docs/project/design/03-screen-design.md && echo "OK" || echo "MISSING: Responsive policy"
|
|
13
|
+
grep "## レスポンシブデザインポリシー" docs/project/04-design/03-screen-design.md && echo "OK" || echo "MISSING: Responsive policy"
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## チェックリスト
|
|
17
17
|
|
|
18
|
-
- [ ] `docs/project/design/03-screen-design.md` が作成されている
|
|
18
|
+
- [ ] `docs/project/04-design/03-screen-design.md` が作成されている
|
|
19
19
|
- [ ] 主要な画面がすべて網羅されている
|
|
20
20
|
- [ ] 各画面の URL パスとアクセス権限が定義されている
|
|
21
21
|
- [ ] Empty State / Loading / Error の各状態が考慮されている
|
|
@@ -33,7 +33,7 @@ grep "## レスポンシブデザインポリシー" docs/project/design/03-scre
|
|
|
33
33
|
## Git への追加(任意)
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
git add docs/project/design/03-screen-design.md
|
|
36
|
+
git add docs/project/04-design/03-screen-design.md
|
|
37
37
|
git status
|
|
38
38
|
```
|
|
39
39
|
|
|
@@ -15,23 +15,23 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
15
15
|
|
|
16
16
|
## 前提
|
|
17
17
|
|
|
18
|
-
- `docs/project/design/03-screen-design.md` が作成されている(画面設計完了)
|
|
19
|
-
- `docs/project/design/01-tech-stack.md` が作成されている(UI フレームワーク決定)
|
|
18
|
+
- `docs/project/04-design/03-screen-design.md` が作成されている(画面設計完了)
|
|
19
|
+
- `docs/project/04-design/01-tech-stack.md` が作成されている(UI フレームワーク決定)
|
|
20
20
|
|
|
21
21
|
## 手順
|
|
22
22
|
|
|
23
23
|
### 1. 既存ドキュメントの確認
|
|
24
24
|
|
|
25
|
-
- `docs/project/design/01-tech-stack.md` — 使用する CSS フレームワーク(Tailwind, MUI 等)
|
|
26
|
-
- `docs/project/design/03-screen-design.md` — 画面設計とレスポンシブポリシー
|
|
25
|
+
- `docs/project/04-design/01-tech-stack.md` — 使用する CSS フレームワーク(Tailwind, MUI 等)
|
|
26
|
+
- `docs/project/04-design/03-screen-design.md` — 画面設計とレスポンシブポリシー
|
|
27
27
|
- ブランドガイドラインがあれば参照
|
|
28
28
|
|
|
29
29
|
### 2. テンプレートの準備
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
SCRIPT_DIR=$(for d in .
|
|
32
|
+
SCRIPT_DIR=$(for d in .claude .agents; do [ -d "$d" ] && echo "$d" && break; done)
|
|
33
33
|
cp "$SCRIPT_DIR/templates/project/04-design/04-design-system.md" \
|
|
34
|
-
"docs/project/design/04-design-system.md"
|
|
34
|
+
"docs/project/04-design/04-design-system.md"
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
### 3. カラーパレットの定義
|
|
@@ -84,7 +84,7 @@ CSS 変数のサンプルは [examples/css-tokens.md](examples/css-tokens.md#カ
|
|
|
84
84
|
|
|
85
85
|
### 9. ドキュメント作成
|
|
86
86
|
|
|
87
|
-
`docs/project/design/04-design-system.md` に以下を必須セクションとして記入:
|
|
87
|
+
`docs/project/04-design/04-design-system.md` に以下を必須セクションとして記入:
|
|
88
88
|
|
|
89
89
|
- カラーパレット
|
|
90
90
|
- タイポグラフィ
|
|
@@ -102,7 +102,7 @@ CSS 変数のサンプルは [examples/css-tokens.md](examples/css-tokens.md#カ
|
|
|
102
102
|
### 11. Git への追加(オプション)
|
|
103
103
|
|
|
104
104
|
```bash
|
|
105
|
-
git add docs/project/design/04-design-system.md
|
|
105
|
+
git add docs/project/04-design/04-design-system.md
|
|
106
106
|
git status
|
|
107
107
|
```
|
|
108
108
|
|
|
@@ -117,7 +117,7 @@ docs: デザインシステムの定義
|
|
|
117
117
|
|
|
118
118
|
## 完了条件
|
|
119
119
|
|
|
120
|
-
- `docs/project/design/04-design-system.md` が作成されている
|
|
120
|
+
- `docs/project/04-design/04-design-system.md` が作成されている
|
|
121
121
|
- カラー・タイポグラフィ・スペーシングが定義されている
|
|
122
122
|
- 主要コンポーネントのスタイルが定義されている
|
|
123
123
|
- ユーザーが内容を承認している
|
|
@@ -16,10 +16,10 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
16
16
|
|
|
17
17
|
## 前提
|
|
18
18
|
|
|
19
|
-
- `docs/project/domain/01-domain-model.md` が作成されていること。
|
|
20
|
-
- `docs/project/design/01-tech-stack.md` が作成されていること(DB 選定済み)。
|
|
21
|
-
- `docs/project/design/03-screen-design.md` が作成されていること。
|
|
22
|
-
- `docs/project/design/` ディレクトリが存在すること。
|
|
19
|
+
- `docs/project/03-domain/01-domain-model.md` が作成されていること。
|
|
20
|
+
- `docs/project/04-design/01-tech-stack.md` が作成されていること(DB 選定済み)。
|
|
21
|
+
- `docs/project/04-design/03-screen-design.md` が作成されていること。
|
|
22
|
+
- `docs/project/04-design/` ディレクトリが存在すること。
|
|
23
23
|
|
|
24
24
|
## 手順
|
|
25
25
|
|
|
@@ -27,17 +27,17 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
|
27
27
|
|
|
28
28
|
以下を読み込む:
|
|
29
29
|
|
|
30
|
-
- `docs/project/domain/01-domain-model.md`
|
|
31
|
-
- `docs/project/design/01-tech-stack.md`
|
|
32
|
-
- `docs/project/design/03-screen-design.md`
|
|
30
|
+
- `docs/project/03-domain/01-domain-model.md`
|
|
31
|
+
- `docs/project/04-design/01-tech-stack.md`
|
|
32
|
+
- `docs/project/04-design/03-screen-design.md`
|
|
33
33
|
|
|
34
34
|
不足があれば対応スキルの実行を促す。
|
|
35
35
|
|
|
36
36
|
### 2. テンプレートの準備
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
|
-
SCRIPT_DIR=$(for d in .
|
|
40
|
-
cp "$SCRIPT_DIR/templates/project/04-design/05-data-model.md" "docs/project/design/05-data-model.md"
|
|
39
|
+
SCRIPT_DIR=$(for d in .claude .agents; do [ -d "$d" ] && echo "$d" && break; done)
|
|
40
|
+
cp "$SCRIPT_DIR/templates/project/04-design/05-data-model.md" "docs/project/04-design/05-data-model.md"
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
### 3. エンティティの抽出と提案
|
|
@@ -78,7 +78,7 @@ cp "$SCRIPT_DIR/templates/project/04-design/05-data-model.md" "docs/project/desi
|
|
|
78
78
|
|
|
79
79
|
### 6. ドキュメント作成
|
|
80
80
|
|
|
81
|
-
`docs/project/design/05-data-model.md` に以下を記入する:
|
|
81
|
+
`docs/project/04-design/05-data-model.md` に以下を記入する:
|
|
82
82
|
|
|
83
83
|
- エンティティ一覧
|
|
84
84
|
- リレーションシップ定義
|
|
@@ -88,9 +88,9 @@ cp "$SCRIPT_DIR/templates/project/04-design/05-data-model.md" "docs/project/desi
|
|
|
88
88
|
### 7. 構造チェック
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
|
-
grep "## エンティティ一覧" docs/project/design/05-data-model.md \
|
|
92
|
-
&& grep "\`\`\`mermaid" docs/project/design/05-data-model.md \
|
|
93
|
-
&& grep "## リレーションシップ" docs/project/design/05-data-model.md \
|
|
91
|
+
grep "## エンティティ一覧" docs/project/04-design/05-data-model.md \
|
|
92
|
+
&& grep "\`\`\`mermaid" docs/project/04-design/05-data-model.md \
|
|
93
|
+
&& grep "## リレーションシップ" docs/project/04-design/05-data-model.md \
|
|
94
94
|
&& echo "OK" || echo "MISSING SECTION"
|
|
95
95
|
```
|
|
96
96
|
|
|
@@ -99,13 +99,13 @@ grep "## エンティティ一覧" docs/project/design/05-data-model.md \
|
|
|
99
99
|
### 8. Git への追加(任意)
|
|
100
100
|
|
|
101
101
|
```bash
|
|
102
|
-
git add docs/project/design/05-data-model.md
|
|
102
|
+
git add docs/project/04-design/05-data-model.md
|
|
103
103
|
git commit -m "docs: データモデル(ERD)の定義"
|
|
104
104
|
```
|
|
105
105
|
|
|
106
106
|
## 完了条件
|
|
107
107
|
|
|
108
|
-
- `docs/project/design/05-data-model.md` が作成されている。
|
|
108
|
+
- `docs/project/04-design/05-data-model.md` が作成されている。
|
|
109
109
|
- データベーススキーマ(テーブル、カラム、型、制約)が定義されている。
|
|
110
110
|
- エンティティ間の関係性が可視化(ERD)されている。
|
|
111
111
|
- ユーザーが内容を承認している。
|
|
@@ -6,16 +6,16 @@ SKILL.md 手順7〜8 で使う確認コマンドとレビュー観点。
|
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
# エンティティ一覧の確認
|
|
9
|
-
grep "## エンティティ一覧" docs/project/design/05-data-model.md && echo "OK" || echo "MISSING: Entities"
|
|
9
|
+
grep "## エンティティ一覧" docs/project/04-design/05-data-model.md && echo "OK" || echo "MISSING: Entities"
|
|
10
10
|
# ERD の確認
|
|
11
|
-
grep "\`\`\`mermaid" docs/project/design/05-data-model.md && echo "OK" || echo "MISSING: ERD"
|
|
11
|
+
grep "\`\`\`mermaid" docs/project/04-design/05-data-model.md && echo "OK" || echo "MISSING: ERD"
|
|
12
12
|
# リレーションシップ定義の確認
|
|
13
|
-
grep "## リレーションシップ" docs/project/design/05-data-model.md && echo "OK" || echo "MISSING: Relationships"
|
|
13
|
+
grep "## リレーションシップ" docs/project/04-design/05-data-model.md && echo "OK" || echo "MISSING: Relationships"
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## チェックリスト
|
|
17
17
|
|
|
18
|
-
- [ ] `docs/project/design/05-data-model.md` が作成されている
|
|
18
|
+
- [ ] `docs/project/04-design/05-data-model.md` が作成されている
|
|
19
19
|
- [ ] 全エンティティの物理名・論理名が定義されている
|
|
20
20
|
- [ ] 各カラムの型・制約・デフォルト値が定義されている
|
|
21
21
|
- [ ] 主キー戦略(Auto Increment / UUID / CUID)が明記されている
|
|
@@ -42,7 +42,7 @@ grep "## リレーションシップ" docs/project/design/05-data-model.md && ec
|
|
|
42
42
|
## Git への追加(任意)
|
|
43
43
|
|
|
44
44
|
```bash
|
|
45
|
-
git add docs/project/design/05-data-model.md
|
|
45
|
+
git add docs/project/04-design/05-data-model.md
|
|
46
46
|
git status
|
|
47
47
|
```
|
|
48
48
|
|