@k2works/claude-code-booster 0.23.0 → 1.0.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 (59) hide show
  1. package/lib/assets/.claude/README.md +96 -80
  2. package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -0
  3. package/lib/assets/.claude/settings.local.json +2 -8
  4. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -0
  5. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -0
  6. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -0
  7. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -0
  8. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -0
  9. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +87 -0
  10. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -0
  11. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -0
  12. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -0
  13. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -0
  14. package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -0
  15. package/lib/assets/.claude/skills/developing-backend/SKILL.md +89 -0
  16. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +79 -0
  17. package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -0
  18. package/lib/assets/.claude/skills/managing-docs/SKILL.md +195 -0
  19. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -0
  20. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -0
  21. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -0
  22. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -0
  23. package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -0
  24. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +103 -0
  25. package/lib/assets/.claude/{commands/dev.md → skills/orchestrating-development/SKILL.md} +42 -49
  26. package/lib/assets/.claude/{commands/plan.md → skills/planning-releases/SKILL.md} +222 -290
  27. package/lib/assets/.claude/{commands/plan-github.md → skills/syncing-github-project/SKILL.md} +78 -159
  28. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -0
  29. package/lib/assets/.mcp.json +12 -0
  30. package/lib/assets/CLAUDE.md +71 -230
  31. package/lib/assets/README.md +38 -3
  32. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +442 -0
  33. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273.md +205 -0
  34. package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/350/250/210/347/224/273.md +280 -0
  35. package/lib/assets/ops/scripts/mkdocs.js +71 -105
  36. package/lib/assets/ops/scripts/release.js +431 -0
  37. package/lib/assets/ops/scripts/ssh.js +190 -0
  38. package/package.json +1 -1
  39. package/lib/assets/.claude/.mcp.json +0 -45
  40. package/lib/assets/.claude/COMMAND_TEMPLATE.md +0 -122
  41. package/lib/assets/.claude/commands/adr.md +0 -177
  42. package/lib/assets/.claude/commands/analysis-architecture.md +0 -98
  43. package/lib/assets/.claude/commands/analysis-data-model.md +0 -94
  44. package/lib/assets/.claude/commands/analysis-domain-model.md +0 -101
  45. package/lib/assets/.claude/commands/analysis-non-functional.md +0 -103
  46. package/lib/assets/.claude/commands/analysis-operation.md +0 -104
  47. package/lib/assets/.claude/commands/analysis-requirements.md +0 -100
  48. package/lib/assets/.claude/commands/analysis-tech-stack.md +0 -113
  49. package/lib/assets/.claude/commands/analysis-test-strategy.md +0 -101
  50. package/lib/assets/.claude/commands/analysis-ui-design.md +0 -100
  51. package/lib/assets/.claude/commands/analysis-usecases.md +0 -100
  52. package/lib/assets/.claude/commands/analysis.md +0 -103
  53. package/lib/assets/.claude/commands/dev-backend.md +0 -144
  54. package/lib/assets/.claude/commands/dev-frontend.md +0 -126
  55. package/lib/assets/.claude/commands/docs.md +0 -335
  56. package/lib/assets/.claude/commands/git-commit.md +0 -47
  57. package/lib/assets/.claude/commands/kill.md +0 -109
  58. package/lib/assets/.claude/commands/ops.md +0 -508
  59. package/lib/assets/.claude/commands/progress.md +0 -245
@@ -8,7 +8,7 @@ Claude Code をより効率的に使うための基本設定テンプレート
8
8
 
9
9
  3 つの機能で Claude Code の動作をカスタマイズできます。
10
10
 
11
- - **Commands**: `/` で始まるカスタムコマンド
11
+ - **Skills**: タスクに応じて自動発動する専門スキル(Progressive Disclosure)
12
12
  - **Roles**: 専門家の視点で回答するための役割設定
13
13
  - **Hooks**: 特定のタイミングでスクリプトを自動実行
14
14
 
@@ -16,55 +16,67 @@ Claude Code をより効率的に使うための基本設定テンプレート
16
16
 
17
17
  ## 機能一覧
18
18
 
