claude-code-conductor 0.4.2__tar.gz → 0.4.4__tar.gz

claude_code_conductor-0.4.4/.claude/CLAUDE.md

@@ -0,0 +1,181 @@
+# Claude Code Conductor (C3)
+
+複数エージェントのオーケストレーションを中心に据えた Claude Code フレームワーク。
+
+## Startup Protocol
+
+セッション開始時に必ず `/init-session` を実行する。
+
+## Language
+
+ユーザーとの応答は日本語で行うこと。コード・コマンド・ファイルパスは除く。
+
+## Session Update Rules
+
+session ファイルはタスク完了のたびに更新する。まとめて最後に書かない。
+
+| タイミング | 更新内容 |
+|---|---|
+| タスク完了時 | 残タスクの該当行を `[x]` にする |
+| 良いアプローチを発見したとき | `## うまくいったアプローチ` に追記 |
+| 失敗・ハマったとき | `## 試みたが失敗したアプローチ` に追記 |
+| パターンを発見したとき | JSON ブロックの `patterns` 配列に追記 |
+| 新しいタスクが発生したとき | `## 残タスク` に追記 |
+
+## Pattern Recording
+
+session ファイルの JSON ブロックにパターンを記録する:
+
+```json
+"patterns": [
+  {
+    "id": "一意なID（英数字・アンダースコア）",
+    "description": "どんな状況でどう対処するかを1文で"
+  }
+]
+```
+
+`stop.py` がセッション終了時に `patterns.json` を自動更新する。
+信用度が 0.8 以上・登録から3日以上経過したパターンは `/promote-pattern` で昇格できる。
+
+## User Interaction Rules
+
+ユーザーと対話するコマンド（`/agent-interviewer`・`/agent-architect`・`/agent-planner` 等）を実行する際に守ること。
+
+### 書く前に考える
+
+長い出力・実装・設計を始める前に、1〜3行で計画を提示してユーザーの確認を取る。
+確認なしに一気に書き始めない。
+
+### 質問の仕方
+
+**OK（推奨）:**
+- 1回に1つの質問に絞る
+- 選択肢を提示してユーザーが選びやすい形にする
+  ```
+  ○○について教えてください:
+    [A] ...
+    [B] ...
+    [C] その他（自由記述）
+  ```
+- 表面的な要望の背景まで掘り下げる（「なぜそれが必要か」）
+
+**NG（禁止）:**
+- 複数の質問を一度に投げる
+  ```
+  ❌ 「目的・制約・スケジュールを教えてください」
+  ✅ 「まず目的を教えてください」→ 回答後に次の質問へ
+  ```
+- 推測で進めて後から修正する
+  ```
+  ❌ 「おそらく○○だと思うので進めます」
+  ✅ 「○○という理解で合っていますか？」
+  ```
+
+### 承認を求めるタイミング
+
+各エージェントの出力後は必ずユーザーに内容を提示し、Approval Flow（下記）に従って承認を求める。
+承認なしに次フェーズへ進まない。
+
+## Approval Flow
+
+エージェントの出力をユーザーが確認する際の標準フロー。
+親 Claude が AskUserQuestion ツールで構造化された選択肢を提示する。
+
+### 標準承認フロー
+
+```json
+{
+  "questions": [{
+    "question": "{確認対象の概要} の内容を確認してください。どうしますか？",
+    "options": [
+      { "label": "承認", "description": "このまま次のフェーズへ進む" },
+      { "label": "否認・修正を依頼する", "description": "フィードバックを入力してエージェントに再実行させる" },
+      { "label": "否認・自分で修正する", "description": "自分でファイルを編集してから続ける" }
+    ]
+  }]
+}
+```
+
+### 選択後の処理
+
+**「承認」の場合:**
+次のフェーズへ進む。
+
+**「否認・修正を依頼する」の場合:**
+追加の AskUserQuestion でフィードバックを自由入力させる:
+```json
+{
+  "questions": [{
+    "question": "どのように修正してほしいですか？"
+  }]
+}
+```
+入力内容をプロンプトに含めてエージェントを再起動する。
+
+**「否認・自分で修正する」の場合:**
+```
+修正が完了したら声をかけてください。続きから再開します。
+```
+ユーザーの合図を待ってから次のステップへ進む。
+
+### コンテキスト別のカスタム選択肢
+
+標準の3択に加え、コンテキストに応じて選択肢を追加してよい:
+
+| コンテキスト | 追加しうる選択肢 |
+|---|---|
+| developer の実装確認 | 「否認・自分でコードを修正する」 |
+| tester の test-report 確認 | 「このまま次の tester フェーズへ」 |
+| reviewer の report 確認 | 「Low 指摘のみ・このまま完了する」 |
+
+## Compact Instructions
+
+### KEEP（保持する）
+- **設計判断（Architectural Decisions）** — なぜその技術を選んだか、トレードオフの記録
+- **決定事項（Key Conclusions）** — 議論の末に確定した仕様、ディレクトリ構造、命名規則
+- **解決済みのハマりどころ（Caveats）** — 修正に苦労したバグの原因と恒久的な対策
+- **進行中のステータス（TODO/Status）** — 現在取り組んでいるタスクと次のステップ、残タスク
+
+### DISCARD（捨てる）
+- **雑談・挨拶（Chit-chat）** — 「ありがとうございます」「お疲れ様です」等の社交辞令
+- **解決済みのエラーログ（Logs）** — 一時的なエラーログ・デバッグ出力（原因と対策は Caveats で保持）
+- **冗長なコード断片（Snippets）** — git 管理されているソースコード本体の重複コピー
+- **期限切れのタスク（Old Tasks）** — 既に完了し、今後の開発に影響を与えない古い作業記録
+
+## Available Commands
+
+| コマンド | 目的 |
+|---|---|
+| `/init-session` | セッション初期化・前回状態の復元 |
+| `/promote-pattern` | 昇格候補パターンを rules/ または skills/ に昇格 |
+| `/setup` | コーディング規約の設定（標準規約 + 独自規約） |
+| `/start` | 開発ワークフローの入口（ヒアリング→設計→計画）|
+| `/develop` | 実装フェーズ（TDD: tester→developer→tester） |
+| `/code-review` | レビューフェーズ（code-reviewer→security-reviewer） |
+| `/doc` | ドキュメント生成（doc-writer エージェント） |
+| `/mcp-config` | MCP サーバーの追加・一覧・削除 |
+| `/extract-lib` | 複数プロジェクトの共通コードを抽出してライブラリ設計・生成 |
+
+## Directory Structure
+
+```
+.claude/
+├── agents/                        # エージェント定義（誰か・何ができるか・何ができないか）
+├── docs/                          # 人間向けリファレンス（エージェントは読まなくてよい）
+├── hooks/                         # イベントドリブンで自動実行される Python スクリプト
+├── rules/                         # エージェントに注入される背景知識・制約
+│   └── promoted/                  # /promote-pattern で昇格したルール
+├── skills/                        # 複数エージェントをまたぐオーケストレーション手順
+│   └── promoted-YYYYMMDD-{id}/    # /promote-pattern で昇格したスキル
+└── memory/                        # セッション記憶・パターン信用度データ
+```
+
+詳細は `.claude/docs/taxonomy.md` を参照。
+
+---
+
+## C3 Managed
+<!-- このセクションは C3 のコマンドが自動で更新する。手動で編集しないこと。 -->
+
+@rules/promoted/index.md

