@k2works/claude-code-booster 0.16.0 → 0.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +42 -42
  3. package/bin/claude-code-booster +68 -68
  4. package/lib/assets/.claude/.mcp.json +45 -45
  5. package/lib/assets/.claude/COMMAND_TEMPLATE.md +122 -122
  6. package/lib/assets/.claude/README.md +140 -140
  7. package/lib/assets/.claude/commands/analysis-architecture.md +98 -98
  8. package/lib/assets/.claude/commands/analysis-data-model.md +94 -94
  9. package/lib/assets/.claude/commands/analysis-domain-model.md +101 -101
  10. package/lib/assets/.claude/commands/analysis-non-functional.md +103 -103
  11. package/lib/assets/.claude/commands/analysis-operation.md +104 -104
  12. package/lib/assets/.claude/commands/analysis-requirements.md +100 -100
  13. package/lib/assets/.claude/commands/analysis-tech-stack.md +113 -113
  14. package/lib/assets/.claude/commands/analysis-test-strategy.md +101 -101
  15. package/lib/assets/.claude/commands/analysis-ui-design.md +100 -100
  16. package/lib/assets/.claude/commands/analysis-usecases.md +100 -100
  17. package/lib/assets/.claude/commands/analysis.md +103 -103
  18. package/lib/assets/.claude/commands/dev-backend.md +144 -144
  19. package/lib/assets/.claude/commands/dev-frontend.md +126 -126
  20. package/lib/assets/.claude/commands/dev.md +96 -96
  21. package/lib/assets/.claude/commands/docs.md +213 -213
  22. package/lib/assets/.claude/commands/git-commit.md +47 -47
  23. package/lib/assets/.claude/commands/kill.md +108 -108
  24. package/lib/assets/.claude/commands/ops.md +507 -507
  25. package/lib/assets/.claude/commands/plan-github.md +212 -212
  26. package/lib/assets/.claude/commands/plan.md +237 -237
  27. package/lib/assets/.claude/commands/progress.md +171 -171
  28. package/lib/assets/.claude/settings.json +8 -7
  29. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +119 -119
  30. package/lib/assets/.claude/skills/git-commit/SKILL.md +106 -106
  31. package/lib/assets/.devcontainer/devcontainer.json +34 -34
  32. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  33. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  34. package/lib/assets/AGENTS.md +94 -94
  35. package/lib/assets/CLAUDE.md +319 -319
  36. package/lib/assets/Dockerfile +100 -97
  37. package/lib/assets/README.md +234 -234
  38. package/lib/assets/docker-compose.yml +33 -33
  39. package/lib/assets/docs/assets/css/extra.css +29 -29
  40. package/lib/assets/docs/assets/js/extra.js +44 -44
  41. package/lib/assets/docs/index.md +14 -14
  42. 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 +569 -569
  43. 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 +464 -464
  44. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +445 -445
  45. 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 +219 -219
  46. 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 +2193 -2193
  47. 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
  48. 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
  49. 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 +703 -703
  50. 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 +1309 -1309
  51. 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
  52. 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
  53. 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 +671 -671
  54. 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 +523 -523
  55. 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
  56. 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
  57. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +235 -235
  58. 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 +1230 -1230
  59. package/lib/assets/docs/template/ADR.md +30 -30
  60. package/lib/assets/docs/template/README.md +50 -50
  61. 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
  62. 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
  63. 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
  64. 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
  65. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  66. package/lib/assets/docs/template//350/250/255/350/250/210.md +163 -163
  67. package/lib/assets/flake.nix +22 -22
  68. package/lib/assets/gulpfile.js +18 -18
  69. package/lib/assets/mkdocs.yml +63 -63
  70. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  71. package/lib/assets/ops/nix/environments/node/shell.nix +20 -20
  72. package/lib/assets/ops/nix/environments/python/shell.nix +19 -20
  73. package/lib/assets/ops/nix/shells/shell.nix +17 -17
  74. package/lib/assets/ops/scripts/journal.js +180 -180
  75. package/lib/assets/ops/scripts/mkdocs.js +113 -113
  76. package/lib/assets/package-lock.json +1640 -1640
  77. package/lib/assets/package.json +34 -33
  78. package/lib/gulpfile.js +37 -37
  79. package/package.json +40 -40
