@k2works/claude-code-booster 1.10.0 → 1.11.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 (93) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +42 -42
  3. package/bin/claude-code-booster +79 -79
  4. package/lib/assets/.claude/README.md +162 -162
  5. package/lib/assets/.claude/SKILLS_TEMPLATE.md +100 -100
  6. package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
  7. package/lib/assets/.claude/settings.json +11 -11
  8. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
  9. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +87 -87
  10. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +117 -117
  11. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +80 -80
  12. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +88 -88
  13. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +137 -137
  14. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +91 -91
  15. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +91 -91
  16. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +89 -87
  17. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +102 -102
  18. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +87 -87
  19. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +86 -86
  20. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +87 -87
  21. package/lib/assets/.claude/skills/creating-adr/SKILL.md +115 -115
  22. package/lib/assets/.claude/skills/developing-backend/SKILL.md +106 -106
  23. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +96 -96
  24. package/lib/assets/.claude/skills/developing-release/SKILL.md +154 -154
  25. package/lib/assets/.claude/skills/generating-slides/SKILL.md +136 -136
  26. package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
  27. package/lib/assets/.claude/skills/killing-processes/SKILL.md +98 -98
  28. package/lib/assets/.claude/skills/managing-docs/SKILL.md +200 -200
  29. package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +77 -77
  30. package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +80 -80
  31. package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +84 -84
  32. package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +75 -75
  33. package/lib/assets/.claude/skills/managing-operations/SKILL.md +156 -156
  34. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +134 -134
  35. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +243 -243
  36. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +193 -193
  37. package/lib/assets/.claude/skills/planning-releases/SKILL.md +222 -222
  38. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +164 -164
  39. package/lib/assets/.devcontainer/devcontainer.json +34 -34
  40. package/lib/assets/.env.example +17 -17
  41. package/lib/assets/.gitattributes +4 -4
  42. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  43. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  44. package/lib/assets/AGENTS.md +94 -94
  45. package/lib/assets/CLAUDE.md +162 -162
  46. package/lib/assets/README.md +285 -269
  47. package/lib/assets/docker-compose.yml +33 -33
  48. package/lib/assets/docs/assets/css/extra.css +29 -29
  49. package/lib/assets/docs/assets/js/extra.js +44 -44
  50. package/lib/assets/docs/index.md +14 -14
  51. 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 +532 -532
  52. package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md +341 -341
  53. package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +578 -578
  54. package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +465 -465
  55. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +448 -448
  56. package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +242 -242
  57. package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2216 -2216
  58. package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
  59. package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +554 -554
  60. package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +705 -705
  61. package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1313 -1313
  62. package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
  63. package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
  64. package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
  65. package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +682 -682
  66. 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 -442
  67. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/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/343/202/254/343/202/244/343/203/211.md +558 -558
  68. package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +663 -663
  69. package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
  70. package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
  71. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
  72. package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1236 -1236
  73. package/lib/assets/docs/template/ADR.md +30 -30
  74. package/lib/assets/docs/template/README.md +50 -50
  75. package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
  76. 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/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
  77. package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
  78. package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
  79. package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +68 -68
  80. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  81. package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
  82. package/lib/assets/gulpfile.js +23 -23
  83. package/lib/assets/mkdocs.yml +65 -65
  84. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  85. package/lib/assets/ops/scripts/journal.js +180 -180
  86. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  87. package/lib/assets/ops/scripts/release.js +431 -431
  88. package/lib/assets/ops/scripts/ssh.js +190 -190
  89. package/lib/assets/ops/scripts/vault.js +299 -299
  90. package/lib/assets/package-lock.json +1653 -1653
  91. package/lib/assets/package.json +40 -40
  92. package/lib/gulpfile.js +37 -37
  93. package/package.json +41 -41
