claude-code-conductor 0.4.3__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.3 → 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.3 → claude_code_conductor-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 0.4.3
+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.3 → 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.3"
+__version__ = "0.4.4"