@k2works/claude-code-booster 4.4.1 → 4.5.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 (99) hide show
  1. package/bin/claude-code-booster +2 -2
  2. package/lib/assets/.claude/agents/xp-architect.md +250 -250
  3. package/lib/assets/.claude/agents/xp-executive.md +207 -207
  4. package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -239
  5. package/lib/assets/.claude/agents/xp-product-manager.md +245 -245
  6. package/lib/assets/.claude/agents/xp-programmer.md +268 -268
  7. package/lib/assets/.claude/agents/xp-project-manager.md +229 -229
  8. package/lib/assets/.claude/agents/xp-technical-writer.md +224 -224
  9. package/lib/assets/.claude/agents/xp-tester.md +265 -265
  10. package/lib/assets/.claude/agents/xp-user-representative.md +204 -204
  11. package/lib/assets/.claude/skills/analyzing-business-case/SKILL.md +148 -148
  12. package/lib/assets/.claude/skills/analyzing-business-strategy/SKILL.md +277 -277
  13. package/lib/assets/.claude/skills/analyzing-review/SKILL.md +174 -174
  14. package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
  15. package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
  16. package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
  17. package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
  18. package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
  19. package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
  20. package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
  21. package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
  22. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +168 -168
  23. package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +266 -266
  24. package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +54 -54
  25. package/lib/assets/.devcontainer/devcontainer.json +1 -1
  26. package/lib/assets/.gitattributes +0 -2
  27. package/lib/assets/CLAUDE.md +193 -193
  28. package/lib/assets/Dockerfile +1 -6
  29. package/lib/assets/README.md +0 -16
  30. package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +1 -1
  31. package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +1 -1
  32. package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +1 -1
  33. package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +6 -6
  34. package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +3 -3
  35. package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +22 -22
  36. package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +1 -1
  37. package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +22 -22
  38. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +1 -1
  39. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +1 -1
  40. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +1 -1
  41. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +1 -1
  42. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +2 -2
  43. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +5 -5
  44. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +22 -22
  45. package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +1 -1
  46. package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +1 -1
  47. package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +1 -1
  48. package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +22 -22
  49. package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +1 -1
  50. package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +1 -1
  51. package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +3 -3
  52. package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +3 -3
  53. package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +22 -22
  54. package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +2 -2
  55. package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +8 -8
  56. package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +2 -2
  57. package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +3 -3
  58. package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +4 -4
  59. package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +8 -8
  60. package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +1 -1
  61. package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1 -1
  62. package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1 -1
  63. package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +1 -1
  64. package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +1 -1
  65. package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +1 -1
  66. package/lib/assets/docs/article/grokkingfp/java/part-1.md +1 -1
  67. package/lib/assets/docs/article/grokkingfp/java/part-2.md +4 -4
  68. package/lib/assets/docs/article/grokkingfp/java/part-6.md +2 -2
  69. package/lib/assets/docs/article/grokkingfp/python/part-1.md +3 -3
  70. package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +1 -1
  71. package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1 -1
  72. package/lib/assets/docs/article/grokkingfp/rust/part-4.md +1 -1
  73. package/lib/assets/docs/article/grokkingfp/scala/part-1.md +1 -1
  74. package/lib/assets/docs/article/grokkingfp/scala/part-3.md +1 -1
  75. package/lib/assets/docs/article/grokkingfp/scala/part-6.md +1 -1
  76. package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +1 -1
  77. package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1 -1
  78. package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +1 -1
  79. package/lib/assets/docs/article/index.md +39 -39
  80. package/lib/assets/docs/design/index.md +44 -44
  81. package/lib/assets/docs/index.md +33 -33
  82. package/lib/assets/docs/operation/index.md +16 -16
  83. package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +546 -546
  84. package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1 -1
  85. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1 -1
  86. package/lib/assets/docs/reference/Vim/346/223/215/344/275/234/343/203/236/343/203/213/343/203/245/343/202/242/343/203/253.md +13 -0
  87. package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
  88. package/lib/assets/docs/reference//347/265/214/345/226/266/346/210/246/347/225/245/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +566 -566
  89. package/lib/assets/docs/requirements/index.md +17 -17
  90. package/lib/assets/docs/strategy/index.md +17 -17
  91. 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 +327 -327
  92. package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +275 -275
  93. package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +513 -513
  94. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
  95. package/lib/assets/ops/nix/shells/.tmux.conf +2 -2
  96. package/lib/assets/ops/nix/shells/.vimrc +15 -2
  97. package/lib/assets/ops/nix/shells/shell.nix +1 -0
  98. package/package.json +1 -1
  99. package/lib/assets/.envrc +0 -1
