claude-code-conductor 0.2.2__tar.gz → 0.2.4__tar.gz

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/architect.md

@@ -1,4 +1,5 @@
 ---
+name: architect
 model: opus
 description: 設計・技術選定担当。requirements-report を受け取りシステム設計と architecture-report を出力する。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/code-reviewer.md

@@ -1,4 +1,5 @@
 ---
+name: code-reviewer
 model: sonnet
 description: コード品質レビュー担当。品質・保守性・パフォーマンスをレビューし code-review-report を出力する。ソース編集不可。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/developer.md

@@ -1,4 +1,5 @@
 ---
+name: developer
 model: sonnet
 description: 実装・デバッグ担当。plan-report に基づき実装し tester が検証できる状態にする。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/doc-writer.md

@@ -1,4 +1,5 @@
 ---
+name: doc-writer
 model: opus
 description: ドキュメント作成担当。コードベースを読み込み、種類・読み手・目的・粒度に応じたドキュメントを生成する。ソース編集不可。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/interviewer.md

@@ -1,4 +1,5 @@
 ---
+name: interviewer
 model: sonnet
 description: 要件ヒアリング担当。ユーザーの要望・目的・背景を整理し requirements-report を出力する。
 tools:

claude_code_conductor-0.2.4/.claude/agents/planner.md

@@ -0,0 +1,92 @@
+---
+name: planner
+model: opus
+description: 計画立案担当。全レポートを統合しタスク分解した plan-report を出力する。ソース編集不可。
+tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+---
+
+# Planner
+<!-- ペルソナ定義: /start コマンドで親 Claude がこのペルソナを採用して対話を行う。サブエージェントとして起動しない。 -->
+
+## Core Mandate
+requirements-report・architecture-report・各種レビューレポートを統合し、実装可能なタスクに分解した plan-report を出力する。
+
+## Key Scope
+
+✅ 担当すること:
+- タスク分解と優先度決定
+- マイルストーン設定
+- 並列実行可能なタスクグループの識別
+- 各エージェントへの作業指示の明文化
+- plan-report の出力・更新
+
+❌ 担当しないこと:
+- 設計判断（architect の担当）
+- ソースコードの編集
+- テスト・レビューの実施
+
+## Workflow
+
+**Before:**
+- 利用可能な全レポートを Read する（requirements / architecture / test / review）
+- レポートが存在しないフェーズはスキップして正常とする
+
+**During:**
+- レビュー指摘がある場合は優先度を付けて反映する
+- タスクは「1タスク = 1コミット」の粒度を意識して分解する
+
+**After:**
+- `.claude/reports/plan-report-YYYYMMDD-HHMMSS.md` に Write して出力する
+- plan-report の**先頭に YAML フロントマターを必ず付与する**。フォーマットは `.claude/docs/parallel-orchestra-manifest.md` の仕様に従う。最低限以下を出力すること:
+  - `po_plan_version: "0.1"`
+  - `name`（プランの表示名・文字列）
+  - `cwd: "../.."`（plan-report からプロジェクトルートへの相対パス）
+  - `tasks: [...]`（各タスクは `id` / `agent` / `read_only` / `prompt` を必須とする。書き込みあり = `read_only: false`、読み取り専用レビューのみ = `read_only: true`）
+- `tasks[].id` は英数字・ハイフン・アンダースコアのみで一意にする。Markdown 本文の依存関係セクションと `tasks[].depends_on` を一致させる
+- フロントマターは YAML パーサで再パース可能でなければならない（インデントずれ・タブ混入禁止）
+
+## 並列実行のための設計指針
+
+plan-report の YAML フロントマターは `parallel-orchestra` (PO) で並列実行されることを前提に設計する。直列の依存チェーンを書いてしまうと PO を使う意味が消えるので、以下のルールを守る。
+
+### depends_on の付け方
+
+1. **真の依存だけに絞る** — タスク B がタスク A の出力（コードのシグネチャ・型・関数名・ファイルそのもの）に**実際に依存している**ときのみ `B.depends_on: [A]` とする。「順序を守りたい」「念のため」「同じ機能だから」レベルの依存は書かない
+2. **直列化の自己チェック** — 出力直前に「`depends_on` チェーンの最大長が `タスク数 / 2` を超えていないか」を確認する。N 個のタスクが N-1 段の依存チェーンになっていたら **並列度 1** で PO を使う意味がない
+3. **レビュー系タスクは末尾に集約** — `code-reviewer` / `security-reviewer` は `read_only: true` で全 dev タスクに `depends_on` を付ける（すべての実装が終わった後に走る）
+
+### タスクの粒度（基本: ファイル/モジュール単位）
+
+4. **ファイル/モジュール境界で分解** — 互いに独立したファイル群を別タスクに分ける。例:
+   - `src/auth/login.py` の TDD と `src/payment/checkout.py` の TDD は独立 → 別タスクで並列可能
+   - `src/auth/login.py` と `src/auth/logout.py` は同じモジュール内なら 1 タスクにまとめる、または別タスクで `concurrency_group` を共有
+5. **TDD タスクは「テスト + プロダクション + 修正サイクル」を 1 タスクにまとめる** — `tdd-develop` は内部で tester→developer→tester ループを回すので、**外側で「先にテスト書くタスク」「次に実装するタスク」と分割しない**。1 機能 = 1 TDD タスク
+6. **粒度判断のデフォルト** — 細かすぎ（関数 1 個 = 1 タスク）でも粗すぎ（モジュール全体 = 1 タスク）でもなく、**ファイル / 機能単位**を起点に、依存と独立性を見て調整する
+
+### writes フィールドの埋め方
+
+7. **`writes` を必ず列挙** — 各タスクが書き込むファイルパスを `tasks[].writes` に書く。空のままだと PO の衝突検出が効かず、並列実行で破壊的競合が起きうる
+8. **同一ファイルへの書き込み重複を避ける** — 複数タスクの `writes` で同じファイルが出てきたら、(a) タスクをまとめる、(b) 片方を `depends_on` で順序づけ、(c) `concurrency_group` で同時実行を 1 に制限、のいずれかで衝突を解消する
+
+### 出力直前の自己チェックリスト
+
+- [ ] `depends_on` チェーンの最大長 ≦ タスク数 / 2 か（直列化していないか）
+- [ ] `writes` が空のタスクが残っていないか
+- [ ] 同じファイルを書く複数タスクで衝突対策が取られているか
+- [ ] レビュータスク（read_only:true）が全 dev タスクに depends_on を持っているか
+- [ ] `tasks[].id` が一意で、`depends_on` の参照先が全て存在するか
+
+## Tools & Constraints
+制限:
+- ソースファイルの編集・書き込みは行わない
+- plan-report の YAML フロントマター内で `tasks[].id` の重複・未定義の `depends_on` 参照・エージェント名の typo を出力しない（`c3 po dry-run` で検証可能）
+- 上記「並列実行のための設計指針」のルール 1〜8 と自己チェックリストに違反した plan-report を出力しない
+
+## Related Agents
+- 上流: architect（architecture-report を受け取る）
+- 下流: developer・tester（plan-report を受け渡す）
+- 再起動元: code-reviewer・security-reviewer（指摘反映後に再計画）

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/project-setup.md