19
- ### Commands(カスタムコマンド)
19
+ ### Skills(スキル)
20
20
 
21
- `commands/` ディレクトリ内の Markdown ファイルとして保存されています。`/` に続けてファイル名を入力すると実行できます。
21
+ `skills/` ディレクトリ内の `SKILL.md` ファイルとして保存されています。タスク内容に応じて自動的に発動し、必要な指示をコンテキストに読み込みます。
22
22
 
23
- #### 分析系コマンド
23
+ #### オーケストレーション
24
24
 
25
- | コマンド | 説明 |
26
- | :------------------------- | :--------------------------------------------------------- |
27
- | `/analysis` | 分析フェーズ全体の作業を支援。要件定義から非機能要件まで包括的な分析ワークフローを表示。 |
28
- | `/analysis-requirements` | RDRA モデルに基づいた体系的な要件定義を作成。 |
29
- | `/analysis-usecases` | ユースケース・ユーザーストーリー作成を支援。トレーサビリティを維持。 |
30
- | `/analysis-architecture` | 業務領域とデータ構造の複雑さに基づくアーキテクチャパターンの選択を支援。 |
31
- | `/analysis-data-model` | PlantUML の ER 図を使用してデータモデルを設計。 |
32
- | `/analysis-domain-model` | DDD の戦術的設計パターンに基づくドメインモデルを設計。 |
33
- | `/analysis-ui-design` | 画面遷移図と画面イメージを PlantUML で設計。 |
34
- | `/analysis-tech-stack` | 表形式の技術スタック一覧を作成。 |
35
- | `/analysis-test-strategy` | ピラミッド型・ダイヤモンド型・逆ピラミッド型テストの選択を支援。 |
36
- | `/analysis-non-functional` | 性能、セキュリティ、可用性などの非機能要件を定義。 |
37
- | `/analysis-operation` | 運用フロー、監視、バックアップなどの運用要件を定義。 |
25
+ | スキル | 説明 |
26
+ | :--- | :--- |
27
+ | `orchestrating-analysis` | 分析フェーズ全体のワークフローをオーケストレーション。各 analyzing-* スキルの実行順序を案内。 |
28
+ | `orchestrating-development` | 開発フェーズ全体の TDD ワークフローをオーケストレーション。Codex 分業体制を案内。 |
38
29
 
39
- #### 開発系コマンド
30
+ #### 分析系
40
31
 
41
- | コマンド | 説明 |
42
- | :-------------- | :----------------------------------------------------------- |
43
- | `/dev` | 開発フェーズ全体の作業を支援。TDD サイクルに従った開発ワークフローを表示。 |
44
- | `/dev-backend` | バックエンド開発のためのコーディングとテストガイドを参照。 |
45
- | `/dev-frontend` | フロントエンド開発のためのコーディングとテストガイドを参照。 |
32
+ | スキル | 説明 |
33
+ | :--- | :--- |
34
+ | `analyzing-requirements` | RDRA 2.0 に基づいた体系的な要件定義を作成。 |
35
+ | `analyzing-usecases` | ユースケース・ユーザーストーリー作成を支援。 |
36
+ | `analyzing-architecture` | アーキテクチャパターンの選択と設計ドキュメント作成。 |
37
+ | `analyzing-data-model` | ER 図作成、テーブル定義、リレーション設計。 |
38
+ | `analyzing-domain-model` | エンティティ、値オブジェクト、集約の設計。 |
39
+ | `analyzing-ui-design` | 画面遷移図と画面イメージを設計。 |
40
+ | `analyzing-tech-stack` | フレームワーク、ライブラリ、インフラの選定と評価。 |
41
+ | `analyzing-test-strategy` | テストピラミッド設計、テスト種別の定義、カバレッジ目標の設定。 |
42
+ | `analyzing-non-functional` | 性能、セキュリティ、可用性、保守性の要件策定。 |
43
+ | `analyzing-operation` | 運用フロー、監視設計、障害対応手順の策定。 |
46
44
 
47
- #### 計画・進捗系コマンド
45
+ #### 開発系
48
46
 
