diff --git a/.claude/agents/coder.md b/.claude/agents/coder.md index 5f9bfc6..c85583c 100644 --- a/.claude/agents/coder.md +++ b/.claude/agents/coder.md @@ -8,7 +8,11 @@ - Grep - Edit - Write - - Bash(git *) + - Bash(git diff *) + - Bash(git status *) + - Bash(git log *) + - Bash(git stash *) + - Bash(git branch *) - Bash(npm *) - Bash(npx *) - Bash(pnpm *) diff --git a/.claude/commands/commit.md b/.claude/commands/commit.md index be28522..1610d69 100644 --- a/.claude/commands/commit.md +++ b/.claude/commands/commit.md @@ -18,7 +18,7 @@ **main ブランチにいる場合は自動でブランチを作成する:** -1. 変更内容から適切なプレフィックス(`feature/`/`fix/`/`docs/`/`chore/`)と英単語 2〜4 語のブランチ名を決定する +1. 変更内容から GUIDE_04 のブランチ命名規則に従い,適切なプレフィックスと英単語 2〜4 語のブランチ名を決定する 2. `git checkout -b {ブランチ名}` で作業ブランチを作成する 3. 以降のステップを続行する diff --git a/.claude/commands/implement.md b/.claude/commands/implement.md index 3e183bc..585a295 100644 --- a/.claude/commands/implement.md +++ b/.claude/commands/implement.md @@ -11,7 +11,7 @@ 1. 現在のブランチを確認する(`git branch --show-current`) 2. `main` ブランチにいる場合,GUIDE_04 に従い作業ブランチを作成する - - ブランチ名: `feature/`/`fix/` + タスク内容を表す英単語 2〜4 語(kebab-case) + - GUIDE_04 のブランチ命名規則に従い,適切なプレフィックスとタスク内容を表す英単語 2〜4 語(kebab-case)でブランチ名を決定する 3. 実装対象のタスクを確認する: $ARGUMENTS ## Phase 1: コーディング (Coder) diff --git a/.gitignore b/.gitignore index 4419375..d2f109f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,9 @@ # /implement が /commit に渡すコンテキストファイル .claude/commit-context.md + +# -- プロジェクト立ち上げ時に有効化する(GUIDE_04 参照) -- +# .env +# .env.* +# node_modules/ +# build/ +# dist/ diff --git a/CLAUDE.md b/CLAUDE.md index 54e4d3d..001eb33 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,8 +13,7 @@ ### Git 運用(GUIDE_04 準拠) -- ブランチ名: `feature/`/`fix/`/`refactor/`/`docs/`/`chore/` + 英単語 2〜4 語(kebab-case) -- コミットメッセージ: `[add]`/`[update]`/`[fix]`/`[remove]`/`[clean]` + 日本語 +- ブランチ名・コミットメッセージの書式は GUIDE_04 に従う - コミットは `/commit` を使用する(push・PR 作成は `/commit push`) ### エージェントチーム(GUIDE_05 準拠) @@ -58,3 +57,11 @@ ### 04_SPEC(仕様・設計) + +### 05_TECH(技術設計) + + + +### 06_TEST(テスト) + + diff --git "a/docs/01_GUIDE/GUIDE_01_\343\203\227\343\203\255\343\202\270\343\202\247\343\202\257\343\203\210\347\253\213\343\201\241\344\270\212\343\201\222\343\203\225\343\203\255\343\203\274.md" "b/docs/01_GUIDE/GUIDE_01_\343\203\227\343\203\255\343\202\270\343\202\247\343\202\257\343\203\210\347\253\213\343\201\241\344\270\212\343\201\222\343\203\225\343\203\255\343\203\274.md" index df2797d..085859c 100644 --- "a/docs/01_GUIDE/GUIDE_01_\343\203\227\343\203\255\343\202\270\343\202\247\343\202\257\343\203\210\347\253\213\343\201\241\344\270\212\343\201\222\343\203\225\343\203\255\343\203\274.md" +++ "b/docs/01_GUIDE/GUIDE_01_\343\203\227\343\203\255\343\202\270\343\202\247\343\202\257\343\203\210\347\253\213\343\201\241\344\270\212\343\201\222\343\203\225\343\203\255\343\203\274.md" @@ -67,13 +67,13 @@ - **基本方針**: 言語・フレームワークの公式ガイドラインや広く採用されている標準規約に則る(例: Effective Dart,PEP 8,Google Style Guide 等).プロジェクト固有のルールは標準と異なる部分のみ定義する. - **人間が決めること**: 標準規約でカバーされない判断(アーキテクチャパターンの選択等) - **AI に依頼できること**: 標準規約を踏まえた規約のドラフト作成,参照元ガイドラインの調査 -- **作成すべきガイド**: - - コーディング規約 — 命名規則,フォーマット,import 順序,型の使い方,コメントの書き方,コード内ドキュメントの規則 - - ディレクトリ構造規則 — プロジェクトのディレクトリ構成とファイル配置ルール - - テスト方針 — テストの種類,粒度,実行タイミング,カバレッジ基準 - - エラーハンドリング方針 — エラーの分類,処理方法,ログ出力の方針 - - リファクタリング方針 — リファクタリングの判断基準,実施タイミング - - 機能実装完了フロー — コミット前のチェックリスト(フォーマット,静的解析,テスト,レビュー等) +- **作成すべきガイド**(推奨番号は GUIDE_03 に準拠): + - `GUIDE_06` コーディング規約 — 命名規則,フォーマット,import 順序,型の使い方,コメントの書き方,コード内ドキュメントの規則 + - `GUIDE_07` ディレクトリ構造規則 — プロジェクトのディレクトリ構成とファイル配置ルール + - `GUIDE_08` テスト方針 — テストの種類,粒度,実行タイミング,カバレッジ基準 + - `GUIDE_09` エラーハンドリング方針 — エラーの分類,処理方法,ログ出力の方針 + - `GUIDE_10` リファクタリング方針 — リファクタリングの判断基準,実施タイミング + - `GUIDE_11` 機能実装完了フロー — コミット前のチェックリスト(フォーマット,静的解析,テスト,レビュー等) ## 開発計画 (Development Plan) diff --git "a/docs/01_GUIDE/GUIDE_05_\343\202\250\343\203\274\343\202\270\343\202\247\343\203\263\343\203\210\351\201\213\347\224\250\343\203\253\343\203\274\343\203\253.md" "b/docs/01_GUIDE/GUIDE_05_\343\202\250\343\203\274\343\202\270\343\202\247\343\203\263\343\203\210\351\201\213\347\224\250\343\203\253\343\203\274\343\203\253.md" index 26a0ae9..7ea2b07 100644 --- "a/docs/01_GUIDE/GUIDE_05_\343\202\250\343\203\274\343\202\270\343\202\247\343\203\263\343\203\210\351\201\213\347\224\250\343\203\253\343\203\274\343\203\253.md" +++ "b/docs/01_GUIDE/GUIDE_05_\343\202\250\343\203\274\343\202\270\343\202\247\343\203\263\343\203\210\351\201\213\347\224\250\343\203\253\343\203\274\343\203\253.md" @@ -134,13 +134,15 @@ パイプラインを使わず個別にエージェントを実行することも可能だが,3 フェーズすべてを順番に実行すること. -```bash -# 個別実行の場合 -/coder # Phase 1 +※ `coder`,`tester`,`refactorer` は `.claude/agents/` に定義されたエージェントであり,`/implement` のオーケストレーターが Agent ツール経由で呼び出す.個別実行する場合も,各エージェントを Agent ツールで順に呼び出す. + +``` +# 個別実行の流れ +Agent(coder) # Phase 1 # → 人間が動作確認 -/tester # Phase 2 +Agent(tester) # Phase 2 # → 人間がテスト結果確認 -/refactorer # Phase 3 +Agent(refactorer) # Phase 3 # → 人間が最終確認 → コミット ``` @@ -153,5 +155,7 @@ | 機能追加 | `[add]` | | 機能更新 | `[update]` | | バグ修正 | `[fix]` | +| 削除 | `[remove]` | +| 整理・リファクタリング | `[clean]` | ※ リファクタリングとテストは実装と一体の成果物として,まとめてコミットする.必要に応じて分割コミットも可.