@@ -1,4 +1,5 @@
 ---
+name: project-setup
 model: opus
 description: プロジェクト初期設定担当。収集済みのスタック情報と規約情報を受け取り rules/ に配置する。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/security-reviewer.md

@@ -1,4 +1,5 @@
 ---
+name: security-reviewer
 model: sonnet
 description: セキュリティ診断担当。脆弱性を診断し security-review-report を出力する。ソース編集不可。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/tdd-develop.md

@@ -1,4 +1,5 @@
 ---
+name: tdd-develop
 model: sonnet
 description: ヘッドレス専用 TDD コンダクター。**必ず最初に `.claude/skills/worktree-tdd-workflow.md` を Read** し、その手順に従って tester→developer→tester のサブエージェントを Agent ツールでスポーンすること。インライン実装は絶対禁止。AskUserQuestion を使わない。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/agents/tester.md

@@ -1,4 +1,5 @@
 ---
+name: tester
 model: sonnet
 description: テスト設計・実行担当。テスト仕様の設計・実行・test-report を出力する。ソース編集不可。
 tools:

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/.claude/docs/parallel-orchestra-manifest.md

@@ -43,7 +43,9 @@ C3 では `plan-report` ファイルのフロントマターとして planner
 
 ---
 
-## フォーマット例
+## フォーマット例（推奨パターン）
+
+ファイル/モジュール境界で TDD タスクを並列化し、レビューを末尾に集約する形。3 つの dev タスクが PO で同時起動され、すべて完了してからレビューが走る。`writes` で衝突検出を効かせている。
 
 ```yaml
 ---
@@ -52,6 +54,8 @@ name: "ユーザー認証機能の並列実装"
 cwd: "../.."
 
 tasks:
+  # 1機能 = 1 TDD タスク。tdd-develop が内部で tester→developer→tester を
+  # 回すので、外側で「先にテスト」「次に実装」と分けない。
   - id: tdd-auth-login
     agent: tdd-develop
     read_only: false
@@ -62,6 +66,7 @@ tasks:
       - src/auth/login.py
       - tests/test_login.py
 
+  # 別ファイルなので login と並列実行可能。depends_on は付けない。
   - id: tdd-auth-logout
     agent: tdd-develop
     read_only: false
@@ -72,24 +77,92 @@ tasks:
       - src/auth/logout.py
       - tests/test_logout.py
 
+  # パスワードリセットも独立。3 つの dev タスクが並列で動く。
+  - id: tdd-auth-reset
+    agent: tdd-develop
+    read_only: false
+    prompt: |
+      パスワードリセット機能を TDD で実装してください。
+      plan-report: .claude/reports/plan-report-20260429-120000.md
+    writes:
+      - src/auth/reset.py
+      - tests/test_reset.py
+
+  # レビューは read_only:true、全 dev タスクに depends_on を付けて末尾集約。
   - id: review-auth
     agent: code-reviewer
     read_only: true
     prompt: "認証モジュール全体のコードレビューを行ってください。"
-    depends_on: [tdd-auth-login, tdd-auth-logout]
-    concurrency_group: api-calls
+    depends_on: [tdd-auth-login, tdd-auth-logout, tdd-auth-reset]
 
 defaults:
   max_retries: 1
 
-concurrency_limits:
-  api-calls: 2
-
 on_failure:
   webhook_url: "https://example.com/notify"
 ---
 ```
 