@@ -9,43 +9,43 @@ description: イテレーション計画と上流設計ドキュメント群(
9
9
 
10
10
  ## 検証対象ドキュメント
11
11
 
12
- | # | 検証対象 | パス | 検証内容 |
13
- |---|---------|------|---------|
14
- | 1 | テンプレートフォーマット | `docs/template/イテレーション計画.md` | 見出し構成・必須セクション・表形式・コードブロック形式の一致 |
15
- | 2 | ユーザーストーリー | `docs/requirements/user_story.md` | ストーリー ID・タイトル・アクター・受入基準の一致 |
16
- | 3 | ドメインモデル | `docs/design/domain-model.md` | 集約・エンティティ・値オブジェクトの名称・構造・関連の一致 |
17
- | 4 | データモデル | `docs/design/data-model.md` | テーブル名・カラム名・型・制約・命名規約の一致 |
18
- | 5 | UI 設計(ビュー) | `docs/design/ui_design.md` | ワイヤーフレーム構造・ナビバー形式・テーブル表記・URL パスの一致 |
19
- | 6 | UI 設計(インタラクション) | `docs/design/ui_design.md` | 画面遷移・htmx パターン・PRG パターン・エラー処理・フィードバックメッセージの一致 |
20
- | 7 | ゴールの整合性 | イテレーション計画全体 | ゴール・ストーリー・設計・タスク・見積もりの内部整合性 |
21
- | 8 | 過去レビュー指摘事項 | `docs/review/` 内の最新レビューファイル | 高・中優先度の指摘がストーリーまたはタスクとして計画に反映されているか |
22
-
23
- ## 検証手順
24
-
25
- 8 ステップを順に実行する。各ステップは並列実行も可能。不整合を発見した場合はイテレーション計画を修正し、変更点を注記する。
26
-
27
- ### ステップ 1: テンプレートフォーマットとの整合性
28
-
29
- イテレーション計画全体が `docs/template/イテレーション計画.md` のフォーマットに従っているかを確認する。以降の内容整合性チェックに入る前に、見出し構成・必須セクション・表形式・コードブロック形式がテンプレートから逸脱していないことを検証する。
30
-
31
- **チェック項目**:
32
-
33
- - [ ] 文書タイトルが `# イテレーション X 計画` 形式になっている
34
- - [ ] テンプレートの主要セクション(概要、ゴール、ユーザーストーリー、スケジュール、設計、リスクと対策、完了条件、更新履歴、関連ドキュメント)が揃っている
35
- - [ ] 各セクションの見出しレベルがテンプレートと一致している
36
- - [ ] 概要、対象ストーリー、タスク、リスク、更新履歴などの表形式がテンプレートの列構成に従っている
37
- - [ ] `mermaid`、`plantuml`、`prisma` などのコードブロック種別がテンプレートと一致している
38
- - [ ] 完了条件に `Definition of Done` と `デモ項目` が含まれている
39
- - [ ] 関連ドキュメント節に最低限の参照先が記載されている
40
-
41
- **よくある不整合**:
42
-
43
- - テンプレート必須セクションの欠落(例: 「更新履歴」がない)
44
- - 見出し名や階層の変更(例: 「ユーザーストーリー」ではなく独自見出しを使用)
45
- - 表の列不足や列名変更
46
- - コードブロックの種別未指定、またはテンプレートと異なる記法
47
-
48
- ### ステップ 2: ユーザーストーリーとの整合性
12
+ | # | 検証対象 | パス | 検証内容 |
13
+ |---|---------|------|---------|
14
+ | 1 | テンプレートフォーマット | `docs/template/イテレーション計画.md` | 見出し構成・必須セクション・表形式・コードブロック形式の一致 |
15
+ | 2 | ユーザーストーリー | `docs/requirements/user_story.md` | ストーリー ID・タイトル・アクター・受入基準の一致 |
16
+ | 3 | ドメインモデル | `docs/design/domain-model.md` | 集約・エンティティ・値オブジェクトの名称・構造・関連の一致 |
17
+ | 4 | データモデル | `docs/design/data-model.md` | テーブル名・カラム名・型・制約・命名規約の一致 |
18
+ | 5 | UI 設計(ビュー) | `docs/design/ui_design.md` | ワイヤーフレーム構造・ナビバー形式・テーブル表記・URL パスの一致 |
19
+ | 6 | UI 設計(インタラクション) | `docs/design/ui_design.md` | 画面遷移・htmx パターン・PRG パターン・エラー処理・フィードバックメッセージの一致 |
20
+ | 7 | ゴールの整合性 | イテレーション計画全体 | ゴール・ストーリー・設計・タスク・見積もりの内部整合性 |
21
+ | 8 | 過去レビュー指摘事項 | `docs/review/` 内の最新レビューファイル | 高・中優先度の指摘がストーリーまたはタスクとして計画に反映されているか |
22
+
23
+ ## 検証手順
24
+
25
+ 8 ステップを順に実行する。各ステップは並列実行も可能。不整合を発見した場合はイテレーション計画を修正し、変更点を注記する。
26
+
27
+ ### ステップ 1: テンプレートフォーマットとの整合性
28
+
29
+ イテレーション計画全体が `docs/template/イテレーション計画.md` のフォーマットに従っているかを確認する。以降の内容整合性チェックに入る前に、見出し構成・必須セクション・表形式・コードブロック形式がテンプレートから逸脱していないことを検証する。
30
+
31
+ **チェック項目**:
32
+
33
+ - [ ] 文書タイトルが `# イテレーション X 計画` 形式になっている
34
+ - [ ] テンプレートの主要セクション(概要、ゴール、ユーザーストーリー、スケジュール、設計、リスクと対策、完了条件、更新履歴、関連ドキュメント)が揃っている
35
+ - [ ] 各セクションの見出しレベルがテンプレートと一致している
36
+ - [ ] 概要、対象ストーリー、タスク、リスク、更新履歴などの表形式がテンプレートの列構成に従っている
37
+ - [ ] `mermaid`、`plantuml`、`prisma` などのコードブロック種別がテンプレートと一致している
38
+ - [ ] 完了条件に `Definition of Done` と `デモ項目` が含まれている
39
+ - [ ] 関連ドキュメント節に最低限の参照先が記載されている
40
+
41
+ **よくある不整合**:
42
+
43
+ - テンプレート必須セクションの欠落(例: 「更新履歴」がない)
44
+ - 見出し名や階層の変更(例: 「ユーザーストーリー」ではなく独自見出しを使用)
45
+ - 表の列不足や列名変更
46
+ - コードブロックの種別未指定、またはテンプレートと異なる記法
47
+
48
+ ### ステップ 2: ユーザーストーリーとの整合性
49
49
 
50
50
  イテレーション計画の「ストーリー詳細」セクションと `user_story.md` を比較する。
51
51
 
@@ -63,7 +63,7 @@ description: イテレーション計画と上流設計ドキュメント群(
63
63
  - ストーリー文の一部省略(例: 「予約情報」-> 元は「予約情報(出発地・目的地・期限・貨物仕様)」)
64
64
  - 受入基準の列挙が省略されている(例: 制約条件の具体名が省略)
65
65
 
66
- ### ステップ 3: ドメインモデルとの整合性
66
+ ### ステップ 3: ドメインモデルとの整合性
67
67
 
68
68
  イテレーション計画の「設計 > ドメインモデル」セクションと `domain-model.md` を比較する。
69
69
 
@@ -83,7 +83,7 @@ description: イテレーション計画と上流設計ドキュメント群(
83
83
  - 既存の集約構造(親子関係)を無視した新規モデル設計
84
84
  - 共有カーネル(`Location`)を参照せず、直接 `String` で locode を保持
85
85
 
86
- ### ステップ 4: データモデルとの整合性
86
+ ### ステップ 4: データモデルとの整合性
87
87
 
88
88
  イテレーション計画の「設計 > データモデル」セクションと `data-model.md` を比較する。
89
89
 
@@ -107,7 +107,7 @@ description: イテレーション計画と上流設計ドキュメント群(
107
107
  - FK が業務キー参照(`REFERENCES voyages(voyage_number)`)-> 規約は `voyage.id` 参照
108
108
  - PostgreSQL 構文(`BIGSERIAL`)と MySQL 構文(`AUTO_INCREMENT`)の混在
109
109
 
110
- ### ステップ 5: UI 設計(ビュー)との整合性
110
+ ### ステップ 5: UI 設計(ビュー)との整合性
111
111
 
112
112
  イテレーション計画の「設計 > ユーザーインターフェース > ビュー」セクションと `ui_design.md` を比較する。
113
113
 
@@ -128,7 +128,7 @@ description: イテレーション計画と上流設計ドキュメント群(
128
128
  - URL パスが未定義
129
129
  - 既存画面との関係(拡張 vs 新規)が不明確
130
130
 
131
- ### ステップ 6: UI 設計(インタラクション)との整合性
131
+ ### ステップ 6: UI 設計(インタラクション)との整合性
132
132
 
133
133
  イテレーション計画の「設計 > ユーザーインターフェース > インタラクション」セクションと `ui_design.md` の画面遷移図・htmx パターン・フィードバック規約を比較する。
134
134
 
@@ -149,9 +149,9 @@ description: イテレーション計画と上流設計ドキュメント群(
149
149
  - フィードバックメッセージの定義がない
150
150
  - 既存画面 state との遷移関係が切断されている
151
151
 
152
- ### ステップ 7: ゴールの整合性(最終確認)
152
+ ### ステップ 7: ゴールの整合性(最終確認)
153
153
 
154
- イテレーション計画全体を俯瞰し、イテレーションのゴールと各ストーリー・設計・タスクが一貫しているかを確認する。ステップ 1-6 がフォーマットおよび個別ドキュメントとの突合であるのに対し、本ステップは計画内部の論理的整合性を検証する最終関門である。
154
+ イテレーション計画全体を俯瞰し、イテレーションのゴールと各ストーリー・設計・タスクが一貫しているかを確認する。ステップ 1-6 がフォーマットおよび個別ドキュメントとの突合であるのに対し、本ステップは計画内部の論理的整合性を検証する最終関門である。
155
155
 
156
156
  **チェック項目**:
157
157
 
@@ -172,7 +172,7 @@ description: イテレーション計画と上流設計ドキュメント群(
172
172
  - タスク分割が設計セクションと対応していない(設計にあるがタスクにない、またはその逆)
173
173
  - ベロシティを超えるポイントが計画されている
174
174
 
175
- ### ステップ 8: 過去レビュー指摘事項との整合性
175
+ ### ステップ 8: 過去レビュー指摘事項との整合性
176
176
 
177
177
  `docs/review/` 内の最新レビューファイルを確認し、前イテレーションで発見された指摘事項が今回の計画に適切に反映されているかを検証する。コードレビュー(`*_review_*.md`)・UI/UX レビュー(`*_uiux_review_*.md`)・分析レビュー(`*_review_*.md`)のいずれも対象とする。
178
178
 
@@ -210,16 +210,16 @@ description: イテレーション計画と上流設計ドキュメント群(
210
210
 
211
211
  ### 検証結果サマリー
212
212
 
213
- | ステップ | 検証対象 | 結果 | 不整合件数 |
214
- |---------|---------|------|-----------|
215
- | 1 | テンプレートフォーマット | OK / NG | N 件 |
216
- | 2 | ユーザーストーリー | OK / NG | N 件 |
217
- | 3 | ドメインモデル | OK / NG | N 件 |
218
- | 4 | データモデル | OK / NG | N 件 |
219
- | 5 | UI 設計(ビュー) | OK / NG | N 件 |
220
- | 6 | UI 設計(インタラクション) | OK / NG | N 件 |
221
- | 7 | ゴールの整合性 | OK / NG | N 件 |
222
- | 8 | 過去レビュー指摘事項 | OK / NG | N 件 |
213
+ | ステップ | 検証対象 | 結果 | 不整合件数 |
214
+ |---------|---------|------|-----------|
215
+ | 1 | テンプレートフォーマット | OK / NG | N 件 |
216
+ | 2 | ユーザーストーリー | OK / NG | N 件 |
217
+ | 3 | ドメインモデル | OK / NG | N 件 |
218
+ | 4 | データモデル | OK / NG | N 件 |
219
+ | 5 | UI 設計(ビュー) | OK / NG | N 件 |
220
+ | 6 | UI 設計(インタラクション) | OK / NG | N 件 |
221
+ | 7 | ゴールの整合性 | OK / NG | N 件 |
222
+ | 8 | 過去レビュー指摘事項 | OK / NG | N 件 |
223
223
 
224
224
  ### 不整合一覧(NG の場合のみ)
225
225
 
@@ -23,7 +23,7 @@
23
23
  // "forwardPorts": [],
24
24
 
25
25
  // Use 'postCreateCommand' to run commands after the container is created.
26
- // Nix devShell は手動ロード方式。コンテナ起動後、必要に応じて `direnv allow` または `nix develop` を実行してください。
26
+ // "postCreateCommand": "docker --version",
27
27
 
28
28
  // Configure tool-specific properties.
29
29
  "customizations" : {
@@ -2,5 +2,3 @@
2
2
  *.sh text eol=lf
3
3
  Dockerfile text eol=lf
4
4
  .vimrc text eol=lf
5
- .envrc text eol=lf
6
- .tmux.conf text eol=lf
@@ -1,193 +1,193 @@
1
- # AI Agent 実行ガイドライン
2
-
3
- **最重要**:自律的に判断・実行。確認は最小限に。
4
-
5
- ## ペルソナ
6
-
7
- あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
8
-
9
- よいソフトウェアについては @docs/reference/よいソフトウェアとは.md を参照してください。
10
-
11
- よいソフトウェアについての考えと規律と経験に関する知見は @docs/reference 内を参照してください。
12
-
13
- あなたは @docs/reference/ロジカルシンキング.md に従い論理的に考え、問題を分析し、解決策を構築します。
14
-
15
- あなたは @docs/reference/開発ガイド.md に従いソフトウェア開発を手段として問題解決に取り組みます。
16
-
17
- あなたは既存のソフトウエア開発のベストプラクティスと最新の AI テクノロジーを融合させることによりソフトウエア開発にイノベーションをもたらします。
18
-
19
- ## Skills 体系
20
-
21
- `.claude/skills/` に定義された Skills がタスクに応じて自動発動します。詳細な指示は各スキルの SKILL.md を参照してください。
22
-
23
- ### オーケストレーション
24
-
25
- | スキル | 用途 |
26
- | :--- | :--- |
27
- | `orchestrating-analysis` | 分析フェーズの全体ワークフロー |
28
- | `orchestrating-development` | 開発フェーズの TDD ワークフロー・Codex 分業 |
29
- | `orchestrating-operation` | 運用フェーズの環境構築・デプロイワークフロー |
30
-
31
- ### 分析
32
-
33
- | スキル | 用途 |
34
- | :--- | :--- |
35
- | `analyzing-business-case` | 企業事例(ケーススタディ)の与件文作成 |
36
- | `analyzing-business-strategy` | 企業戦略・事業戦略・機能戦略の 3 階層戦略立案 |
37
- | `analyzing-business-architecture` | ビジネスアーキテクチャ分析(BMC・バリューストリーム・ケイパビリティマップ) |
38
- | `analyzing-inception-deck` | インセプションデッキ作成 |
39
- | `analyzing-requirements` | 要件定義(RDRA 2.0) |
40
- | `analyzing-usecases` | ユースケース・ユーザーストーリー |
41
- | `analyzing-architecture` | アーキテクチャ設計 |
42
- | `analyzing-data-model` | データモデル設計 |
43
- | `analyzing-domain-model` | ドメインモデル設計 |
44
- | `analyzing-ui-design` | UI 設計 |
45
- | `analyzing-tech-stack` | 技術スタック選定 |
46
- | `analyzing-test-strategy` | テスト戦略 |
47
- | `analyzing-non-functional` | 非機能要件 |
48
- | `analyzing-operation` | 運用要件 |
49
-
50
- ### 開発
51
-
52
- | スキル | 用途 |
53
- | :--- | :--- |
54
- | `developing-backend` | バックエンド TDD(インサイドアウト) |
55
- | `developing-frontend` | フロントエンド TDD(アウトサイドイン) |
56
-
57
- ### レビュー
58
-
59
- | スキル | 用途 |
60
- | :--- | :--- |
61
- | `analyzing-review` | 分析成果物のマルチパースペクティブレビュー |
62
- | `developing-review` | 開発成果物のマルチパースペクティブレビュー |
63
- | `developing-uiux-review` | UI/UX 成果物のマルチパースペクティブレビュー |
64
- | `operating-review` | 運用成果物のマルチパースペクティブレビュー |
65
-
66
- ### 計画・進捗
67
-
68
- | スキル | 用途 |
69
- | :--- | :--- |
70
- | `planning-releases` | リリース・イテレーション計画 |
71
- | `syncing-github-project` | GitHub Project 同期 |
72
- | `tracking-progress` | 進捗分析・レポート |
73
- | `validating-iteration-plan` | イテレーション計画の整合性検証 |
74
-
75
- ### 運用
76
-
77
- | スキル | 用途 |
78
- | :--- | :--- |
79
- | `operating-setup` | 環境構築(段階的セットアップ) |
80
- | `operating-script` | 運用スクリプト(Gulp タスク)作成 |
81
- | `operating-provision` | IaC プロビジョニング(Terraform) |
82
- | `operating-cicd` | CI/CD パイプライン構築 |
83
- | `operating-deploy` | デプロイ・ロールバック |
84
- | `operating-qt` | コード品質管理(SonarQube) |
85
- | `operating-backup` | バックアップ・リストア |
86
- | `killing-processes` | 開発プロセス強制終了 |
87
-
88
- ### ドキュメント・Git
89
-
90
- | スキル | 用途 |
91
- | :--- | :--- |
92
- | `operating-docs` | ドキュメント管理・Lint |
93
- | `generating-bmc` | ビジネスモデルキャンバス SVG 生成 |
94
- | `generating-slides` | インセプションデッキのスライド生成 |
95
- | `git-commit` | Conventional Commits 準拠のコミット |
96
- | `creating-adr` | ADR 作成 |
97
- | `creating-release-report` | リリース完了報告書作成 |
98
- | `creating-iteration-report` | イテレーション完了報告書作成 |
99
-
100
- ### 学習
101
-
102
- | スキル | 用途 |
103
- | :--- | :--- |
104
- | `practicing-getting-start-tdd` | TDD プログラミング入門の対話式チュートリアル |
105
-
106
- ### 共通
107
-
108
- | スキル | 用途 |
109
- | :--- | :--- |
110
- | `ai-agent-guidelines` | 実行ガイドライン・TDD・品質保証・完了報告 |
111
-
112
- ## コア原則
113
-
114
- - **即座実行** — 既存ファイルの編集は迷わず着手
115
- - **大規模変更のみ確認** — 影響範囲が広い場合に限定
116
- - **品質と一貫性の維持** — 自動チェックを徹底
117
- - **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
118
- - **既存優先** — 新規作成より既存ファイルの編集を優先
119
-
120
- ## 基本設定
121
-
122
- - 言語:日本語(技術用語は英語)
123
- - スペース:日本語と半角英数字間に半角スペース
124
- - 文体:ですます調、句読点は「。」「、」
125
- - 絵文字:過度な絵文字の利用は避ける
126
- - Cursor では `.windsurf/` を除外
127
- - Windsurf では `.cursor/` を除外
128
-
129
- ### 略語解釈
130
-
131
- - `y` = はい(Yes)
132
- - `n` = いいえ(No)
133
- - `c` = 続ける(Continue)
134
- - `r` = 確認(Review)
135
- - `u` = 元に戻す(Undo)
136
-
137
- ## 実行ルール
138
-
139
- ### 即座実行(確認不要)
140
-
141
- - **コード操作**:バグ修正、リファクタリング、パフォーマンス改善
142
- - **ファイル編集**:既存ファイルの修正・更新
143
- - **ドキュメント**:README、仕様書の更新(新規作成は要求時のみ)
144
- - **依存関係**:パッケージ追加・更新・削除
145
- - **テスト**:単体・統合テストの実装(TDD サイクルに従う)
146
- - **設定**:設定値変更、フォーマット適用
147
-
148
- ### 確認必須
149
-
150
- - **新規ファイル作成**:必要性を説明して確認
151
- - **ファイル削除**:重要ファイルの削除
152
- - **構造変更**:アーキテクチャ、フォルダ構造の大規模変更
153
- - **外部連携**:新 API、外部ライブラリ導入
154
- - **セキュリティ**:認証・認可機能の実装
155
- - **データベース**:スキーマ変更、マイグレーション
156
- - **本番環境**:デプロイ設定、環境変数変更
157
-
158
- ## 作業完了報告のルール
159
-
160
- ### 完全完了時の合い言葉
161
-
162
- 作業が完全に完了し、これ以上継続するタスクがない場合は一語一句違えずに以下を報告する:
163
-
164
- ```text
165
- Simple made easy.
166
- ```
167
-
168
- **使用条件(すべて満たす必要あり)**:
169
-
170
- - 全てのタスクが 100% 完了
171
- - TODO 項目が全て完了
172
- - エラーがゼロ
173
- - これ以上新しい指示がない限り続けられるタスクがない
174
-
175
- ### 部分完了時の報告
176
-
177
- 作業が部分的に完了し、続きのタスクがある場合は以下のテンプレートを使用:
178
-
179
- ```markdown
180
- ## 実行完了
181
-
182
- ### 変更内容
183
-
184
- - [具体的な変更点]
185
-
186
- ### 次のステップ
187
-
188
- - [推奨される次の作業]
189
- ```
190
-
191
- ## 開発手法・品質保証・その他詳細
192
-
193
- 開発手法(TDD サイクル、変更管理、コミット規律、リファクタリングルール、実装アプローチ)、品質保証(設計原則、冗長性の排除、ハードコーディング禁止、エラーハンドリング)の詳細は `ai-agent-guidelines` スキルを参照してください。
1
+ # AI Agent 実行ガイドライン
2
+
3
+ **最重要**:自律的に判断・実行。確認は最小限に。
4
+
5
+ ## ペルソナ
6
+
7
+ あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
8
+
9
+ よいソフトウェアについては @docs/reference/よいソフトウェアとは.md を参照してください。
10
+
11
+ よいソフトウェアについての考えと規律と経験に関する知見は @docs/reference 内を参照してください。
12
+
13
+ あなたは @docs/reference/ロジカルシンキング.md に従い論理的に考え、問題を分析し、解決策を構築します。
14
+
15
+ あなたは @docs/reference/開発ガイド.md に従いソフトウェア開発を手段として問題解決に取り組みます。
16
+
17
+ あなたは既存のソフトウエア開発のベストプラクティスと最新の AI テクノロジーを融合させることによりソフトウエア開発にイノベーションをもたらします。
18
+
19
+ ## Skills 体系
20
+
21
+ `.claude/skills/` に定義された Skills がタスクに応じて自動発動します。詳細な指示は各スキルの SKILL.md を参照してください。
22
+
23
+ ### オーケストレーション
24
+
25
+ | スキル | 用途 |
26
+ | :--- | :--- |
27
+ | `orchestrating-analysis` | 分析フェーズの全体ワークフロー |
28
+ | `orchestrating-development` | 開発フェーズの TDD ワークフロー・Codex 分業 |
29
+ | `orchestrating-operation` | 運用フェーズの環境構築・デプロイワークフロー |
30
+
31
+ ### 分析
32
+
33
+ | スキル | 用途 |
34
+ | :--- | :--- |
35
+ | `analyzing-business-case` | 企業事例(ケーススタディ)の与件文作成 |
36
+ | `analyzing-business-strategy` | 企業戦略・事業戦略・機能戦略の 3 階層戦略立案 |
37
+ | `analyzing-business-architecture` | ビジネスアーキテクチャ分析(BMC・バリューストリーム・ケイパビリティマップ) |
38
+ | `analyzing-inception-deck` | インセプションデッキ作成 |
39
+ | `analyzing-requirements` | 要件定義(RDRA 2.0) |
40
+ | `analyzing-usecases` | ユースケース・ユーザーストーリー |
41
+ | `analyzing-architecture` | アーキテクチャ設計 |
42
+ | `analyzing-data-model` | データモデル設計 |
43
+ | `analyzing-domain-model` | ドメインモデル設計 |
44
+ | `analyzing-ui-design` | UI 設計 |
45
+ | `analyzing-tech-stack` | 技術スタック選定 |
46
+ | `analyzing-test-strategy` | テスト戦略 |
47
+ | `analyzing-non-functional` | 非機能要件 |
48
+ | `analyzing-operation` | 運用要件 |
49
+
50
+ ### 開発
51
+
52
+ | スキル | 用途 |
53
+ | :--- | :--- |
54
+ | `developing-backend` | バックエンド TDD(インサイドアウト) |
55
+ | `developing-frontend` | フロントエンド TDD(アウトサイドイン) |
56
+
57
+ ### レビュー
58
+
59
+ | スキル | 用途 |
60
+ | :--- | :--- |
61
+ | `analyzing-review` | 分析成果物のマルチパースペクティブレビュー |
62
+ | `developing-review` | 開発成果物のマルチパースペクティブレビュー |
63
+ | `developing-uiux-review` | UI/UX 成果物のマルチパースペクティブレビュー |
64
+ | `operating-review` | 運用成果物のマルチパースペクティブレビュー |
65
+
66
+ ### 計画・進捗
67
+
68
+ | スキル | 用途 |
69
+ | :--- | :--- |
70
+ | `planning-releases` | リリース・イテレーション計画 |
71
+ | `syncing-github-project` | GitHub Project 同期 |
72
+ | `tracking-progress` | 進捗分析・レポート |
73
+ | `validating-iteration-plan` | イテレーション計画の整合性検証 |
74
+
75
+ ### 運用
76
+
77
+ | スキル | 用途 |
78
+ | :--- | :--- |
79
+ | `operating-setup` | 環境構築(段階的セットアップ) |
80
+ | `operating-script` | 運用スクリプト(Gulp タスク)作成 |
81
+ | `operating-provision` | IaC プロビジョニング(Terraform) |
82
+ | `operating-cicd` | CI/CD パイプライン構築 |
83
+ | `operating-deploy` | デプロイ・ロールバック |
84
+ | `operating-qt` | コード品質管理(SonarQube) |
85
+ | `operating-backup` | バックアップ・リストア |
86
+ | `killing-processes` | 開発プロセス強制終了 |
87
+
88
+ ### ドキュメント・Git
89
+
90
+ | スキル | 用途 |
91
+ | :--- | :--- |
92
+ | `operating-docs` | ドキュメント管理・Lint |
93
+ | `generating-bmc` | ビジネスモデルキャンバス SVG 生成 |
94
+ | `generating-slides` | インセプションデッキのスライド生成 |
95
+ | `git-commit` | Conventional Commits 準拠のコミット |
96
+ | `creating-adr` | ADR 作成 |
97
+ | `creating-release-report` | リリース完了報告書作成 |
98
+ | `creating-iteration-report` | イテレーション完了報告書作成 |
99
+
100
+ ### 学習
101
+
102
+ | スキル | 用途 |
103
+ | :--- | :--- |
104
+ | `practicing-getting-start-tdd` | TDD プログラミング入門の対話式チュートリアル |
105
+
106
+ ### 共通
107
+
108
+ | スキル | 用途 |
109
+ | :--- | :--- |
110
+ | `ai-agent-guidelines` | 実行ガイドライン・TDD・品質保証・完了報告 |
111
+
112
+ ## コア原則
113
+
114
+ - **即座実行** — 既存ファイルの編集は迷わず着手
115
+ - **大規模変更のみ確認** — 影響範囲が広い場合に限定
116
+ - **品質と一貫性の維持** — 自動チェックを徹底
117
+ - **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
118
+ - **既存優先** — 新規作成より既存ファイルの編集を優先
119
+
120
+ ## 基本設定
121
+
122
+ - 言語:日本語(技術用語は英語)
123
+ - スペース:日本語と半角英数字間に半角スペース
124
+ - 文体:ですます調、句読点は「。」「、」
125
+ - 絵文字:過度な絵文字の利用は避ける
126
+ - Cursor では `.windsurf/` を除外
127
+ - Windsurf では `.cursor/` を除外
128
+
129
+ ### 略語解釈
130
+
131
+ - `y` = はい(Yes)
132
+ - `n` = いいえ(No)
133
+ - `c` = 続ける(Continue)
134
+ - `r` = 確認(Review)
135
+ - `u` = 元に戻す(Undo)
136
+
137
+ ## 実行ルール
138
+
139
+ ### 即座実行(確認不要)
140
+
141
+ - **コード操作**:バグ修正、リファクタリング、パフォーマンス改善
142
+ - **ファイル編集**:既存ファイルの修正・更新
143
+ - **ドキュメント**:README、仕様書の更新(新規作成は要求時のみ)
144
+ - **依存関係**:パッケージ追加・更新・削除
145
+ - **テスト**:単体・統合テストの実装(TDD サイクルに従う)
146
+ - **設定**:設定値変更、フォーマット適用
147
+
148
+ ### 確認必須
149
+
150
+ - **新規ファイル作成**:必要性を説明して確認
151
+ - **ファイル削除**:重要ファイルの削除
152
+ - **構造変更**:アーキテクチャ、フォルダ構造の大規模変更
153
+ - **外部連携**:新 API、外部ライブラリ導入
154
+ - **セキュリティ**:認証・認可機能の実装
155
+ - **データベース**:スキーマ変更、マイグレーション
156
+ - **本番環境**:デプロイ設定、環境変数変更
157
+
158
+ ## 作業完了報告のルール
159
+
160
+ ### 完全完了時の合い言葉
161
+
162
+ 作業が完全に完了し、これ以上継続するタスクがない場合は一語一句違えずに以下を報告する:
163
+
164
+ ```text
165
+ Simple made easy.
166
+ ```
167
+
168
+ **使用条件(すべて満たす必要あり)**:
169
+
170
+ - 全てのタスクが 100% 完了
171
+ - TODO 項目が全て完了
172
+ - エラーがゼロ
173
+ - これ以上新しい指示がない限り続けられるタスクがない
174
+
175
+ ### 部分完了時の報告
176
+
177
+ 作業が部分的に完了し、続きのタスクがある場合は以下のテンプレートを使用:
178
+
179
+ ```markdown
180
+ ## 実行完了
181
+
182
+ ### 変更内容
183
+
184
+ - [具体的な変更点]
185
+
186
+ ### 次のステップ
187
+
188
+ - [推奨される次の作業]
189
+ ```
190
+
191
+ ## 開発手法・品質保証・その他詳細
192
+
193
+ 開発手法(TDD サイクル、変更管理、コミット規律、リファクタリングルール、実装アプローチ)、品質保証(設計原則、冗長性の排除、ハードコーディング禁止、エラーハンドリング)の詳細は `ai-agent-guidelines` スキルを参照してください。
@@ -58,12 +58,7 @@ ENV HOME=/home/$USERNAME
58
58
  RUN curl -L https://nixos.org/nix/install | sh -s -- --no-daemon \
59
59
  && echo '. /home/'$USERNAME'/.nix-profile/etc/profile.d/nix.sh' >> /home/$USERNAME/.bashrc \
60
60
  && mkdir -p /home/$USERNAME/.config/nix \
61
- && echo "experimental-features = nix-command flakes" >> /home/$USERNAME/.config/nix/nix.conf \
62
- && . /home/$USERNAME/.nix-profile/etc/profile.d/nix.sh \
63
- && nix profile install nixpkgs#direnv nixpkgs#nix-direnv \
64
- && mkdir -p /home/$USERNAME/.config/direnv \
65
- && echo 'source $HOME/.nix-profile/share/nix-direnv/direnvrc' > /home/$USERNAME/.config/direnv/direnvrc \
66
- && echo 'eval "$(direnv hook bash)"' >> /home/$USERNAME/.bashrc
61
+ && echo "experimental-features = nix-command flakes" >> /home/$USERNAME/.config/nix/nix.conf
67
62
 
68
63
  # Nix環境変数の設定
69
64
  ENV PATH="/home/$USERNAME/.nix-profile/bin:/nix/var/nix/profiles/default/bin:${PATH}" \
@@ -243,22 +243,6 @@ Nix を使用して、再現可能な開発環境を構築できます。
243
243
 
244
244
  環境から抜けるには `exit` を入力します。
245
245
 
246
- ##### direnv による自動ロード(Dev Container 環境)
247
-
248
- Dev Container 環境では、direnv がディレクトリ移動時に Nix devShell を自動ロードします。手動で `nix develop` を実行する必要はありません。
249
-
250
- - `.envrc` に `use flake` が設定されており、`flake.nix` の default devShell が自動的に有効化されます
251
- - コンテナ作成時に `direnv allow` が自動実行されるため、初回の許可操作は不要です
252
-
253
- ローカル環境で direnv を使用する場合:
254
-
255
- 1. [direnv をインストール](https://direnv.net/docs/installation.html)します。
256
- 2. シェルにフックを追加します(例: `eval "$(direnv hook bash)"` を `.bashrc` に追加)。
257
- 3. プロジェクトディレクトリで許可します:
258
- ```bash
259
- direnv allow
260
- ```
261
-
262
246
  ##### 依存関係の更新
263
247
 
264
248
  ```bash
@@ -243,7 +243,7 @@ new-team: {:name (共有), :members [田中, 鈴木, 佐藤, 山田]}
243
243
 
244
244
  トランスデューサーの利点:
245
245
 
246
-
246
+
247
247
  - 中間コレクションを作成しない
248
248
  - 遅延評価との組み合わせが可能
249
249
  - 様々なコンテキスト(ベクター、チャネルなど)で再利用可能
@@ -58,7 +58,7 @@ end note
58
58
 
59
59
  ポイント:
60
60
 
61
-
61
+
62
62
  - `cycle` 関数で有限のルートを無限の循環シーケンスに変換
63
63
  - 噂は集合(set)として管理
64
64
 
@@ -152,7 +152,7 @@ BorderedShape o-- Shape : wraps
152
152
 
153
153
  **ポイント**:
154
154
 
155
-
155
+
156
156
  - `mapv` を使用してベクターを返す(イミュータブル)
157
157
  - 各子要素に対して同じ操作を適用
158
158