@@ -1,172 +1,172 @@
1
- ## Progress
2
-
3
- プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告するコマンド。
4
-
5
- ### 使い方
6
-
7
- ```bash
8
- /progress [オプション]
9
- ```
10
-
11
- ### オプション
12
-
13
- - なし : 全体的な進捗確認(デフォルト)
14
- - `--brief` : 簡潔な進捗サマリー表示
15
- - `--detailed` : 詳細な進捗レポート生成
16
- - `--iteration <番号>` : 特定イテレーションの進捗確認
17
- - `--technical` : 技術的な実装状況に焦点
18
- - `--docs` : ドキュメント更新状況の確認
19
-
20
- ### 基本例
21
-
22
- ```bash
23
- # 基本的な進捗確認
24
- /progress
25
- 「プロジェクト全体の開発進捗を包括的にレポート」
26
-
27
- # 簡潔なサマリー
28
- /progress --brief
29
- 「要点のみを絞った進捗状況を表示」
30
-
31
- # 詳細レポート
32
- /progress --detailed
33
- 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
34
-
35
- # 特定イテレーションの確認
36
- /progress --iteration 1
37
- 「イテレーション1の完了状況と成果を詳細分析」
38
-
39
- # 技術的な実装状況
40
- /progress --technical
41
- 「コード実装・テスト・アーキテクチャの技術的進捗を確認」
42
-
43
- # ドキュメント状況
44
- /progress --docs
45
- 「計画・仕様・READMEなどのドキュメント更新状況を確認」
46
- ```
47
-
48
- ### 詳細機能
49
-
50
- #### 包括的な進捗分析
51
-
52
- プロジェクトの多角的な視点から現在の進捗状況を分析:
53
-
54
- - **イテレーション達成度**: 計画vs実績の比較分析
55
- - **技術実装状況**: 機能完成度・品質指標・テスト結果
56
- - **アーキテクチャ進展**: 設計の実装状況と技術的負債
57
- - **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
58
-
59
- #### 動的な状況判定
60
-
61
- ```bash
62
- # Git履歴の分析
63
- git log --oneline -10
64
- git status --porcelain
65
-
66
- # テスト実行状況の確認
67
- dotnet test --logger trx
68
- npm test -- --coverage
69
-
70
- # 実行環境の状況確認
71
- ps aux | grep -E "dotnet|node|npm"
72
- netstat -tlnp | grep -E ":3000|:5150"
73
- ```
74
-
75
- #### 品質メトリクス取得
76
-
77
- 実装品質の定量的評価:
78
-
79
- - **テストカバレッジ**: 単体・統合・E2Eテストの網羅率
80
- - **コード品質**: 静的解析結果・複雑度測定
81
- - **性能指標**: レスポンス時間・スループット測定
82
- - **セキュリティ**: 脆弱性スキャン結果
83
-
84
- ### 出力例
85
-
86
- ```
87
- プロジェクト進捗レポート
88
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
89
- 📊 Overall Status: フルスタック実装完成 (MVP準備段階)
90
-
91
- 🎯 Iteration Progress:
92
- ├─ Iteration 1 (認証・閲覧): ✅ 完了 (計画10日→実績4日, 60%短縮)
93
- ├─ Iteration 2 (予約機能): 📋 計画済み (8営業日予定)
94
- ├─ Iteration 3 (キャンセル): ⏳ 待機中
95
- └─ Iteration 4 (運用準備): ⏳ 待機中
96
-
97
- 💻 Technical Implementation:
98
- ├─ Backend (.NET 9): ✅ 完全実装 (181テスト全通過)
99
- ├─ Frontend (React TS): ✅ 完全実装 (認証・会議室一覧)
100
- ├─ Database (SQLite): ✅ 稼働中 (自動初期化対応)
101
- ├─ Authentication: ✅ JWT完全実装 (ログアウト問題解決済)
102
- └─ API Integration: ✅ フルスタック連携確認
103
-
104
- 🚀 Runtime Status:
105
- ├─ Backend API: ✅ http://localhost:5150 (稼働中)
106
- ├─ Frontend: ✅ http://localhost:3000 (稼働中)
107
- ├─ Test Coverage: ✅ 95%+ (181件全通過)
108
- └─ Build Status: ✅ 警告・エラーなし
109
-
110
- 📚 Documentation:
111
- ├─ 計画書: ✅ 最新 (イテレーション1完了・イテレーション2計画)
112
- ├─ リリース計画: ✅ 更新済み (実績反映・短縮スケジュール)
113
- ├─ README: ✅ 実行手順書完備
114
- └─ API仕様: ✅ Swagger UI統合
115
-
116
- 🎉 Key Achievements:
117
- • フルスタック基盤完成 (計画を大幅上回る成果)
118
- • 即座ログアウト問題の完全解決
119
- • React TypeScript UI の完全実装
120
- • 181テスト全通過の高品質実装
121
-
122
- 🔜 Next Steps:
123
- • イテレーション2開始準備完了
124
- • 予約機能実装によるMVP達成
125
- • 楽観的ロック・重複防止実装
126
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
127
- ```
128
-
129
- ### Claude との連携
130
-
131
- ```bash
132
- # 現在の実行状況と組み合わせ
133
- ps aux | grep -E "dotnet|node"
134
- netstat -tlnp | grep -E ":3000|:5150"
135
- /progress --technical
136
- 「実行中のサービスを含めた技術的進捗分析を依頼」
137
-
138
- # Git状況と組み合わせ
139
- git log --oneline -5
140
- git status
141
- /progress --detailed
142
- 「最新のコミット情報を含めた詳細進捗レポート」
143
-
144
- # テスト結果と組み合わせ
145
- dotnet test --logger trx
146
- /progress --brief
147
- 「テスト実行結果を含めた簡潔な進捗確認」
148
-
149
- # ドキュメント状況と組み合わせ
150
- find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
151
- /progress --docs
152
- 「最新のドキュメント更新を含めた文書整備状況の確認」
153
- ```
154
-
155
- ### 注意事項
156
-
157
- - **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
158
- - **情報取得**: 実行時点での動的な状況を総合的に分析
159
- - **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
160
-
161
- ### ベストプラクティス
162
-
163
- 1. **定期実行**: イテレーション開始・終了時の進捗確認
164
- 2. **問題発見**: 遅延や品質低下の早期発見に活用
165
- 3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
166
- 4. **改善指標**: 進捗データを基にした開発プロセス改善
167
-
168
- ### 関連コマンド
169
-
170
- - `/semantic-commit` : 進捗に合わせた適切なコミット実行
171
- - `/test` : テスト実行状況の詳細確認(将来実装)
1
+ ## Progress
2
+
3
+ プロジェクトの開発進捗を包括的に確認し、現在の状況を詳細に報告するコマンド。
4
+
5
+ ### 使い方
6
+
7
+ ```bash
8
+ /progress [オプション]
9
+ ```
10
+
11
+ ### オプション
12
+
13
+ - なし : 全体的な進捗確認(デフォルト)
14
+ - `--brief` : 簡潔な進捗サマリー表示
15
+ - `--detailed` : 詳細な進捗レポート生成
16
+ - `--iteration <番号>` : 特定イテレーションの進捗確認
17
+ - `--technical` : 技術的な実装状況に焦点
18
+ - `--docs` : ドキュメント更新状況の確認
19
+
20
+ ### 基本例
21
+
22
+ ```bash
23
+ # 基本的な進捗確認
24
+ /progress
25
+ 「プロジェクト全体の開発進捗を包括的にレポート」
26
+
27
+ # 簡潔なサマリー
28
+ /progress --brief
29
+ 「要点のみを絞った進捗状況を表示」
30
+
31
+ # 詳細レポート
32
+ /progress --detailed
33
+ 「技術実装・テスト・ドキュメント・品質指標を含む詳細分析」
34
+
35
+ # 特定イテレーションの確認
36
+ /progress --iteration 1
37
+ 「イテレーション1の完了状況と成果を詳細分析」
38
+
39
+ # 技術的な実装状況
40
+ /progress --technical
41
+ 「コード実装・テスト・アーキテクチャの技術的進捗を確認」
42
+
43
+ # ドキュメント状況
44
+ /progress --docs
45
+ 「計画・仕様・READMEなどのドキュメント更新状況を確認」
46
+ ```
47
+
48
+ ### 詳細機能
49
+
50
+ #### 包括的な進捗分析
51
+
52
+ プロジェクトの多角的な視点から現在の進捗状況を分析:
53
+
54
+ - **イテレーション達成度**: 計画vs実績の比較分析
55
+ - **技術実装状況**: 機能完成度・品質指標・テスト結果
56
+ - **アーキテクチャ進展**: 設計の実装状況と技術的負債
57
+ - **ドキュメント整備**: 計画書・仕様書・実行手順書の最新性
58
+
59
+ #### 動的な状況判定
60
+
61
+ ```bash
62
+ # Git履歴の分析
63
+ git log --oneline -10
64
+ git status --porcelain
65
+
66
+ # テスト実行状況の確認
67
+ dotnet test --logger trx
68
+ npm test -- --coverage
69
+
70
+ # 実行環境の状況確認
71
+ ps aux | grep -E "dotnet|node|npm"
72
+ netstat -tlnp | grep -E ":3000|:5150"
73
+ ```
74
+
75
+ #### 品質メトリクス取得
76
+
77
+ 実装品質の定量的評価:
78
+
79
+ - **テストカバレッジ**: 単体・統合・E2Eテストの網羅率
80
+ - **コード品質**: 静的解析結果・複雑度測定
81
+ - **性能指標**: レスポンス時間・スループット測定
82
+ - **セキュリティ**: 脆弱性スキャン結果
83
+
84
+ ### 出力例
85
+
86
+ ```
87
+ プロジェクト進捗レポート
88
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
89
+ 📊 Overall Status: フルスタック実装完成 (MVP準備段階)
90
+
91
+ 🎯 Iteration Progress:
92
+ ├─ Iteration 1 (認証・閲覧): ✅ 完了 (計画10日→実績4日, 60%短縮)
93
+ ├─ Iteration 2 (予約機能): 📋 計画済み (8営業日予定)
94
+ ├─ Iteration 3 (キャンセル): ⏳ 待機中
95
+ └─ Iteration 4 (運用準備): ⏳ 待機中
96
+
97
+ 💻 Technical Implementation:
98
+ ├─ Backend (.NET 9): ✅ 完全実装 (181テスト全通過)
99
+ ├─ Frontend (React TS): ✅ 完全実装 (認証・会議室一覧)
100
+ ├─ Database (SQLite): ✅ 稼働中 (自動初期化対応)
101
+ ├─ Authentication: ✅ JWT完全実装 (ログアウト問題解決済)
102
+ └─ API Integration: ✅ フルスタック連携確認
103
+
104
+ 🚀 Runtime Status:
105
+ ├─ Backend API: ✅ http://localhost:5150 (稼働中)
106
+ ├─ Frontend: ✅ http://localhost:3000 (稼働中)
107
+ ├─ Test Coverage: ✅ 95%+ (181件全通過)
108
+ └─ Build Status: ✅ 警告・エラーなし
109
+
110
+ 📚 Documentation:
111
+ ├─ 計画書: ✅ 最新 (イテレーション1完了・イテレーション2計画)
112
+ ├─ リリース計画: ✅ 更新済み (実績反映・短縮スケジュール)
113
+ ├─ README: ✅ 実行手順書完備
114
+ └─ API仕様: ✅ Swagger UI統合
115
+
116
+ 🎉 Key Achievements:
117
+ • フルスタック基盤完成 (計画を大幅上回る成果)
118
+ • 即座ログアウト問題の完全解決
119
+ • React TypeScript UI の完全実装
120
+ • 181テスト全通過の高品質実装
121
+
122
+ 🔜 Next Steps:
123
+ • イテレーション2開始準備完了
124
+ • 予約機能実装によるMVP達成
125
+ • 楽観的ロック・重複防止実装
126
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
127
+ ```
128
+
129
+ ### Claude との連携
130
+
131
+ ```bash
132
+ # 現在の実行状況と組み合わせ
133
+ ps aux | grep -E "dotnet|node"
134
+ netstat -tlnp | grep -E ":3000|:5150"
135
+ /progress --technical
136
+ 「実行中のサービスを含めた技術的進捗分析を依頼」
137
+
138
+ # Git状況と組み合わせ
139
+ git log --oneline -5
140
+ git status
141
+ /progress --detailed
142
+ 「最新のコミット情報を含めた詳細進捗レポート」
143
+
144
+ # テスト結果と組み合わせ
145
+ dotnet test --logger trx
146
+ /progress --brief
147
+ 「テスト実行結果を含めた簡潔な進捗確認」
148
+
149
+ # ドキュメント状況と組み合わせ
150
+ find docs/ -name "*.md" -newer docs/development/イテレーション計画1.md
151
+ /progress --docs
152
+ 「最新のドキュメント更新を含めた文書整備状況の確認」
153
+ ```
154
+
155
+ ### 注意事項
156
+
157
+ - **前提条件**: Git リポジトリ内で実行、プロジェクト構造を理解
158
+ - **情報取得**: 実行時点での動的な状況を総合的に分析
159
+ - **推奨事項**: 重要な節目や問題発生時の定期的な進捗確認
160
+
161
+ ### ベストプラクティス
162
+
163
+ 1. **定期実行**: イテレーション開始・終了時の進捗確認
164
+ 2. **問題発見**: 遅延や品質低下の早期発見に活用
165
+ 3. **ステークホルダー報告**: 詳細レポートを会議資料として活用
166
+ 4. **改善指標**: 進捗データを基にした開発プロセス改善
167
+
168
+ ### 関連コマンド
169
+
170
+ - `/semantic-commit` : 進捗に合わせた適切なコミット実行
171
+ - `/test` : テスト実行状況の詳細確認(将来実装)
172
172
  - `/deploy` : デプロイ準備状況の確認(将来実装)