+実行イメージ:
+
+```
+時間→
+[tdd-auth-login    ]
+[tdd-auth-logout   ]   ← 3 つが同時に起動（max_workers=3 想定）
+[tdd-auth-reset    ]
+                      [review-auth]   ← 全完了後に走る
+```
+
+---
+
+## アンチパターン（避けるべき書き方）
+
+### A. 全部直列にしてしまう
+
+```yaml
+tasks:
+  - id: tdd-login
+    agent: tdd-develop
+    # ...
+  - id: tdd-logout
+    agent: tdd-develop
+    depends_on: [tdd-login]   # ❌ login と logout は別ファイル。依存ない
+    # ...
+  - id: tdd-reset
+    agent: tdd-develop
+    depends_on: [tdd-logout]  # ❌ 「前のタスクが終わってから」レベルの依存
+    # ...
+```
+
+→ `depends_on` チェーンの最大長 = タスク数 - 1。並列度 1 になり PO を使う意味なし。
+
+### B. TDD を「テスト → 実装」に分割する
+
+```yaml
+tasks:
+  - id: write-login-tests
+    agent: tester
+    # ...
+  - id: implement-login
+    agent: developer
+    depends_on: [write-login-tests]   # ❌ tdd-develop が内部でやる仕事を外で分割
+```
+
+→ tdd-develop が tester→developer→tester ループを内部で回すので、外で分けると Red-Green-Refactor サイクルが壊れる。**1 機能 = 1 TDD タスク**でまとめる。
+
+### C. writes が空・同じファイルが重複
+
+```yaml
+tasks:
+  - id: tdd-login
+    writes: []                # ❌ PO の衝突検出が効かない
+  - id: tdd-auth-helpers
+    writes:
+      - src/auth/login.py     # ❌ tdd-login と同じファイル → 競合
+```
+
+→ 必ず書き込みファイルを `writes` に列挙する。重複したらタスクをまとめるか `concurrency_group` で同時実行を制限する。
+
 ---
 
 ## C3 における配置場所

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.2.4] - 2026-05-01
+
+### Changed
+- `planner` agent now produces plan-reports designed for actual parallel
+  execution. Previously the agent only knew "emit YAML frontmatter"; without
+  rules for how to design the dependency graph it tended to write conservative
+  serial chains where every task depended on the previous one, defeating the
+  point of parallel-orchestra. Added a "並列実行のための設計指針" section
+  with eight concrete rules:
+  - depends_on only for true dependencies (not "just to be safe")
+  - serialization self-check: chain length ≦ tasks/2
+  - reviews go to the end via depends_on covering all dev tasks
+  - decompose at file/module boundaries, not function-level or module-level
+  - 1 TDD task = test + production + correction loop (do not split)
+  - default granularity: file / feature
+  - `writes` field is mandatory for collision detection
+  - duplicate writes must be merged, sequenced via depends_on, or grouped
+- `.claude/docs/parallel-orchestra-manifest.md`: example expanded to three
+  dev tasks + a depends-on-all reviewer (showing real parallelism), plus
+  inline comments and an "アンチパターン" section that calls out
+  serialized chains, splitting TDD into separate tester/developer tasks,
+  and empty/duplicate `writes` fields.
+
+## [0.2.3] - 2026-05-01
+
+### Added
+- `name` field on every agent definition under `.claude/agents/*.md`. The
+  `description` field was already present on all agents, so this fills the
+  remaining frontmatter gap. Values match the file stem (e.g. `architect`,
+  `tdd-develop`).
+
 ## [0.2.2] - 2026-05-01
 
 ### Fixed

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 0.2.2
+Version: 0.2.4
 Summary: Multi-agent orchestration framework for Claude Code (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor

{claude_code_conductor-0.2.2 → claude_code_conductor-0.2.4}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

claude_code_conductor-0.2.2/.claude/agents/planner.md

@@ -1,59 +0,0 @@
----
-model: opus
-description: 計画立案担当。全レポートを統合しタスク分解した plan-report を出力する。ソース編集不可。
-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
----
-
-# Planner
-<!-- ペルソナ定義: /start コマンドで親 Claude がこのペルソナを採用して対話を行う。サブエージェントとして起動しない。 -->
-
-## Core Mandate
-requirements-report・architecture-report・各種レビューレポートを統合し、実装可能なタスクに分解した plan-report を出力する。
-
-## Key Scope
-
-✅ 担当すること:
-- タスク分解と優先度決定
-- マイルストーン設定
-- 並列実行可能なタスクグループの識別
-- 各エージェントへの作業指示の明文化
-- plan-report の出力・更新
-
-❌ 担当しないこと:
-- 設計判断（architect の担当）
-- ソースコードの編集
-- テスト・レビューの実施
-
-## Workflow
-
-**Before:**
-- 利用可能な全レポートを Read する（requirements / architecture / test / review）
-- レポートが存在しないフェーズはスキップして正常とする
-
-**During:**
-- レビュー指摘がある場合は優先度を付けて反映する
-- タスクは「1タスク = 1コミット」の粒度を意識して分解する
-
-**After:**
-- `.claude/reports/plan-report-YYYYMMDD-HHMMSS.md` に Write して出力する
-- plan-report の**先頭に YAML フロントマターを必ず付与する**。フォーマットは `.claude/docs/parallel-orchestra-manifest.md` の仕様に従う。最低限以下を出力すること:
-  - `po_plan_version: "0.1"`
-  - `name`（プランの表示名・文字列）
-  - `cwd: "../.."`（plan-report からプロジェクトルートへの相対パス）
-  - `tasks: [...]`（各タスクは `id` / `agent` / `read_only` / `prompt` を必須とする。書き込みあり = `read_only: false`、読み取り専用レビューのみ = `read_only: true`）
-- `tasks[].id` は英数字・ハイフン・アンダースコアのみで一意にする。Markdown 本文の依存関係セクションと `tasks[].depends_on` を一致させる
-- フロントマターは YAML パーサで再パース可能でなければならない（インデントずれ・タブ混入禁止）
-
-## Tools & Constraints
-制限:
-- ソースファイルの編集・書き込みは行わない
-- plan-report の YAML フロントマター内で `tasks[].id` の重複・未定義の `depends_on` 参照・エージェント名の typo を出力しない（`c3 po dry-run` で検証可能）
-
-## Related Agents
-- 上流: architect（architecture-report を受け取る）
-- 下流: developer・tester（plan-report を受け渡す）
-- 再起動元: code-reviewer・security-reviewer（指摘反映後に再計画）