@@ -1,77 +1,77 @@
1
- # デプロイメント管理・運用監視・バックアップ
2
-
3
- ## デプロイメント管理
4
-
5
- ゼロダウンタイムデプロイとブルーグリーンデプロイメント。
6
-
7
- ### 環境別デプロイ戦略
8
-
9
- - **Development**: 即座デプロイ・自動テスト実行
10
- - **Staging**: 統合テスト・パフォーマンステスト
11
- - **Production**: ブルーグリーンデプロイ・段階的ロールアウト
12
-
13
- ```bash
14
- # ステージング環境への自動デプロイ
15
- # --deploy staging
16
-
17
- # 本番環境への慎重なデプロイ
18
- # --deploy production --strategy blue-green
19
- ```
20
-
21
- ## 運用監視とログ管理
22
-
23
- リアルタイム監視とプロアクティブなアラート。
24
-
25
- ### 監視項目
26
-
27
- - **パフォーマンス**: CPU・メモリ・ディスク・ネットワーク使用率
28
- - **アプリケーション**: レスポンス時間・エラー率・スループット
29
- - **インフラ**: サーバー・データベース・外部 API の稼働状況
30
- - **ビジネス**: ユーザーアクティビティ・売上・KPI 指標
31
-
32
- ```bash
33
- # 特定サービスのリアルタイムログ
34
- # --logs backend --follow
35
-
36
- # システム全体の統合ダッシュボード
37
- # --health --dashboard
38
- ```
39
-
40
- ## バックアップと災害復旧
41
-
42
- 自動バックアップと迅速な災害復旧。
43
-
44
- ### バックアップ対象
45
-
46
- - **データベース**: 完全バックアップ・増分バックアップ
47
- - **アプリケーション**: 設定ファイル・静的リソース・ログ
48
- - **インフラ**: 環境設定・SSL 証明書・監視設定
49
-
50
- ```bash
51
- # 自動バックアップの実行
52
- # --backup --schedule daily
53
-
54
- # 緊急時の完全復元
55
- # --restore backup-2024-09-12-003000
56
- ```
57
-
58
- ## 連携シナリオ
59
-
60
- ```bash
61
- # システム状況と組み合わせた総合分析
62
- ps aux | grep -E "(java|node|postgres)"
63
- netstat -tlnp | grep -E ":3000|:5432|:8080"
64
- # → --health
65
- # 「実行中プロセスとポート使用状況を含めた運用状況の総合分析」
66
-
67
- # Git 状況と組み合わせたデプロイ準備
68
- git log --oneline -5
69
- git status
70
- # → --deploy staging
71
- # 「最新コミットを含めたステージング環境へのデプロイ実行」
72
-
73
- # ログ分析と組み合わせた障害対応
74
- tail -100 /var/log/apps.log
75
- # → --rollback production
76
- # 「エラーログ分析に基づく緊急ロールバック実行」
77
- ```
1
+ # デプロイメント管理・運用監視・バックアップ
2
+
3
+ ## デプロイメント管理
4
+
5
+ ゼロダウンタイムデプロイとブルーグリーンデプロイメント。
6
+
7
+ ### 環境別デプロイ戦略
8
+
9
+ - **Development**: 即座デプロイ・自動テスト実行
10
+ - **Staging**: 統合テスト・パフォーマンステスト
11
+ - **Production**: ブルーグリーンデプロイ・段階的ロールアウト
12
+
13
+ ```bash
14
+ # ステージング環境への自動デプロイ
15
+ # --deploy staging
16
+
17
+ # 本番環境への慎重なデプロイ
18
+ # --deploy production --strategy blue-green
19
+ ```
20
+
21
+ ## 運用監視とログ管理
22
+
23
+ リアルタイム監視とプロアクティブなアラート。
24
+
25
+ ### 監視項目
26
+
27
+ - **パフォーマンス**: CPU・メモリ・ディスク・ネットワーク使用率
28
+ - **アプリケーション**: レスポンス時間・エラー率・スループット
29
+ - **インフラ**: サーバー・データベース・外部 API の稼働状況
30
+ - **ビジネス**: ユーザーアクティビティ・売上・KPI 指標
31
+
32
+ ```bash
33
+ # 特定サービスのリアルタイムログ
34
+ # --logs backend --follow
35
+
36
+ # システム全体の統合ダッシュボード
37
+ # --health --dashboard
38
+ ```
39
+
40
+ ## バックアップと災害復旧
41
+
42
+ 自動バックアップと迅速な災害復旧。
43
+
44
+ ### バックアップ対象
45
+
46
+ - **データベース**: 完全バックアップ・増分バックアップ
47
+ - **アプリケーション**: 設定ファイル・静的リソース・ログ
48
+ - **インフラ**: 環境設定・SSL 証明書・監視設定
49
+
50
+ ```bash
51
+ # 自動バックアップの実行
52
+ # --backup --schedule daily
53
+
54
+ # 緊急時の完全復元
55
+ # --restore backup-2024-09-12-003000
56
+ ```
57
+
58
+ ## 連携シナリオ
59
+
60
+ ```bash
61
+ # システム状況と組み合わせた総合分析
62
+ ps aux | grep -E "(java|node|postgres)"
63
+ netstat -tlnp | grep -E ":3000|:5432|:8080"
64
+ # → --health
65
+ # 「実行中プロセスとポート使用状況を含めた運用状況の総合分析」
66
+
67
+ # Git 状況と組み合わせたデプロイ準備
68
+ git log --oneline -5
69
+ git status
70
+ # → --deploy staging
71
+ # 「最新コミットを含めたステージング環境へのデプロイ実行」
72
+
73
+ # ログ分析と組み合わせた障害対応
74
+ tail -100 /var/log/apps.log
75
+ # → --rollback production
76
+ # 「エラーログ分析に基づく緊急ロールバック実行」
77
+ ```
@@ -1,80 +1,80 @@
1
- # C# WPF 開発環境の統合セットアップ
2
-
3
- ドキュメントベースの包括的 C# WPF + Clean Architecture 開発環境構築手順。
4
-
5
- ## 参照ドキュメント
6
-
7
- - `@docs/design/tech_stack.md`: C# WPF 技術スタック選定理由と詳細仕様
8
- - `@docs/design/architecture_backend.md`: Clean Architecture + MagicOnion サーバー設計詳細
9
- - `@docs/design/architecture_frontend.md`: WPF MVVM アーキテクチャとプレゼンテーション層設計詳細
10
-
11
- ## 初期設定プロセス
12
-
13
- ### 対話式プロジェクト設定
14
-
15
- - プロジェクト名の確認(例: AdventureWorks.PurchasingSystem)
16
- - ソリューション名の確認(例: AdventureWorks)
17
- - 作成場所の確認(デフォルト: `apps/` 配下)
18
- - データベース接続文字列の確認
19
-
20
- ### 注意点
21
-
22
- - apps/app のような構成にしてはいけない
23
- - apps/{solution-name} のような構成すること
24
- - tech_stack.md のディレクトリ構成詳細にしたがうこと
25
- - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
- - Java の `src` や `tests` のようなディレクトリ構成にしないこと
27
-
28
- ## 構築される環境の詳細
29
-
30
- ### 基盤技術 (@docs/design/tech_stack.md 準拠)
31
-
32
- - .NET 8.0 + C# 12
33
- - WPF + CommunityToolkit.Mvvm 8.x
34
- - MagicOnion 5.x (gRPC ベース RPC)
35
- - Dapper 2.x (Micro ORM)
36
- - Kamishibai 3.x (ナビゲーション)
37
-
38
- ### アーキテクチャ (@docs/design/architecture_backend.md + @docs/design/architecture_frontend.md 準拠)
39
-
40
- - Clean Architecture(依存関係逆転)
41
- - Domain-Driven Design(ドメインモデル中心)
42
- - MVVM パターン(WPF 標準)
43
- - レイヤー分離: Domain → Application → Infrastructure → Presentation
44
- - MagicOnion サーバーによる gRPC 通信
45
-
46
- ### データベース環境
47
-
48
- - 開発・テスト: SQL Server LocalDB
49
- - 本番: SQL Server + Dapper
50
- - マイグレーション: DbUp 5.x
51
- - 接続プール: SqlConnection + HikariCP 相当
52
-
53
- ### 品質管理ツール
54
-
55
- - テスト: NUnit 3 + FluentAssertions + Moq + Codeer.Friendly
56
- - 静的解析: SonarQube + StyleCop + FxCop
57
- - カバレッジ: OpenCover (Domain: 95%, Application: 85% 目標)
58
- - UI テスト: Codeer.Friendly.Windows.Wpf
59
- - E2E テスト: Page Object Pattern
60
-
61
- ### 開発支援機能
62
-
63
- - Serilog (構造化ログ)
64
- - Docker Compose (開発環境)
65
- - MkDocs (ドキュメントサイト)
66
- - PlantUML (アーキテクチャ図)
67
-
68
- ## 連携シナリオ
69
-
70
- ```bash
71
- # ドキュメント準拠の C# WPF 開発環境構築(対話式)
72
- cat docs/design/tech_stack.md
73
- cat docs/design/architecture_backend.md
74
- cat docs/design/architecture_frontend.md
75
- # → ソリューション名入力: "AdventureWorks"
76
- # → プロジェクト名確認: "AdventureWorks.PurchasingSystem" (自動生成)
77
- # → 作成場所確認: "apps/wpfapp/" (Enter でデフォルト採用)
78
- # → 接続文字列確認: "Server=(localdb)\\mssqllocaldb;..." (デフォルト採用)
79
- dotnet build
80
- ```
1
+ # C# WPF 開発環境の統合セットアップ
2
+
3
+ ドキュメントベースの包括的 C# WPF + Clean Architecture 開発環境構築手順。
4
+
5
+ ## 参照ドキュメント
6
+
7
+ - `@docs/design/tech_stack.md`: C# WPF 技術スタック選定理由と詳細仕様
8
+ - `@docs/design/architecture_backend.md`: Clean Architecture + MagicOnion サーバー設計詳細
9
+ - `@docs/design/architecture_frontend.md`: WPF MVVM アーキテクチャとプレゼンテーション層設計詳細
10
+
11
+ ## 初期設定プロセス
12
+
13
+ ### 対話式プロジェクト設定
14
+
15
+ - プロジェクト名の確認(例: AdventureWorks.PurchasingSystem)
16
+ - ソリューション名の確認(例: AdventureWorks)
17
+ - 作成場所の確認(デフォルト: `apps/` 配下)
18
+ - データベース接続文字列の確認
19
+
20
+ ### 注意点
21
+
22
+ - apps/app のような構成にしてはいけない
23
+ - apps/{solution-name} のような構成すること
24
+ - tech_stack.md のディレクトリ構成詳細にしたがうこと
25
+ - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
+ - Java の `src` や `tests` のようなディレクトリ構成にしないこと
27
+
28
+ ## 構築される環境の詳細
29
+
30
+ ### 基盤技術 (@docs/design/tech_stack.md 準拠)
31
+
32
+ - .NET 8.0 + C# 12
33
+ - WPF + CommunityToolkit.Mvvm 8.x
34
+ - MagicOnion 5.x (gRPC ベース RPC)
35
+ - Dapper 2.x (Micro ORM)
36
+ - Kamishibai 3.x (ナビゲーション)
37
+
38
+ ### アーキテクチャ (@docs/design/architecture_backend.md + @docs/design/architecture_frontend.md 準拠)
39
+
40
+ - Clean Architecture(依存関係逆転)
41
+ - Domain-Driven Design(ドメインモデル中心)
42
+ - MVVM パターン(WPF 標準)
43
+ - レイヤー分離: Domain → Application → Infrastructure → Presentation
44
+ - MagicOnion サーバーによる gRPC 通信
45
+
46
+ ### データベース環境
47
+
48
+ - 開発・テスト: SQL Server LocalDB
49
+ - 本番: SQL Server + Dapper
50
+ - マイグレーション: DbUp 5.x
51
+ - 接続プール: SqlConnection + HikariCP 相当
52
+
53
+ ### 品質管理ツール
54
+
55
+ - テスト: NUnit 3 + FluentAssertions + Moq + Codeer.Friendly
56
+ - 静的解析: SonarQube + StyleCop + FxCop
57
+ - カバレッジ: OpenCover (Domain: 95%, Application: 85% 目標)
58
+ - UI テスト: Codeer.Friendly.Windows.Wpf
59
+ - E2E テスト: Page Object Pattern
60
+
61
+ ### 開発支援機能
62
+
63
+ - Serilog (構造化ログ)
64
+ - Docker Compose (開発環境)
65
+ - MkDocs (ドキュメントサイト)
66
+ - PlantUML (アーキテクチャ図)
67
+
68
+ ## 連携シナリオ
69
+
70
+ ```bash
71
+ # ドキュメント準拠の C# WPF 開発環境構築(対話式)
72
+ cat docs/design/tech_stack.md
73
+ cat docs/design/architecture_backend.md
74
+ cat docs/design/architecture_frontend.md
75
+ # → ソリューション名入力: "AdventureWorks"
76
+ # → プロジェクト名確認: "AdventureWorks.PurchasingSystem" (自動生成)
77
+ # → 作成場所確認: "apps/wpfapp/" (Enter でデフォルト採用)
78
+ # → 接続文字列確認: "Server=(localdb)\\mssqllocaldb;..." (デフォルト採用)
79
+ dotnet build
80
+ ```
@@ -1,84 +1,84 @@
1
- # TypeScript/React 開発環境の統合セットアップ
2
-
3
- ドキュメントベースの包括的 TypeScript/React 開発環境構築手順。
4
-
5
- ## 参照ドキュメント
6
-
7
- - `docs/reference/TypeScriptアプリケーション環境構築ガイド.md`: TDD 基盤セットアップ手順と開発規律
8
- - `@docs/design/tech_stack.md`: フロントエンド技術スタック選定理由と詳細仕様
9
- - `@docs/design/architecture_frontend.md`: SPA アーキテクチャとコンポーネント設計詳細
10
-
11
- ## 初期設定プロセス
12
-
13
- ### 対話式プロジェクト設定
14
-
15
- - プロジェクト名の確認(例: meeting-room-reservation-ui)
16
- - パッケージ名の確認(例: @mrs/frontend)
17
- - 作成場所の確認(デフォルト: `apps/frontend/` 配下)
18
- - 開発ポートの確認(デフォルト: 3000)
19
-
20
- ### 注意点
21
-
22
- - `docs/reference/TypeScriptアプリケーション環境構築ガイド.md` の Vite プロジェクトの初期化部分は参考にしない
23
- - apps/frontend/app のような構成にしてはいけない
24
- - apps/frontend/{project-name} のような構成すること
25
- - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
-
27
- ## 構築される環境の詳細
28
-
29
- ### 基盤技術 (@docs/design/tech_stack.md 準拠)
30
-
31
- - Node.js 20 LTS + TypeScript 5.4.0
32
- - React 18.3.0 + React DOM 18.3.0
33
- - Vite 5.2.0 (高速ビルドツール)
34
- - Zustand 4.5.2 (クライアント状態管理)
35
-
36
- ### アーキテクチャ (@docs/design/architecture_frontend.md 準拠)
37
-
38
- - SPA アーキテクチャ(Single Page Application)
39
- - Container/Presentational パターン
40
- - Custom Hooks による状態ロジック分離
41
- - ディレクトリ構造: 11 フォルダ構成 (`components/,pages/,hooks/,services/,stores/,types/,utils/,constants/,assets/,styles/,__tests__/`)
42
-
43
- ### UI/UX 技術
44
-
45
- - Tailwind CSS 3.4.3 (ユーティリティファースト CSS)
46
- - React Hook Form 7.51.4 (フォーム管理)
47
- - React Router 6.23.1 (ルーティング)
48
- - Lucide React 0.378.0 (アイコンライブラリ)
49
-
50
- ### データ管理
51
-
52
- - TanStack React Query 5.40.1 (サーバー状態管理)
53
- - Axios 1.7.2 (HTTP クライアント)
54
- - React Hook Form + Zod 3.23.8 (バリデーション)
55
-
56
- ### 品質管理ツール
57
-
58
- - テスト: Vitest + @testing-library/react + @testing-library/jest-dom
59
- - 静的解析: ESLint 8.57.0 + @typescript-eslint
60
- - フォーマッター: Prettier 3.2.5
61
- - カバレッジ: @vitest/coverage-v8 (80% 目標)
62
- - 循環複雑度制限: 7 以下
63
-
64
- ### 開発支援機能
65
-
66
- - Vite HMR (ホットモジュールリロード)
67
- - TypeScript 厳格設定 (strict: true)
68
- - ESLint + Prettier 統合
69
- - Gulp Guard 機能(自動テスト・リント・フォーマット)
70
- - TDD サイクル支援(Red-Green-Refactor)
71
-
72
- ## 連携シナリオ
73
-
74
- ```bash
75
- # ドキュメント準拠の TypeScript/React 開発環境構築(対話式)
76
- cat docs/reference/TypeScriptアプリケーション環境構築ガイド.md
77
- cat docs/design/tech_stack.md
78
- cat docs/design/architecture_frontend.md
79
- # → プロジェクト名入力: "meeting-room-reservation-ui"
80
- # → 作成場所確認: "apps/frontend/" (Enter でデフォルト採用)
81
- # → パッケージ名確認: "@mrs/frontend" (自動生成)
82
- # → 開発ポート確認: "3000" (Enter でデフォルト採用)
83
- npm run dev
84
- ```
1
+ # TypeScript/React 開発環境の統合セットアップ
2
+
3
+ ドキュメントベースの包括的 TypeScript/React 開発環境構築手順。
4
+
5
+ ## 参照ドキュメント
6
+
7
+ - `docs/reference/TypeScriptアプリケーション環境構築ガイド.md`: TDD 基盤セットアップ手順と開発規律
8
+ - `@docs/design/tech_stack.md`: フロントエンド技術スタック選定理由と詳細仕様
9
+ - `@docs/design/architecture_frontend.md`: SPA アーキテクチャとコンポーネント設計詳細
10
+
11
+ ## 初期設定プロセス
12
+
13
+ ### 対話式プロジェクト設定
14
+
15
+ - プロジェクト名の確認(例: meeting-room-reservation-ui)
16
+ - パッケージ名の確認(例: @mrs/frontend)
17
+ - 作成場所の確認(デフォルト: `apps/frontend/` 配下)
18
+ - 開発ポートの確認(デフォルト: 3000)
19
+
20
+ ### 注意点
21
+
22
+ - `docs/reference/TypeScriptアプリケーション環境構築ガイド.md` の Vite プロジェクトの初期化部分は参考にしない
23
+ - apps/frontend/app のような構成にしてはいけない
24
+ - apps/frontend/{project-name} のような構成すること
25
+ - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
+
27
+ ## 構築される環境の詳細
28
+
29
+ ### 基盤技術 (@docs/design/tech_stack.md 準拠)
30
+
31
+ - Node.js 20 LTS + TypeScript 5.4.0
32
+ - React 18.3.0 + React DOM 18.3.0
33
+ - Vite 5.2.0 (高速ビルドツール)
34
+ - Zustand 4.5.2 (クライアント状態管理)
35
+
36
+ ### アーキテクチャ (@docs/design/architecture_frontend.md 準拠)
37
+
38
+ - SPA アーキテクチャ(Single Page Application)
39
+ - Container/Presentational パターン
40
+ - Custom Hooks による状態ロジック分離
41
+ - ディレクトリ構造: 11 フォルダ構成 (`components/,pages/,hooks/,services/,stores/,types/,utils/,constants/,assets/,styles/,__tests__/`)
42
+
43
+ ### UI/UX 技術
44
+
45
+ - Tailwind CSS 3.4.3 (ユーティリティファースト CSS)
46
+ - React Hook Form 7.51.4 (フォーム管理)
47
+ - React Router 6.23.1 (ルーティング)
48
+ - Lucide React 0.378.0 (アイコンライブラリ)
49
+
50
+ ### データ管理
51
+
52
+ - TanStack React Query 5.40.1 (サーバー状態管理)
53
+ - Axios 1.7.2 (HTTP クライアント)
54
+ - React Hook Form + Zod 3.23.8 (バリデーション)
55
+
56
+ ### 品質管理ツール
57
+
58
+ - テスト: Vitest + @testing-library/react + @testing-library/jest-dom
59
+ - 静的解析: ESLint 8.57.0 + @typescript-eslint
60
+ - フォーマッター: Prettier 3.2.5
61
+ - カバレッジ: @vitest/coverage-v8 (80% 目標)
62
+ - 循環複雑度制限: 7 以下
63
+
64
+ ### 開発支援機能
65
+
66
+ - Vite HMR (ホットモジュールリロード)
67
+ - TypeScript 厳格設定 (strict: true)
68
+ - ESLint + Prettier 統合
69
+ - Gulp Guard 機能(自動テスト・リント・フォーマット)
70
+ - TDD サイクル支援(Red-Green-Refactor)
71
+
72
+ ## 連携シナリオ
73
+
74
+ ```bash
75
+ # ドキュメント準拠の TypeScript/React 開発環境構築(対話式)
76
+ cat docs/reference/TypeScriptアプリケーション環境構築ガイド.md
77
+ cat docs/design/tech_stack.md
78
+ cat docs/design/architecture_frontend.md
79
+ # → プロジェクト名入力: "meeting-room-reservation-ui"
80
+ # → 作成場所確認: "apps/frontend/" (Enter でデフォルト採用)
81
+ # → パッケージ名確認: "@mrs/frontend" (自動生成)
82
+ # → 開発ポート確認: "3000" (Enter でデフォルト採用)
83
+ npm run dev
84
+ ```
@@ -1,75 +1,75 @@
1
- # Java 開発環境の統合セットアップ
2
-
3
- ドキュメントベースの包括的 Java 開発環境構築手順。
4
-
5
- ## 参照ドキュメント
6
-
7
- - `docs/reference/Javaアプリケーション環境構築ガイド.md`: 基本セットアップ手順とベストプラクティス
8
- - `@docs/design/tech_stack.md`: 技術スタック選定理由と詳細仕様
9
- - `@docs/design/architecture_backend.md`: ヘキサゴナルアーキテクチャ設計詳細
10
-
11
- ## 初期設定プロセス
12
-
13
- ### 対話式プロジェクト設定
14
-
15
- - プロジェクト名の確認(例: meeting-room-system)
16
- - パッケージ名の確認(例: com.example.{project-name})
17
- - グループ ID・アーティファクト ID の設定確認
18
- - 作成場所の確認(デフォルト: `apps/backend/` 配下)
19
-
20
- ### 注意点
21
-
22
- - `docs/reference/Javaアプリケーション環境構築ガイド.md` の Gradle プロジェクトの初期化部分は参考にしない
23
- - apps/backend/app のような構成にしてはいけない
24
- - apps/backend/{project-name} のような構成すること
25
- - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
-
27
- ## 構築される環境の詳細
28
-
29
- ### 基盤技術 (@docs/design/tech_stack.md 準拠)
30
-
31
- - Java 21 LTS + Spring Boot 3.3.2
32
- - Spring Security 6.3.1 (JWT Bearer 認証)
33
- - Spring Data JPA 3.3.2
34
- - Gradle 8.5 + Gradle Wrapper
35
-
36
- ### アーキテクチャ (@docs/design/architecture_backend.md 準拠)
37
-
38
- - ヘキサゴナルアーキテクチャ(ポートとアダプターパターン)
39
- - ドメインモデルパターン
40
- - レイヤー分離: Domain → Application → Infrastructure
41
- - ディレクトリ構造: `src/main/java/{domain,application,infrastructure,shared}/`
42
-
43
- ### データベース環境
44
-
45
- - 開発・テスト: H2 Database 2.2.224 (In-Memory)
46
- - 本番: PostgreSQL 15 + HikariCP 5.0.1
47
- - マイグレーション: Flyway 9.22.3
48
-
49
- ### 品質管理ツール
50
-
51
- - テスト: JUnit 5 + AssertJ + Mockito + Testcontainers + ArchUnit
52
- - 静的解析: SonarQube + Checkstyle 10.12.3 + SpotBugs + PMD
53
- - カバレッジ: JaCoCo (80% 目標)
54
- - セキュリティ: OWASP Dependency Check 8.4.0
55
- - 循環複雑度制限: 7 以下
56
-
57
- ### 開発支援機能
58
-
59
- - Spring Boot DevTools (ホットリロード)
60
- - Spring Boot Actuator (監視・メトリクス)
61
- - 環境プロファイル分離 (dev/test/prod)
62
- - H2 Console (開発時データベース可視化)
63
-
64
- ## 連携シナリオ
65
-
66
- ```bash
67
- # ドキュメント準拠の Java 開発環境構築(対話式)
68
- cat docs/reference/Javaアプリケーション環境構築ガイド.md
69
- cat docs/design/tech_stack.md
70
- cat docs/design/architecture_backend.md
71
- # → プロジェクト名入力: "meeting-room-system"
72
- # → 作成場所確認: "apps/backend/" (Enter でデフォルト採用)
73
- # → パッケージ名確認: "com.example.meetingroomsystem" (自動生成)
74
- ./gradlew build
75
- ```
1
+ # Java 開発環境の統合セットアップ
2
+
3
+ ドキュメントベースの包括的 Java 開発環境構築手順。
4
+
5
+ ## 参照ドキュメント
6
+
7
+ - `docs/reference/Javaアプリケーション環境構築ガイド.md`: 基本セットアップ手順とベストプラクティス
8
+ - `@docs/design/tech_stack.md`: 技術スタック選定理由と詳細仕様
9
+ - `@docs/design/architecture_backend.md`: ヘキサゴナルアーキテクチャ設計詳細
10
+
11
+ ## 初期設定プロセス
12
+
13
+ ### 対話式プロジェクト設定
14
+
15
+ - プロジェクト名の確認(例: meeting-room-system)
16
+ - パッケージ名の確認(例: com.example.{project-name})
17
+ - グループ ID・アーティファクト ID の設定確認
18
+ - 作成場所の確認(デフォルト: `apps/backend/` 配下)
19
+
20
+ ### 注意点
21
+
22
+ - `docs/reference/Javaアプリケーション環境構築ガイド.md` の Gradle プロジェクトの初期化部分は参考にしない
23
+ - apps/backend/app のような構成にしてはいけない
24
+ - apps/backend/{project-name} のような構成すること
25
+ - ディレクトリだけの場合もコミットしたいので `.gitkeep` を入れる
26
+
27
+ ## 構築される環境の詳細
28
+
29
+ ### 基盤技術 (@docs/design/tech_stack.md 準拠)
30
+
31
+ - Java 21 LTS + Spring Boot 3.3.2
32
+ - Spring Security 6.3.1 (JWT Bearer 認証)
33
+ - Spring Data JPA 3.3.2
34
+ - Gradle 8.5 + Gradle Wrapper
35
+
36
+ ### アーキテクチャ (@docs/design/architecture_backend.md 準拠)
37
+
38
+ - ヘキサゴナルアーキテクチャ(ポートとアダプターパターン)
39
+ - ドメインモデルパターン
40
+ - レイヤー分離: Domain → Application → Infrastructure
41
+ - ディレクトリ構造: `src/main/java/{domain,application,infrastructure,shared}/`
42
+
43
+ ### データベース環境
44
+
45
+ - 開発・テスト: H2 Database 2.2.224 (In-Memory)
46
+ - 本番: PostgreSQL 15 + HikariCP 5.0.1
47
+ - マイグレーション: Flyway 9.22.3
48
+
49
+ ### 品質管理ツール
50
+
51
+ - テスト: JUnit 5 + AssertJ + Mockito + Testcontainers + ArchUnit
52
+ - 静的解析: SonarQube + Checkstyle 10.12.3 + SpotBugs + PMD
53
+ - カバレッジ: JaCoCo (80% 目標)
54
+ - セキュリティ: OWASP Dependency Check 8.4.0
55
+ - 循環複雑度制限: 7 以下
56
+
57
+ ### 開発支援機能
58
+
59
+ - Spring Boot DevTools (ホットリロード)
60
+ - Spring Boot Actuator (監視・メトリクス)
61
+ - 環境プロファイル分離 (dev/test/prod)
62
+ - H2 Console (開発時データベース可視化)
63
+
64
+ ## 連携シナリオ
65
+
66
+ ```bash
67
+ # ドキュメント準拠の Java 開発環境構築(対話式)
68
+ cat docs/reference/Javaアプリケーション環境構築ガイド.md
69
+ cat docs/design/tech_stack.md
70
+ cat docs/design/architecture_backend.md
71
+ # → プロジェクト名入力: "meeting-room-system"
72
+ # → 作成場所確認: "apps/backend/" (Enter でデフォルト採用)
73
+ # → パッケージ名確認: "com.example.meetingroomsystem" (自動生成)
74
+ ./gradlew build
75
+ ```