49
- | コマンド | 説明 |
50
- | :------------- | :----------------------------------------------------------- |
51
- | `/plan` | アジャイルなリリース計画とイテレーション計画を作成・管理。 |
52
- | `/plan-github` | リリース計画を GitHub Project・Issue・Milestone に同期。 |
53
- | `/progress` | プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告。 |
47
+ | スキル | 説明 |
48
+ | :--- | :--- |
49
+ | `developing-backend` | バックエンド開発の TDD ワークフロー。インサイドアウトアプローチ。 |
50
+ | `developing-frontend` | フロントエンド開発の TDD ワークフロー。アウトサイドインアプローチ。 |
54
51
 
55
- #### 運用系コマンド
52
+ #### 計画・進捗系
56
53
 
57
- | コマンド | 説明 |
58
- | :------- | :--------------------------------------------------------------------- |
59
- | `/ops` | アプリケーションの運用・構築・配置を統括的に管理。本番環境への安全かつ効率的なデプロイを実現。 |
60
- | `/kill` | 開発サーバーや Node.js プロセスを強制終了。複数ポートで起動している開発プロセスを一括停止。 |
54
+ | スキル | 説明 |
55
+ | :--- | :--- |
56
+ | `planning-releases` | アジャイルなリリース計画とイテレーション計画を作成・管理。 |
57
+ | `syncing-github-project` | リリース計画を GitHub Project・Issue・Milestone に同期。 |
58
+ | `tracking-progress` | プロジェクトの開発進捗を包括的に分析しレポート生成。 |
61
59
 
62
- #### ドキュメント・Git 系コマンド
60
+ #### 運用系
63
61
 
64
- | コマンド | 説明 |
65
- | :------------ | :------------------------------------------------- |
66
- | `/docs` | 設計ドキュメントの一覧表示、進捗確認、内容参照。 |
67
- | `/git-commit` | 意味のある変更単位ごとにコミットを作成。 |
62
+ | スキル | 説明 |
63
+ | :--- | :--- |
64
+ | `managing-operations` | 環境構築、デプロイ、監視、バックアップ、日次運用タスクの実行。 |
65
+ | `killing-processes` | 開発サーバーや Node.js プロセスを強制終了。ポート競合の解決。 |
66
+
67
+ #### ドキュメント・Git 系
68
+
69
+ | スキル | 説明 |
70
+ | :--- | :--- |
71
+ | `managing-docs` | 設計ドキュメントの一覧表示、進捗確認、インデックス更新、Markdown Lint。 |
72
+ | `git-commit` | 意味のある変更単位ごとにコミットを作成。Conventional Commits 準拠。 |
73
+ | `creating-adr` | Architecture Decision Record の作成を支援。 |
74
+
75
+ #### 共通
76
+
77
+ | スキル | 説明 |
78
+ | :--- | :--- |
79
+ | `ai-agent-guidelines` | AI Agent の実行ガイドライン。TDD サイクル、品質保証、完了報告のルール。 |
68
80
 
69
81
  ### Roles(役割設定)
70
82
 
@@ -76,16 +88,16 @@ Claude Code をより効率的に使うための基本設定テンプレート
76
88
 
77
89
  `settings.json` で設定して、開発作業を自動化できます。
78
90
 
79
- | 実行スクリプト | イベント | 説明 |
80
- | :----------------------------- | :------------ | :------------------------------------------------------------------- |
81
- | `deny-check.sh` | `PreToolUse` | `rm -rf /` のような危険なコマンドの実行を未然に防ぐ。 |
82
- | `check-ai-commit.sh` | `PreToolUse` | `git commit` でコミットメッセージに AI の署名が含まれている場合にエラーを出す。 |
91
+ | 実行スクリプト | イベント | 説明 |
92
+ | :--- | :--- | :--- |
93
+ | `deny-check.sh` | `PreToolUse` | `rm -rf /` のような危険なコマンドの実行を未然に防ぐ。 |
94
+ | `check-ai-commit.sh` | `PreToolUse` | `git commit` でコミットメッセージに AI の署名が含まれている場合にエラーを出す。 |
83
95
  | `preserve-file-permissions.sh` | `PreToolUse` / `PostToolUse` | ファイル編集前に元の権限を保存し、編集後に復元する。 |
