diff --git a/.claude/agents/coder.md b/.claude/agents/coder.md index 08ddce6..e99928f 100644 --- a/.claude/agents/coder.md +++ b/.claude/agents/coder.md @@ -42,7 +42,7 @@ ## 作業手順 (Workflow) -1. **ドキュメントを読む**: `docs/` 内の関連ファイル（仕様書，コーディング規約等）を確認する +1. **ドキュメントと規約を読む**: `docs/` 内の関連ファイル（仕様書等）と，`.claude/rules/` のプロジェクト固有規約（coding-style・error-handling 等，存在する場合）を確認する 2. **既存コードを理解する**: 変更対象のコードとその周辺を読み，既存のパターン・ユーティリティを把握する 3. **実装する**: タスクの要件に沿って実装する．既存の関数やユーティリティがあれば再利用する 4. **実装サマリーを出力する**: 以下のフォーマットで出力する diff --git a/.claude/agents/refactorer.md b/.claude/agents/refactorer.md index 3c4a339..eeca8df 100644 --- a/.claude/agents/refactorer.md +++ b/.claude/agents/refactorer.md @@ -40,7 +40,7 @@ ## 作業手順 (Workflow) -1. **コーディング規約を読む**: プロジェクトのコーディング規約（存在する場合）を確認する +1. **コーディング規約を読む**: プロジェクトのコーディング規約（`.claude/rules/` の coding-style 等，存在する場合）を確認する 2. **サマリーを確認する**: Coder・Tester エージェントの出力を読む 3. **変更差分を確認する**: `git diff` で全変更内容を確認する 4. **テストを実行する**: 現時点でテストが全て通ることを確認する（開始前のベースライン） diff --git a/.claude/agents/tester.md b/.claude/agents/tester.md index a5a4566..723f624 100644 --- a/.claude/agents/tester.md +++ b/.claude/agents/tester.md @@ -41,7 +41,7 @@ ## 作業手順 (Workflow) 1. **仕様を読む**: `docs/04_SPEC/` 内の関連仕様書を確認する -2. **テスト方針を読む**: テスト方針のガイド（存在する場合）を確認する +2. **テスト方針を読む**: プロジェクトのテスト方針（`.claude/rules/` の testing 等，存在する場合）を確認する 3. **実装サマリーを確認する**: Coder エージェントの出力を読み，何が変更されたかを把握する 4. **変更差分を確認する**: `git diff` で実際の変更内容を確認する 5. **テストを作成する**: @@ -55,7 +55,7 @@ ## テスト作成の原則 (Testing Principles) - テスト対象の関数・クラスの**期待される振る舞い**をテストする（実装の詳細ではない） -- プロジェクトのテスト方針ガイド（存在する場合）に従う（テストの種類，カバレッジ基準，モック方針，ファイル配置等） +- プロジェクトのテスト方針（`.claude/rules/testing.md` 等，存在する場合）に従う（テストの種類，カバレッジ基準，モック方針，ファイル配置等） - プロジェクトの既存テストのパターン・構造に合わせる ## 出力フォーマット (Output Format) diff --git a/.claude/rules/docs-naming.md b/.claude/rules/docs-naming.md index 58751ea..121b145 100644 --- a/.claude/rules/docs-naming.md +++ b/.claude/rules/docs-naming.md @@ -22,7 +22,7 @@ | カテゴリ | ディレクトリ | 内容 | 対象例 | | --- | --- | --- | --- | -| `GUIDE_` | `01_GUIDE/` | ルール，規約，運用フロー | スタイルガイド，命名規則，Git 運用ルール | +| `GUIDE_` | `01_GUIDE/` | 運用フロー・ガイド | 立ち上げフロー，エージェント運用，チーム開発ルール | | `ENV_` | `02_ENV/` | 開発環境，プロジェクトの土台 | 環境構築手順，技術スタック一覧，パッケージ構成図 | | `PLAN_` | `03_PLAN/` | 進行計画，スケジュール，要件定義 | WBS，ロードマップ，要件定義書，タスク一覧 | | `SPEC_` | `04_SPEC/` | ユーザーから見える仕様 | 企画書，画面遷移図，パラメータ設定 | @@ -33,3 +33,4 @@ - 1 ファイル 1 テーマ: ファイルサイズが肥大化しすぎないよう，トピックごとにファイルを分割することを推奨する．これにより，AI へのコンテキスト入力精度が向上する． - スタイルの継承: 新規作成するファイルも，必ず [markdown-style](markdown-style.md) ルールに記載された書式に従うこと． +- 規約の置き場所: 「常に従うべき指示型の規約」（コーディング規約・テスト方針等）は docs ではなく `.claude/rules/` に path-scoped rule として置く（GUIDE_01「規約整備」参照）．docs に置くのは運用フロー・仕様・設計等の参照資料． diff --git a/.claude/rules/git-conventions.md b/.claude/rules/git-conventions.md index 6375ae9..8c4dd97 100644 --- a/.claude/rules/git-conventions.md +++ b/.claude/rules/git-conventions.md @@ -5,7 +5,7 @@ ## 基本方針 (Basic Policy) -チーム開発におけるコードの整合性を保ち，手戻りを防ぐために以下の運用フローを徹底する． +コードの整合性を保ち，手戻りを防ぐために，開発モード（solo / team）を問わず以下の運用を徹底する． - **メインブランチ (main)**: - 本番環境または常に動作可能な状態を維持するブランチ． diff --git a/.claude/skills/sync-template/SKILL.md b/.claude/skills/sync-template/SKILL.md index 340f438..069f775 100644 --- a/.claude/skills/sync-template/SKILL.md +++ b/.claude/skills/sync-template/SKILL.md @@ -358,7 +358,7 @@ コピーされた変更を以下のカテゴリに分類する: -- **ルール変更**: コーディング規約，Git 運用ルール，テスト方針等の変更 +- **ルール変更**: コーディング規約，Git 運用ルール，テスト方針等の変更（`.claude/rules/` 配下の変更を含む） - **ドキュメント更新**: 手順書やガイドの改善 - **設定変更**: CLAUDE.md や .claude/ 配下の変更 - **その他**: 上記に該当しない変更 diff --git a/README.md b/README.md index 71e4f02..214daf9 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ ## ドキュメント -`docs/01_GUIDE/` にプロジェクト運用の規約・ルールが置かれている．`/setup` を実行すれば AI がこれらを順次参照しながら立ち上げを進める． +`docs/01_GUIDE/` にプロジェクト運用のガイドが置かれている．`/setup` を実行すれば AI がこれらを順次参照しながら立ち上げを進める． - `GUIDE_01_プロジェクト立ち上げフロー.md` — 立ち上げの 7 フェーズ（方針決定 → 実装開始） - `GUIDE_02_エージェント運用ルール.md` — `/implement` のエージェントチーム運用 diff --git "a/docs/01_GUIDE/GUIDE_03_\343\203\201\343\203\274\343\203\240\351\226\213\347\231\272\343\203\253\343\203\274\343\203\253.md" "b/docs/01_GUIDE/GUIDE_03_\343\203\201\343\203\274\343\203\240\351\226\213\347\231\272\343\203\253\343\203\274\343\203\253.md" index 0450c47..186413f 100644 --- "a/docs/01_GUIDE/GUIDE_03_\343\203\201\343\203\274\343\203\240\351\226\213\347\231\272\343\203\253\343\203\274\343\203\253.md" +++ "b/docs/01_GUIDE/GUIDE_03_\343\203\201\343\203\274\343\203\240\351\226\213\347\231\272\343\203\253\343\203\274\343\203\253.md" @@ -28,7 +28,7 @@ - PR と Issue を紐付ける場合は本文に `Closes #` を記載する．マージ時に Issue が自動クローズされ，ボードのカードも `Done` へ移る． - Issue 本文には少なくとも「やること」を書く．「完了条件（受け入れ基準）」は非自明な作業のみで構わない． - 担当者は明確にしておくのが望ましい（重複着手を避けるため）． -- Issue は最初に書き切らなくてよい．`/implement` の Phase 4 で実装サマリーを Issue にコメントし，必要に応じて本文も育てる（GUIDE_02）． +- Issue は最初に書き切らなくてよい．作業途中の進捗・確定事項は `/task-handoff` の進捗メモとして Issue に集約し，完了は PR の `Closes #<番号>` によるマージ時の自動クローズで反映する（`/implement` のフローでは Issue を更新しない）． ### Project ボード (Project Board)