@@ -1,7 +1,8 @@
1
- {
2
- "permissions": {
3
- "allow": [],
4
- "deny": [],
5
- "ask": []
6
- }
7
- }
1
+ {
2
+ "permissions": {
3
+ "defaultMode": "plan",
4
+ "allow": [],
5
+ "deny": [],
6
+ "ask": []
7
+ }
8
+ }
@@ -1,119 +1,119 @@
1
- ---
2
- name: ai-agent-guidelines
3
- description: AI Agent の実行ガイドライン。TDD サイクル、品質保証、コンテキスト管理、完了報告のルールを定義。すべての開発タスク実行時に使用。
4
- ---
5
-
6
- # AI Agent 実行ガイドライン
7
-
8
- **最重要**:自律的に判断・実行。確認は最小限に。
9
-
10
- ## Instructions
11
-
12
- ### 1. ペルソナ
13
-
14
- あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
15
-
16
- - @docs/reference/よいソフトウェアとは.md を参照
17
- - @docs/reference/開発ガイド.md に従い問題解決に取り組む
18
-
19
- ### 2. コア原則
20
-
21
- - **即座実行** — 既存ファイルの編集は迷わず着手
22
- - **大規模変更のみ確認** — 影響範囲が広い場合に限定
23
- - **品質と一貫性の維持** — 自動チェックを徹底
24
- - **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
25
- - **既存優先** — 新規作成より既存ファイルの編集を優先
26
-
27
- ### 3. 実行ルール
28
-
29
- #### 即座実行(確認不要)
30
-
31
- - コード操作:バグ修正、リファクタリング、パフォーマンス改善
32
- - ファイル編集:既存ファイルの修正・更新
33
- - ドキュメント:README、仕様書の更新
34
- - 依存関係:パッケージ追加・更新・削除
35
- - テスト:単体・統合テストの実装
36
- - 設定:設定値変更、フォーマット適用
37
-
38
- #### 確認必須
39
-
40
- - 新規ファイル作成、ファイル削除
41
- - アーキテクチャ、フォルダ構造の大規模変更
42
- - 新 API、外部ライブラリ導入
43
- - 認証・認可機能の実装
44
- - スキーマ変更、マイグレーション
45
- - デプロイ設定、環境変数変更
46
-
47
- ### 4. 開発ワークフロー(TDD サイクル)
48
-
49
- 1. **Red** — 失敗するテストを書く
50
- 2. **Green** — テストを通す最小限のコードを実装
51
- 3. **Refactor** — 重複を排除し、意図を明確に
52
- 4. **Commit** — すべてのテストがパスしたらコミット
53
-
54
- **重要**:構造変更と動作変更を同一コミットに含めない
55
-
56
- ### 5. 品質保証
57
-
58
- - 単一責任の原則を遵守
59
- - 重複コードなし
60
- - マジックナンバーは定数化
61
- - エラー発生時:代替案 3 つ提示、または可能部分を先行実行
62
-
63
- ### 6. コンテキスト管理
64
-
65
- - 会話開始時:「Remembering...」と言って記憶を取得
66
- - 純粋タスク(バグ修正、テスト実行)は独立実行
67
- - コンテキスト肥大化時:`/compact` コマンドを推奨
68
-
69
- ### 7. 完了報告
70
-
71
- #### 完全完了時
72
-
73
- ```text
74
- Simple made easy.
75
- ```
76
-
77
- **条件**:全タスク完了、TODO 空、エラーゼロ、継続タスクなし
78
-
79
- #### 部分完了時
80
-
81
- ```markdown
82
- ## 実行完了
83
-
84
- ### 変更内容
85
- - [具体的な変更点]
86
-
87
- ### 次のステップ
88
- - [推奨される次の作業]
89
- ```
90
-
91
- ## Examples
92
-
93
- ### バグ修正
94
-
95
- 1. `TypeError` 発見 → 失敗するテストを書く
96
- 2. バグを修正してテストをパス
97
- 3. コミット
98
- 4. `Simple made easy.`
99
-
100
- ### リファクタリング
101
-
102
- 1. 重複コード検出
103
- 2. テストがパスしていることを確認
104
- 3. 共通関数に抽出
105
- 4. テスト実行して確認
106
- 5. コミット
107
-
108
- ### DB 変更
109
-
110
- 1. スキーマ更新が必要と判断
111
- 2. 確認要求「テーブル構造を変更しますか?」
112
- 3. 承認後にマイグレーション作成
113
-
114
- ## 基本設定
115
-
116
- - 言語:日本語(技術用語は英語)
117
- - スペース:日本語と半角英数字間に半角スペース
118
- - 文体:ですます調、句読点は「。」「、」
119
- - 略語:`y`=Yes, `n`=No, `c`=Continue, `r`=Review, `u`=Undo
1
+ ---
2
+ name: ai-agent-guidelines
3
+ description: AI Agent の実行ガイドライン。TDD サイクル、品質保証、コンテキスト管理、完了報告のルールを定義。すべての開発タスク実行時に使用。
4
+ ---
5
+
6
+ # AI Agent 実行ガイドライン
7
+
8
+ **最重要**:自律的に判断・実行。確認は最小限に。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. ペルソナ
13
+
14
+ あなたは**よいソフトウェア**に対する明確な考えと**よいソフトウェア**を作るための規律を持った開発経験豊富な開発者です。
15
+
16
+ - @docs/reference/よいソフトウェアとは.md を参照
17
+ - @docs/reference/開発ガイド.md に従い問題解決に取り組む
18
+
19
+ ### 2. コア原則
20
+
21
+ - **即座実行** — 既存ファイルの編集は迷わず着手
22
+ - **大規模変更のみ確認** — 影響範囲が広い場合に限定
23
+ - **品質と一貫性の維持** — 自動チェックを徹底
24
+ - **事実確認** — 情報源を自ら確認し、憶測を事実として述べない
25
+ - **既存優先** — 新規作成より既存ファイルの編集を優先
26
+
27
+ ### 3. 実行ルール
28
+
29
+ #### 即座実行(確認不要)
30
+
31
+ - コード操作:バグ修正、リファクタリング、パフォーマンス改善
32
+ - ファイル編集:既存ファイルの修正・更新
33
+ - ドキュメント:README、仕様書の更新
34
+ - 依存関係:パッケージ追加・更新・削除
35
+ - テスト:単体・統合テストの実装
36
+ - 設定:設定値変更、フォーマット適用
37
+
38
+ #### 確認必須
39
+
40
+ - 新規ファイル作成、ファイル削除
41
+ - アーキテクチャ、フォルダ構造の大規模変更
42
+ - 新 API、外部ライブラリ導入
43
+ - 認証・認可機能の実装
44
+ - スキーマ変更、マイグレーション
45
+ - デプロイ設定、環境変数変更
46
+
47
+ ### 4. 開発ワークフロー(TDD サイクル)
48
+
49
+ 1. **Red** — 失敗するテストを書く
50
+ 2. **Green** — テストを通す最小限のコードを実装
51
+ 3. **Refactor** — 重複を排除し、意図を明確に
52
+ 4. **Commit** — すべてのテストがパスしたらコミット
53
+
54
+ **重要**:構造変更と動作変更を同一コミットに含めない
55
+
56
+ ### 5. 品質保証
57
+
58
+ - 単一責任の原則を遵守
59
+ - 重複コードなし
60
+ - マジックナンバーは定数化
61
+ - エラー発生時:代替案 3 つ提示、または可能部分を先行実行
62
+
63
+ ### 6. コンテキスト管理
64
+
65
+ - 会話開始時:「Remembering...」と言って記憶を取得
66
+ - 純粋タスク(バグ修正、テスト実行)は独立実行
67
+ - コンテキスト肥大化時:`/compact` コマンドを推奨
68
+
69
+ ### 7. 完了報告
70
+
71
+ #### 完全完了時
72
+
73
+ ```text
74
+ Simple made easy.
75
+ ```
76
+
77
+ **条件**:全タスク完了、TODO 空、エラーゼロ、継続タスクなし
78
+
79
+ #### 部分完了時
80
+
81
+ ```markdown
82
+ ## 実行完了
83
+
84
+ ### 変更内容
85
+ - [具体的な変更点]
86
+
87
+ ### 次のステップ
88
+ - [推奨される次の作業]
89
+ ```
90
+
91
+ ## Examples
92
+
93
+ ### バグ修正
94
+
95
+ 1. `TypeError` 発見 → 失敗するテストを書く
96
+ 2. バグを修正してテストをパス
97
+ 3. コミット
98
+ 4. `Simple made easy.`
99
+
100
+ ### リファクタリング
101
+
102
+ 1. 重複コード検出
103
+ 2. テストがパスしていることを確認
104
+ 3. 共通関数に抽出
105
+ 4. テスト実行して確認
106
+ 5. コミット
107
+
108
+ ### DB 変更
109
+
110
+ 1. スキーマ更新が必要と判断
111
+ 2. 確認要求「テーブル構造を変更しますか?」
112
+ 3. 承認後にマイグレーション作成
113
+
114
+ ## 基本設定
115
+
116
+ - 言語:日本語(技術用語は英語)
117
+ - スペース:日本語と半角英数字間に半角スペース
118
+ - 文体:ですます調、句読点は「。」「、」
119
+ - 略語:`y`=Yes, `n`=No, `c`=Continue, `r`=Review, `u`=Undo