84
- | `ja-space-format.sh` | `PostToolUse` | ファイル保存時に、日本語と英数字の間のスペースを自動で整形する。 |
85
- | `auto-comment.sh` | `PostToolUse` | 新規ファイル作成時や大幅な編集時に、docstring の追加を促す。 |
86
- | `(osascript)` | `Notification` | Claude がユーザーの確認を待っている時に、macOS の通知センターでお知らせする。 |
87
- | `check-continue.sh` | `Stop` | タスク完了時に、継続可能なタスクがないか確認する。 |
88
- | `(osascript)` | `Stop` | 全タスク完了時に、macOS の通知センターで完了を知らせる。 |
96
+ | `ja-space-format.sh` | `PostToolUse` | ファイル保存時に、日本語と英数字の間のスペースを自動で整形する。 |
97
+ | `auto-comment.sh` | `PostToolUse` | 新規ファイル作成時や大幅な編集時に、docstring の追加を促す。 |
98
+ | `(osascript)` | `Notification` | Claude がユーザーの確認を待っている時に、macOS の通知センターでお知らせする。 |
99
+ | `check-continue.sh` | `Stop` | タスク完了時に、継続可能なタスクがないか確認する。 |
100
+ | `(osascript)` | `Stop` | 全タスク完了時に、macOS の通知センターで完了を知らせる。 |
89
101
 
90
102
  **注意**: スクリプトファイルは `scripts/` ディレクトリに配置する必要があります。このテンプレートには `.gitkeep` のみが含まれているため、実際のスクリプトは `~/.claude/scripts/` から参照するか、プロジェクトに合わせて作成してください。
91
103
 
@@ -96,45 +108,49 @@ Claude Code をより効率的に使うための基本設定テンプレート
96
108
  ```
97
109
  .claude/
98
110
  ├── agents/
99
- │ └── roles/ # 役割定義ファイル(.md)
100
- ├── assets/ # 通知音などのアセット
101
- ├── commands/ # カスタムコマンド(.md)
102
- ├── analysis.md
103
- │ ├── analysis-architecture.md
104
- │ ├── analysis-data-model.md
105
- │ ├── analysis-domain-model.md
106
- │ ├── analysis-non-functional.md
107
- │ ├── analysis-operation.md
108
- │ ├── analysis-requirements.md
109
- │ ├── analysis-tech-stack.md
110
- │ ├── analysis-test-strategy.md
111
- │ ├── analysis-ui-design.md
112
- │ ├── analysis-usecases.md
113
- │ ├── dev.md
114
- │ ├── dev-backend.md
115
- │ ├── dev-frontend.md
116
- │ ├── docs.md
117
- │ ├── git-commit.md
118
- │ ├── kill.md
119
- │ ├── ops.md
120
- │ ├── plan.md
121
- │ ├── plan-github.md
122
- └── progress.md
123
- ├── scripts/ # Hooks 用スクリプト
124
- ├── .gitignore
125
- ├── .mcp.json # MCP サーバー設定
126
- ├── COMMAND_TEMPLATE.md # コマンド作成テンプレート
111
+ │ └── roles/ # 役割定義ファイル(.md)
112
+ ├── assets/ # 通知音などのアセット
113
+ ├── scripts/ # Hooks 用スクリプト
114
+ ├── skills/ # スキル定義(SKILL.md + 参照ファイル)
115
+ │ ├── ai-agent-guidelines/SKILL.md
116
+ │ ├── git-commit/SKILL.md
117
+ │ ├── creating-adr/SKILL.md
118
+ │ ├── analyzing-requirements/SKILL.md
119
+ │ ├── analyzing-usecases/SKILL.md
120
+ │ ├── analyzing-architecture/SKILL.md
121
+ │ ├── analyzing-data-model/SKILL.md
122
+ │ ├── analyzing-domain-model/SKILL.md
123
+ │ ├── analyzing-ui-design/SKILL.md
124
+ │ ├── analyzing-tech-stack/SKILL.md
125
+ │ ├── analyzing-test-strategy/SKILL.md
126
+ │ ├── analyzing-non-functional/SKILL.md
127
+ │ ├── analyzing-operation/SKILL.md
128
+ │ ├── developing-backend/SKILL.md
129
+ │ ├── developing-frontend/SKILL.md
130
+ │ ├── killing-processes/SKILL.md
131
+ │ ├── managing-operations/
132
+ ├── SKILL.md
133
+ ├── SETUP_JAVA.md
134
+ │ ├── SETUP_FRONTEND.md
135
+ │ │ ├── SETUP_CSHARP.md
136
+ │ │ └── DEPLOY.md
137
+ ├── managing-docs/SKILL.md
138
+ ├── tracking-progress/SKILL.md
139
+ │ ├── syncing-github-project/SKILL.md
140
+ │ ├── planning-releases/SKILL.md
141
+ │ ├── orchestrating-analysis/SKILL.md
142
+ │ └── orchestrating-development/SKILL.md
143
+ ├── SKILLS_TEMPLATE.md # スキル作成テンプレート
127
144
  ├── README.md
128
- ├── settings.json # Claude Code 設定
129
- └── settings.local.json # ローカル環境用設定
145
+ ├── settings.json # Claude Code 設定
146
+ └── settings.local.json # ローカル環境用設定
130
147
  ```
