diff --git a/.claude/commands/implement.md b/.claude/commands/implement.md index 61fda83..a03126c 100644 --- a/.claude/commands/implement.md +++ b/.claude/commands/implement.md @@ -82,17 +82,7 @@ Refactorer の出力(リファクタリングサマリー)を記録する. -### 人間の確認ポイント 3 - -Refactorer のリファクタリングサマリーをユーザーに提示し,以下を依頼する: - -「**Phase 3(リファクタリング)が完了しました.** - -{Refactorer のリファクタリングサマリー} - -全フェーズが完了しました.最終確認をお願いします. -- **OK** → コミット・push・PR 作成に進みます -- **NG** → 修正点を教えてください」 +Refactorer の出力後,確認を挟まず Phase 4 に進む. ## Phase 4: ドキュメント更新 (Documentation) diff --git a/CLAUDE.md b/CLAUDE.md index 6242d33..9b92367 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,15 +15,15 @@ - ブランチ名: `feature/`/`fix/`/`docs/`/`chore/` + 英単語 2〜4 語(kebab-case) - コミットメッセージ: `[add]`/`[update]`/`[fix]`/`[remove]`/`[clean]` + 日本語 -- コミット・push 後は `gh pr create` で PR を作成する +- コミットは `/commit` を使用する(push・PR 作成は `/commit push`) ### エージェントチーム(GUIDE_05 準拠) -- 実装は `/implement <タスク>` で開始する(コーディング → テスト → リファクタリング) -- 各フェーズ間で人間が動作確認・方針判断を行う +- 実装は `/implement <タスク>` で開始する(コーディング → テスト → リファクタリング → ドキュメント更新) +- Phase 1 後に人間が動作確認,Phase 2 でテスト失敗時のみ方針判断 +- Phase 2 成功後は Phase 3 → Phase 4 まで自動で進む(Phase 4 で更新がある場合のみ確認) - 個別実行: coder → tester → refactorer を順に実行 - テスト・リファクタリングをスキップしない(Stop Hook が警告) -- Phase 3 完了後,コミット前に docs/ の更新要否を確認する ### 手動確認が必要な作業(自分で完了させないこと) 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 63ec124..ea040dc 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" @@ -50,15 +50,12 @@ │ テストを安全網としてリファクタリング │ テスト再実行で挙動が変わっていないことを保証 │ - ├─ ドキュメント更新チェック - │ 変更内容に関連する docs/ の更新要否を確認 - │ 必要なら更新してからコミットへ進む + ├─ Phase 4 ──▶ ドキュメント更新 + │ docs/ と CLAUDE.md を必要に応じて更新 + │ 更新がある場合のみ人間の確認を挟む + │ 結果を .claude/commit-context.md に書き出す │ - ├─ 人間の確認ポイント 3 - │ 最終確認 - │ OK → コミット・push・PR 作成 - │ - └─ CLAUDE.md 進捗更新 + └─ 完了 → /commit でコミット ``` ### Phase 1: コーディング (Coding) @@ -94,9 +91,9 @@ - リファクタリング後にテストを再実行し,全テストが通ることを確認する. - リファクタリング不要と判断した場合は,理由を明示して終了する. -### ドキュメント更新チェック (Documentation Update Check) +### Phase 4: ドキュメント更新 (Documentation) -Phase 3 完了後,コミット前に `docs/` 配下のドキュメント更新が必要かを確認する.エージェントが更新候補を提示し,人間が最終判断する. +Phase 3 完了後,実装内容に応じて `docs/` と `CLAUDE.md` を更新する. - **チェック観点**: - API・データ構造の変更 → `docs/04_SPEC/` の該当仕様を更新 @@ -104,11 +101,13 @@ - 開発ステップの進捗 → `docs/03_PLAN/` や `CLAUDE.md` の進捗欄を更新 - 規約・運用ルールの変更 → `docs/01_GUIDE/` を更新 - **該当なし**: ドキュメント更新が不要な変更(軽微なバグ修正,リファクタリングのみ等)はスキップ可. -- **実行者**: エージェントが `git diff` を基に更新候補を提示し,人間が更新要否を判断する. +- **更新がある場合のみ**人間の確認を挟む.更新不要の場合は確認なしで完了処理に進む. +- **コミットコンテキストの書き出し**: Phase 4 の結果(更新の有無と理由)を `.claude/commit-context.md` に書き出す.このファイルは `/commit` が参照し,docs/CLAUDE.md の更新漏れチェックをスキップするために使う(`.gitignore` 対象). -### 人間の確認ポイント 3 +### 完了処理 -- 最終確認を行い,OK ならコミット・push・PR 作成を指示する. +- `/implement` はコミットを行わない.完了後は `/commit` でコミットする. +- `/commit` は `.claude/commit-context.md` が存在する場合,docs/CLAUDE.md の更新漏れチェックをスキップする.存在しない場合(`/implement` を経由していない場合)は警告のみ行う. ## コンテキスト受け渡し (Context Passing) @@ -127,7 +126,7 @@ | 開始時 | タスクの指示(`/implement <何をするか>`) | | Phase 1 後 | 動作確認(ブラウザ・実機など AI にできない確認) | | Phase 2 後 | テスト失敗時のみ方針判断(全成功なら自動で Phase 3 へ) | -| Phase 3 後 | ドキュメント更新の要否判断 + 最終確認 → コミット・PR 作成の指示 | +| Phase 4 後 | ドキュメント更新がある場合のみ確認 → `/commit` でコミット | 人間の本質的な役割は「AI にできない判断と確認」であり,各フェーズの品質のゲートキーパーとなる. @@ -151,7 +150,7 @@ ## コミットルール (Commit Rules) -パイプライン完了後のコミットは [GUIDE_04](GUIDE_04_Git運用ルール.md) に従う. +パイプライン完了後は `/commit` でコミットする.コミットの詳細は [GUIDE_04](GUIDE_04_Git運用ルール.md) に従う. | 内容 | コミットタグ | | --- | --- |