@k2works/claude-code-booster 1.13.0 → 2.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.
- package/bin/claude-code-booster +5 -7
- package/lib/assets/.claude/README.md +73 -19
- package/lib/assets/.claude/agents/xp-architect.md +250 -0
- package/lib/assets/.claude/agents/xp-executive.md +207 -0
- package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -0
- package/lib/assets/.claude/agents/xp-product-manager.md +245 -0
- package/lib/assets/.claude/agents/xp-programmer.md +268 -0
- package/lib/assets/.claude/agents/xp-project-manager.md +229 -0
- package/lib/assets/.claude/agents/xp-technical-writer.md +224 -0
- package/lib/assets/.claude/agents/xp-tester.md +265 -0
- package/lib/assets/.claude/agents/xp-user-representative.md +204 -0
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +49 -57
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +54 -58
- package/lib/assets/.claude/skills/analyzing-business/SKILL.md +52 -74
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +50 -53
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +56 -56
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +56 -109
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +61 -57
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +61 -57
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +57 -55
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +66 -67
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +58 -56
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +51 -57
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +45 -60
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +38 -40
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +49 -55
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +47 -50
- package/lib/assets/.claude/skills/developing-release/SKILL.md +60 -95
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +58 -100
- package/lib/assets/.claude/skills/git-commit/SKILL.md +27 -52
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +16 -70
- package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -0
- package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -0
- package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -0
- package/lib/assets/.claude/skills/{managing-docs → operating-docs}/SKILL.md +1 -1
- package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -0
- package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -0
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +65 -95
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +60 -155
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -0
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +60 -119
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +63 -168
- package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +62 -266
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +49 -122
- package/lib/assets/CLAUDE.md +7 -2
- package/lib/assets/README.md +3 -34
- package/lib/assets/docs/development/index.md +14 -8
- package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -0
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +69 -5
- package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/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 +1366 -0
- package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/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 +634 -0
- package/lib/assets/docs/template//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/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 +547 -0
- 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 +123 -1
- package/lib/assets/docs/template//350/250/255/350/250/210.md +12 -2
- package/lib/assets/docs/template//351/226/213/347/231/272/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 +688 -0
- package/package.json +1 -1
- package/lib/assets/.claude/SKILLS_TEMPLATE.md +0 -100
- package/lib/assets/.claude/agents/roles/.gitkeep +0 -0
- package/lib/assets/.claude/skills/managing-operations/DEPLOY.md +0 -77
- package/lib/assets/.claude/skills/managing-operations/SETUP_CSHARP.md +0 -80
- package/lib/assets/.claude/skills/managing-operations/SETUP_FRONTEND.md +0 -84
- package/lib/assets/.claude/skills/managing-operations/SETUP_JAVA.md +0 -75
- package/lib/assets/.claude/skills/managing-operations/SKILL.md +0 -156
|
@@ -1,100 +0,0 @@
|
|
|
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
|
-
```
|
|
File without changes
|
|
@@ -1,77 +0,0 @@
|
|
|
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 +0,0 @@
|
|
|
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 +0,0 @@
|
|
|
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 +0,0 @@
|
|
|
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,156 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: managing-operations
|
|
3
|
-
description: アプリケーションの運用・構築・配置を統括管理。環境構築、デプロイ、監視、バックアップ、日次運用タスクの実行。運用管理やインフラ整備時に使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# 運用管理ガイド
|
|
7
|
-
|
|
8
|
-
アプリケーションの運用・構築・配置を統括的に管理し、本番環境への安全かつ効率的なデプロイを実現します。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. オプション
|
|
13
|
-
|
|
14
|
-
- なし : 運用全体のステータス確認(デフォルト)
|
|
15
|
-
- `--setup [環境名]` : 環境構築の初期設定とインフラ準備
|
|
16
|
-
- `--setup Java` : Java 開発環境の構築と Spring Boot プロジェクトセットアップ
|
|
17
|
-
- `--setup FrontEnd` : TypeScript/React 開発環境の構築と Vite プロジェクトセットアップ
|
|
18
|
-
- `--setup C#WPF` : C# WPF 開発環境の構築と Clean Architecture プロジェクトセットアップ
|
|
19
|
-
- `--build` : アプリケーションのビルドとパッケージング
|
|
20
|
-
- `--deploy <環境>` : 指定環境へのデプロイ実行
|
|
21
|
-
- `--status <環境>` : 特定環境の動作状況確認
|
|
22
|
-
- `--rollback <環境>` : 指定環境での前バージョンへのロールバック
|
|
23
|
-
- `--logs <サービス>` : 特定サービスのログ確認
|
|
24
|
-
- `--health` : システム全体のヘルスチェック実行
|
|
25
|
-
- `--backup` : データベース・設定ファイルのバックアップ作成
|
|
26
|
-
- `--restore <バックアップ>` : 指定バックアップからの復元
|
|
27
|
-
- `--daily` : 日次運用タスクの自動実行(日誌生成と概要編集)
|
|
28
|
-
|
|
29
|
-
### 2. 基本例
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
# 運用全体の状況確認
|
|
33
|
-
# 「現在の環境構築・デプロイ・運用状況を包括的にレポート」
|
|
34
|
-
|
|
35
|
-
# Java 開発環境の構築
|
|
36
|
-
# --setup Java
|
|
37
|
-
# 「プロジェクト名と作成場所を対話式で確認後、Java 開発環境の統合セットアップ」
|
|
38
|
-
|
|
39
|
-
# TypeScript/React 開発環境の構築
|
|
40
|
-
# --setup FrontEnd
|
|
41
|
-
# 「プロジェクト名と作成場所を対話式で確認後、TypeScript/React 開発環境の統合セットアップ」
|
|
42
|
-
|
|
43
|
-
# C# WPF 開発環境の構築
|
|
44
|
-
# --setup C#WPF
|
|
45
|
-
# 「プロジェクト名と作成場所を対話式で確認後、C# WPF + Clean Architecture 開発環境の統合セットアップ」
|
|
46
|
-
|
|
47
|
-
# プロダクション環境へのデプロイ
|
|
48
|
-
# --deploy production
|
|
49
|
-
# 「本番環境への安全なデプロイ実行とヘルスチェック」
|
|
50
|
-
|
|
51
|
-
# システム全体のヘルスチェック
|
|
52
|
-
# --health
|
|
53
|
-
# 「全環境のサービス稼働状況・リソース使用量・アラート確認」
|
|
54
|
-
|
|
55
|
-
# 日次運用タスクの実行
|
|
56
|
-
# --daily
|
|
57
|
-
# 「日誌の自動生成と概要編集を実行」
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### 3. 環境構築の詳細
|
|
61
|
-
|
|
62
|
-
各環境構築オプションの詳細は以下の参照ファイルを確認してください:
|
|
63
|
-
|
|
64
|
-
- **Java**: @.claude/skills/managing-operations/SETUP_JAVA.md
|
|
65
|
-
- **TypeScript/React**: @.claude/skills/managing-operations/SETUP_FRONTEND.md
|
|
66
|
-
- **C# WPF**: @.claude/skills/managing-operations/SETUP_CSHARP.md
|
|
67
|
-
|
|
68
|
-
### 4. デプロイ・運用監視の詳細
|
|
69
|
-
|
|
70
|
-
デプロイメント管理、運用監視、バックアップの詳細:
|
|
71
|
-
|
|
72
|
-
- @.claude/skills/managing-operations/DEPLOY.md
|
|
73
|
-
|
|
74
|
-
### 5. 環境構築とインフラ管理
|
|
75
|
-
|
|
76
|
-
```bash
|
|
77
|
-
# 完全な環境構築
|
|
78
|
-
# --setup
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
**実行される構築作業**:
|
|
82
|
-
|
|
83
|
-
- **Docker 環境**: コンテナ・ネットワーク・ボリュームの構築
|
|
84
|
-
- **CI/CD パイプライン**: GitHub Actions・Jenkins 等の設定
|
|
85
|
-
- **データベース**: PostgreSQL・Redis 等のセットアップ
|
|
86
|
-
- **監視システム**: ログ収集・メトリクス監視・アラート設定
|
|
87
|
-
- **セキュリティ**: SSL 証明書・認証基盤・ファイアウォール設定
|
|
88
|
-
|
|
89
|
-
### 6. ビルドとパッケージング
|
|
90
|
-
|
|
91
|
-
複数言語・フレームワークに対応した統合ビルドシステム:
|
|
92
|
-
|
|
93
|
-
**対応技術スタック**:
|
|
94
|
-
|
|
95
|
-
- **Java**: Maven・Gradle による Spring Boot アプリケーション
|
|
96
|
-
- **Node.js**: npm・yarn による React・Vue.js アプリケーション
|
|
97
|
-
- **Python**: pip・poetry による Django・FastAPI アプリケーション
|
|
98
|
-
- **.NET**: dotnet による ASP.NET Core アプリケーション
|
|
99
|
-
|
|
100
|
-
### 7. 日次運用タスク
|
|
101
|
-
|
|
102
|
-
プロジェクトの日常的な運用作業を自動化し、開発履歴の記録と管理を支援:
|
|
103
|
-
|
|
104
|
-
```bash
|
|
105
|
-
# 日次運用タスクの自動実行
|
|
106
|
-
# --daily
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
**実行される作業**:
|
|
110
|
-
|
|
111
|
-
1. `npm run journal` コマンドの実行
|
|
112
|
-
2. Git コミット履歴から日付別の作業記録を自動生成
|
|
113
|
-
3. `docs/journal/YYYYMMDD.md` 形式でファイル作成
|
|
114
|
-
4. `mkdocs.yml` に自動登録
|
|
115
|
-
5. 技術的な作業内容を簡潔に要約
|
|
116
|
-
|
|
117
|
-
### 8. 出力例
|
|
118
|
-
|
|
119
|
-
```
|
|
120
|
-
運用管理ダッシュボード
|
|
121
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
122
|
-
|
|
123
|
-
Overall Status: 全環境正常稼働中
|
|
124
|
-
|
|
125
|
-
Environment Status:
|
|
126
|
-
├─ Development: 稼働中 (backend: http://localhost:5150)
|
|
127
|
-
├─ Staging: 稼働中 (v1.2.1)
|
|
128
|
-
├─ Production: 稼働中 (v1.2.0, 99.99% アップタイム)
|
|
129
|
-
└─ Monitoring: 正常 (アラートなし)
|
|
130
|
-
|
|
131
|
-
Infrastructure Health:
|
|
132
|
-
├─ Database: PostgreSQL 正常 (CPU: 15%, Memory: 45%)
|
|
133
|
-
├─ API Gateway: 正常 (平均レスポンス: 120ms)
|
|
134
|
-
└─ CDN: キャッシュ効率: 95%
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
### 9. 注意事項
|
|
138
|
-
|
|
139
|
-
- **前提条件**: Docker・Git・適切な権限設定が必要
|
|
140
|
-
- **制限事項**: 本番環境への直接アクセスは制限される場合あり
|
|
141
|
-
- **推奨事項**: 本番デプロイ前に必ずステージング環境での動作確認を実施
|
|
142
|
-
|
|
143
|
-
### 10. ベストプラクティス
|
|
144
|
-
|
|
145
|
-
1. **段階的デプロイ**: Development → Staging → Production の順序を厳守
|
|
146
|
-
2. **自動化優先**: 手作業を最小限に抑え、スクリプトと CI/CD で自動化
|
|
147
|
-
3. **監視ファースト**: デプロイ前後の監視設定とアラート確認を徹底
|
|
148
|
-
4. **バックアップ確保**: 重要な変更前には必ずバックアップを作成
|
|
149
|
-
5. **ロールバック準備**: 緊急時の迅速なロールバック手順を事前準備
|
|
150
|
-
6. **セキュリティ重視**: 認証・認可・暗号化・ログ監査を常に実施
|
|
151
|
-
|
|
152
|
-
### 関連スキル
|
|
153
|
-
|
|
154
|
-
- `tracking-progress` : 開発進捗と運用準備状況の確認
|
|
155
|
-
- `planning-releases` : リリース計画と運用スケジュールの管理
|
|
156
|
-
- `git-commit` : デプロイに適したコミット作成
|