{claude_code_conductor-0.4.2 → claude_code_conductor-0.4.4}/.claude/agents/planner.md

@@ -69,13 +69,13 @@ plan-report の YAML フロントマターは `parallel-orchestra` (PO) で並
 
 ### writes フィールドの埋め方
 
-7. **`writes` を必ず列挙** — 各タスクが書き込むファイルパスを `tasks[].writes` に書く。空のままだと PO の衝突検出が効かず、並列実行で破壊的競合が起きうる
+7. **`writes` を必ず列挙（`read_only: true` タスクは除く）** — 各タスクが書き込むファイルパスを `tasks[].writes` に書く。空のままだと PO の衝突検出が効かず、並列実行で破壊的競合が起きうる。ただし `read_only: true`（レビュー系）タスクはファイルを書かないため `writes` フィールド自体を省略すること
 8. **同一ファイルへの書き込み重複を避ける** — 複数タスクの `writes` で同じファイルが出てきたら、(a) タスクをまとめる、(b) 片方を `depends_on` で順序づけ、(c) `concurrency_group` で同時実行を 1 に制限、のいずれかで衝突を解消する
 
 ### 出力直前の自己チェックリスト
 
 - [ ] `depends_on` チェーンの最大長 ≦ タスク数 / 2 か（直列化していないか）
-- [ ] `writes` が空のタスクが残っていないか
+- [ ] `writes` が空のタスクが残っていないか（`read_only: true` タスクは `writes` 自体を省略していること）
 - [ ] 同じファイルを書く複数タスクで衝突対策が取られているか
 - [ ] レビュータスク（read_only:true）が全 dev タスクに depends_on を持っているか
 - [ ] `tasks[].id` が一意で、`depends_on` の参照先が全て存在するか

{claude_code_conductor-0.4.2 → claude_code_conductor-0.4.4}/.claude/skills/init-session/SKILL.md

@@ -80,10 +80,7 @@ AskUserQuestion ツールで以下を提示する:
 残タスクの内容を確認してそのまま作業に入る。
 
 **「ワークフローで始める」の場合:**
-```
-/start を実行してください。
-ヒアリング → 設計 → 計画 → 実装 → レビューの順で進みます。
-```
+Skill ツールで `start` スキルを呼び出す。
 
 **「直接指示する」の場合:**
 ```

claude_code_conductor-0.4.4/.claude/skills/report-timestamp/SKILL.md

@@ -0,0 +1,23 @@
+---
+description: レポートファイル名に使用するタイムスタンプ (YYYYMMDD-HHMMSS) を取得する。requirements-report・architecture-report・plan-report・code-review-report・security-review-report・test-report などのレポートファイルを生成する際は、必ずこのスキルを使用してファイル名のタイムスタンプを決定すること。
+user-invocable: false
+---
+
+# report-timestamp
+
+レポートファイル名用のタイムスタンプを Python で取得する。
+
+## 使い方
+
+レポートファイル名が必要になったら、以下を実行してその出力をファイル名に使用する:
+
+```bash
+python "${CLAUDE_SKILL_DIR}/scripts/get_timestamp.py"
+```
+
+出力形式: `YYYYMMDD-HHMMSS`（例: `20260504-143022`）
+
+## 注意
+
+- PowerShell・bash の date コマンドは使わない（時刻部分が 000000 になる場合がある）
+- python コマンドが使えない場合のみ `python3` にフォールバックする

claude_code_conductor-0.4.4/.claude/skills/report-timestamp/scripts/get_timestamp.py

@@ -0,0 +1,2 @@
+from datetime import datetime
+print(datetime.now().strftime('%Y%m%d-%H%M%S'), end='')

{claude_code_conductor-0.4.2 → claude_code_conductor-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 0.4.2
+Version: 0.4.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.4.2 → claude_code_conductor-0.4.4}/src/c3/__init__.py

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