131
148
 
132
149
  ---
133
150
 
134
151
  ## カスタマイズ
135
152
 
136
- - **コマンドの追加**: `commands/` に `.md` ファイルを追加するだけです
153
+ - **スキルの追加**: `skills/<skill-name>/SKILL.md` を作成するだけです
137
154
  - **ロールの追加**: `agents/roles/` に `.md` ファイルを追加するだけです
138
155
  - **Hooks の編集**: `settings.json` を編集して、自動化処理を変更できます
139
156
  - **スクリプトの追加**: `scripts/` にシェルスクリプトを追加し、`settings.json` で参照します
140
-
@@ -0,0 +1,100 @@
1
+ # スキル作成テンプレート
2
+
3
+ 新しいスキルを作成する際のテンプレートです。
4
+
5
+ ## ファイル構成
6
+
7
+ ```
8
+ skills/<skill-name>/
9
+ ├── SKILL.md # メインのスキル定義(必須、500 行以内)
10
+ ├── REFERENCE_1.md # 参照ファイル(任意、内容が多い場合に分割)
11
+ └── REFERENCE_2.md # 参照ファイル(任意)
12
+ ```
13
+
14
+ ## 命名規則
15
+
16
+ - **ディレクトリ名**: 動名詞形(-ing)を採用(例: `analyzing-requirements`, `developing-backend`)
17
+ - **name フィールド**: 小文字・数字・ハイフンのみ、64 文字以内
18
+ - **description フィールド**: 1024 文字以内、「何をするか」+「いつ使うか」を含める
19
+
20
+ ## SKILL.md テンプレート
21
+
22
+ ```markdown
23
+ ---
24
+ name: skill-name
25
+ description: 何をするスキルか。いつ使うかのトリガー条件。
26
+ ---
27
+
28
+ # スキルのタイトル
29
+
30
+ スキルの簡潔な説明(1-2 行で何をするスキルか説明)。
31
+
32
+ ## Instructions
33
+
34
+ ### 1. セクション名
35
+
36
+ 内容を記述。
37
+
38
+ - 箇条書きで要点を整理
39
+ - 参照ドキュメントは `@docs/path/to/file.md` 形式で指定
40
+
41
+ ### 2. セクション名
42
+
43
+ #### サブセクション
44
+
45
+ 詳細な内容を記述。
46
+
47
+ ### 3. 注意事項
48
+
49
+ - **前提条件**: スキル実行に必要な前提条件
50
+ - **制限事項**: 機能の制限や注意すべき点
51
+ - **推奨事項**: 効果的な使用方法の推奨
52
+
53
+ ### 4. ベストプラクティス
54
+
55
+ 1. **原則 1**: 推奨される方法の説明
56
+ 2. **原則 2**: 避けるべき方法の説明
57
+
58
+ ### 関連スキル
59
+
60
+ - `related-skill-1` : 関連する機能を持つスキル
61
+ - `related-skill-2` : 組み合わせて使うと効果的なスキル
62
+ ```
63
+
64
+ ## YAML フロントマターのルール
65
+
66
+ | フィールド | 必須 | 制約 |
67
+ | :--- | :--- | :--- |
68
+ | `name` | 必須 | 小文字・数字・ハイフンのみ、64 文字以内 |
69
+ | `description` | 必須 | 1024 文字以内 |
70
+
71
+ ## 作成時のチェックリスト
72
+
73
+ - [ ] `name` が小文字・数字・ハイフンのみで 64 文字以内
74
+ - [ ] `description` が 1024 文字以内
75
+ - [ ] `description` に「何をするか」と「いつ使うか」の両方を含む
76
+ - [ ] SKILL.md が 500 行以内(超過分は参照ファイルに分割)
77
+ - [ ] 参照ファイルがある場合、SKILL.md から `@` パスでリンクしている
78
+ - [ ] 三人称で記述されている
79
+ - [ ] 関連スキルセクションでスキル名を正しく参照している
80
+
81
+ ## 大容量コンテンツの分割例
82
+
83
+ SKILL.md が 500 行を超える場合、参照ファイルに分割します。
84
+
85
+ ```
86
+ skills/managing-operations/
87
+ ├── SKILL.md # コア指示(概要、オプション一覧、基本例)
88
+ ├── SETUP_JAVA.md # Java 環境構築の詳細
89
+ ├── SETUP_FRONTEND.md # TypeScript/React 環境構築の詳細
90
+ └── DEPLOY.md # デプロイ・運用監視の詳細
91
+ ```
92
+
93
+ SKILL.md から参照ファイルを指す場合:
94
+
95
+ ```markdown
96
+ ### 環境構築の詳細
97
+
98
+ - **Java**: @.claude/skills/managing-operations/SETUP_JAVA.md
99
+ - **TypeScript/React**: @.claude/skills/managing-operations/SETUP_FRONTEND.md
100
+ ```
@@ -1,13 +1,7 @@
1
1
  {
2
2
  "permissions": {
3
- "allow": [
4
- "Bash(gh repo view:*)",
5
- "Bash(gh issue list:*)",
6
- "mcp__byterover-mcp__byterover-store-knowledge",
7
- "Bash(tree:*)",
8
- "Bash(find:*)",
9
- "mcp__byterover-mcp__byterover-retrieve-knowledge"
10
- ],
3
+ "defaultMode": "plan",
4
+ "allow": [],
11
5
  "deny": [],
12
6
  "ask": []
13
7
  }
@@ -0,0 +1,87 @@
1
+ ---
2
+ name: analyzing-architecture
3
+ description: アーキテクチャ設計を支援。バックエンド・フロントエンド・インフラのアーキテクチャパターン選択と設計ドキュメント作成。アーキテクチャ設計やシステム構成の検討時に使用。
4
+ ---
5
+
6
+ # アーキテクチャ設計支援
7
+
8
+ 業務領域とデータ構造の複雑さに基づくアーキテクチャパターンの選択を支援します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. 参照ドキュメント
13
+
14
+ - @docs/reference/アーキテクチャ設計ガイド.md - アーキテクチャ設計の進め方
15
+
16
+ ### 2. 入力
17
+
18
+ - @docs/requirements/requirements_definition.md - 要件定義
19
+ - @docs/requirements/business_usecase.md - ビジネスユースケース
20
+ - @docs/requirements/system_usecase.md - システムユースケース
21
+ - @docs/requirements/user_story.md - ユーザーストーリー
22
+
23
+ ### 3. 成果物
24
+
25
+ - @docs/design/architecture_backend.md - バックエンドアーキテクチャ
26
+ - @docs/design/architecture_frontend.md - フロントエンドアーキテクチャ
27
+ - @docs/design/architecture_infrastructure.md - インフラストラクチャアーキテクチャ
28
+
29
+ ### 4. 作業内容
30
+
31
+ #### バックエンドアーキテクチャ設計
32
+
33
+ - アーキテクチャパターンの選択(レイヤード、ヘキサゴナル、クリーン等)
34
+ - CQRS/イベントソーシングの適用判断
35
+ - API 設計方針
36
+
37
+ #### フロントエンドアーキテクチャ設計
38
+
39
+ - フレームワーク選定
40
+ - 状態管理パターン
41
+ - コンポーネント設計方針
42
+
43
+ #### インフラストラクチャアーキテクチャ設計
44
+
45
+ - クラウド/オンプレミス選定
46
+ - コンテナ化戦略
47
+ - CI/CD パイプライン設計
48
+
49
+ ### 5. 注意事項
50
+
51
+ - **前提条件**: 要件定義とユースケースが完了していること
52
+ - **制限事項**: アーキテクチャ決定は ADR(Architecture Decision Record)で記録すること
53
+ - **推奨事項**: 業務の複雑さとチームのスキルセットを考慮して選択する
54
+
55
+ ### 6. 記述ルール
56
+
57
+ タスク項目などは一行開けて記述する。
58
+
59
+ OK:
60
+
61
+ ```markdown
62
+ **受入条件**:
63
+
64
+ - [ ] ログアウトボタンをクリックするとログアウトできる
65
+ - [ ] ログアウト後、ログイン画面に遷移する
66
+ ```
67
+
68
+ NG:
69
+
70
+ ```markdown
71
+ **受入条件**:
72
+ - [ ] ログアウトボタンをクリックするとログアウトできる
73
+ - [ ] ログアウト後、ログイン画面に遷移する
74
+ ```
75
+
76
+ ## Examples
77
+
78
+ ### 要件に基づくアーキテクチャ設計
79
+
80
+ 1. 要件定義とユーザーストーリーを読み込む
81
+ 2. @docs/reference/アーキテクチャ設計ガイド.md に基づいて設計
82
+ 3. バックエンド・フロントエンド・インフラの各アーキテクチャドキュメントを作成
83
+
84
+ ### 技術的制約がある場合
85
+
86
+ 1. 既存の `package.json` や `pom.xml` を確認
87
+ 2. 既存技術スタックを考慮したアーキテクチャ選択を提案
@@ -0,0 +1,80 @@
1
+ ---
2
+ name: analyzing-data-model
3
+ description: データモデル設計を支援。ER 図作成、テーブル定義、リレーション設計。データベース設計やテーブル構造の検討時に使用。
4
+ ---
5
+
6
+ # データモデル設計支援
7
+
8
+ PlantUML の ER 図を使用してデータモデルを設計します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. 参照ドキュメント
13
+
14
+ - @docs/reference/データモデル設計ガイド.md - データモデル設計の進め方
15
+
16
+ ### 2. 入力
17
+
18
+ - @docs/requirements/requirements_definition.md - 要件定義
19
+ - @docs/requirements/business_usecase.md - ビジネスユースケース
20
+ - @docs/requirements/system_usecase.md - システムユースケース
21
+ - @docs/requirements/user_story.md - ユーザーストーリー
22
+ - @docs/design/architecture_backend.md - バックエンドアーキテクチャ
23
+ - @docs/design/architecture_frontend.md - フロントエンドアーキテクチャ
24
+
25
+ ### 3. 成果物
26
+
27
+ - @docs/design/data-model.md - データモデル設計
28
+
29
+ ### 4. 作業内容
30
+
31
+ #### 概念データモデル作成
32
+
33
+ - エンティティの識別
34
+ - リレーションシップの定義
35
+
36
+ #### 論理データモデル作成
37
+
38
+ - テーブル定義
39
+ - 主キー・外部キーの設計
40
+ - 正規化の適用
41
+
42
+ #### ER 図作成
43
+
44
+ - PlantUML を使用した ER 図の作成
45
+ - テーブル間の関係の可視化
46
+
47
+ ### 5. 注意事項
48
+
49
+ - **前提条件**: 要件定義とアーキテクチャ設計が完了していること
50
+ - **制限事項**: PlantUML の ER 図を使用すること
51
+ - **推奨事項**: ドメインモデルとの整合性を確認しながら設計する
52
+
53
+ ### 6. 記述ルール
54
+
55
+ タスク項目などは一行開けて記述する。
56
+
57
+ OK:
58
+
59
+ ```markdown
60
+ **受入条件**:
61
+
62
+ - [ ] テーブル定義が完了している
63
+ - [ ] ER 図が作成されている
64
+ ```
65
+
66
+ NG:
67
+
68
+ ```markdown
69
+ **受入条件**:
70
+ - [ ] テーブル定義が完了している
71
+ - [ ] ER 図が作成されている
72
+ ```
73
+
74
+ ## Examples
75
+
76
+ ### 要件に基づくデータモデル設計
77
+
78
+ 1. 要件定義とバックエンドアーキテクチャを読み込む
79
+ 2. @docs/reference/データモデル設計ガイド.md に基づいて設計
80
+ 3. ドメインモデルとの整合性を確認しながらデータモデルを作成
@@ -0,0 +1,88 @@
1
+ ---
2
+ name: analyzing-domain-model
3
+ description: ドメインモデル設計を支援。エンティティ、値オブジェクト、集約の設計。DDD やドメインモデリングの検討時に使用。
4
+ ---
5
+
6
+ # ドメインモデル設計支援
7
+
8
+ DDD の戦術的設計パターンに基づくドメインモデルを設計します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. 参照ドキュメント
13
+
14
+ - @docs/reference/ドメインモデル設計ガイド.md - ドメインモデル設計の進め方
15
+
16
+ ### 2. 入力
17
+
18
+ - @docs/requirements/requirements_definition.md - 要件定義
19
+ - @docs/requirements/business_usecase.md - ビジネスユースケース
20
+ - @docs/requirements/system_usecase.md - システムユースケース
21
+ - @docs/requirements/user_story.md - ユーザーストーリー
22
+ - @docs/design/architecture_backend.md - バックエンドアーキテクチャ
23
+ - @docs/design/architecture_frontend.md - フロントエンドアーキテクチャ
24
+
25
+ ### 3. 成果物
26
+
27
+ - @docs/design/domain-model.md - ドメインモデル設計
28
+
29
+ ### 4. 作業内容
30
+
31
+ #### エンティティ定義
32
+
33
+ - ライフサイクルを持つドメインオブジェクトの識別
34
+ - 識別子の設計
35
+
36
+ #### 値オブジェクト定義
37
+
38
+ - 不変で識別子を持たないドメインオブジェクトの識別
39
+ - バリデーションルールの定義
40
+
41
+ #### 集約の設計
42
+
43
+ - 集約ルートの識別
44
+ - 集約境界の定義
45
+ - 不変条件の設計
46
+
47
+ #### ドメインサービス定義
48
+
49
+ - エンティティに属さないビジネスロジックの識別
50
+
51
+ #### ダイアグラム作成
52
+
53
+ - PlantUML を使用したクラス図・オブジェクト図の作成
54
+
55
+ ### 5. 注意事項
56
+
57
+ - **前提条件**: 要件定義とアーキテクチャ設計が完了していること
58
+ - **制限事項**: PlantUML を使用してダイアグラムを作成すること
59
+ - **推奨事項**: ユビキタス言語を使用してドメインエキスパートと共通認識を持つ
60
+
61
+ ### 6. 記述ルール
62
+
63
+ タスク項目などは一行開けて記述する。
64
+
65
+ OK:
66
+
67
+ ```markdown
68
+ **受入条件**:
69
+
70
+ - [ ] エンティティが定義されている
71
+ - [ ] 集約境界が明確である
72
+ ```
73
+
74
+ NG:
75
+
76
+ ```markdown
77
+ **受入条件**:
78
+ - [ ] エンティティが定義されている
79
+ - [ ] 集約境界が明確である
80
+ ```
81
+
82
+ ## Examples
83
+
84
+ ### ユースケースに基づくドメインモデル設計
85
+
86
+ 1. システムユースケースとユーザーストーリーを読み込む
87
+ 2. @docs/reference/ドメインモデル設計ガイド.md に基づいて設計
88
+ 3. エンティティ、値オブジェクト、集約を識別してドメインモデルを作成