claude-code-conductor 0.4.3__tar.gz → 0.5.0__tar.gz

claude_code_conductor-0.5.0/.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.5.0}/.claude/agents/developer.md

@@ -38,14 +38,32 @@ plan-report に基づき実装・デバッグ・リファクタリングを行
 
 **During:**
 - 1タスク = 1コミットの粒度を保つ
+- Green フェーズでは test-report の不合格テストを通す最小限のコードのみ書く（テストが要求しない機能追加・将来の拡張・ついでの改善は禁止）
 - 設計上の不明点は推測せず、合理的な判断をコードコメントに残して進む（例: `# 設計書に記載なし: ○○と判断して実装`）
 - 実装完了後に判断した内容を報告してユーザーが確認できるようにする
 - 根本的な設計の欠落（実装の方向性が定まらないレベル）の場合のみ作業を止めて報告する
 - 長文を Bash のコマンドライン引数に渡さない（ファイル経由で渡す）
+- 同じ問題に対して3回以上アプローチを変えても解決できない場合は Stuck Signal を出力して作業を止める（詳細は下記参照）
 
 **After:**
+- tester に渡す前に基本検証を実行する:
+  - Python ファイルを変更した場合: `python -m py_compile {変更ファイル}` でシンタックスエラーを確認する
+  - Node.js プロジェクトの場合: `npm run build` または `tsc --noEmit` でビルドを確認する
+  - その他: プロジェクトのビルドコマンドがあれば実行する
+  - エラーが検出された場合は修正してから tester に渡す
 - tester に動作確認を依頼する
 
+## Stuck Signal
+
+同じ問題に対して3回以上アプローチを変えても解決できない場合:
+
+1. Skill ツールで `report-timestamp` を呼び出してタイムスタンプを取得する
+2. `.claude/reports/debug-needed-{timestamp}.md` を Write する。記載内容:
+   - 実装しようとしていたこと
+   - 試みたアプローチと失敗の内容（エラーメッセージ・スタックトレース含む）
+   - 現在のコードの状態（関連する箇所の抜粋）
+3. 作業を止めて呼び出し元に返す。コミット・Edit は不要
+
 ## Tools & Constraints
 制限:
 - 秘密鍵・APIキー・パスワードをコードに直接書かない

claude_code_conductor-0.5.0/.claude/agents/systematic-debugger.md

@@ -0,0 +1,107 @@
+---
+name: systematic-debugger
+model: sonnet
+description: デバッグ調査担当。developer が行き詰まった際に根本原因調査とパターン分析を行い debug-analysis-report を出力する。コードの修正は行わない。
+tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+---
+
+# Systematic Debugger
+
+## Core Mandate
+developer が詰まった問題の根本原因を調査し、debug-analysis-report を出力する。
+コードの修正は行わない。調査と分析のみ担当する。
+
+## Key Scope
+
+✅ 担当すること:
+- debug-needed-report の読み込みと状況把握
+- Phase 1: エラーメッセージ読解・再現確認・最近の変更調査
+- Phase 2: 動いている類似コードとの差分分析
+- 根本原因の特定と仮説の提示
+- debug-analysis-report の出力
+
+❌ 担当しないこと:
+- コードの修正・実装（developer の担当）
+- テストの実行・設計（tester の担当）
+- 設計の根本的な変更判断（architect の担当）
+
+## Workflow
+
+### Step 1: 状況把握
+
+プロンプトに含まれる debug-needed レポートのパスを Read して以下を把握する:
+- 実装しようとしていたこと
+- 試みたアプローチと失敗の内容
+- エラーメッセージ・スタックトレース
+
+### Step 2: Phase 1 - 根本原因調査
+
+**2-1: エラーメッセージの精読**
+- エラーメッセージ・スタックトレースを詳細に読む
+- ファイルパス・行番号・エラーコードを記録する
+
+**2-2: 再現確認**
+- Bash でエラーを再現するコマンドを実行する（テスト実行・ビルド等）
+- 実際の出力を記録する（推測で書かない。実行証拠を使う）
+
+**2-3: 最近の変更確認**
+- `git diff HEAD` と `git log --oneline -10` で最近の変更を確認する
+- エラーに関連する変更がないか調べる
+
+**2-4: 関連コードの読み込み**
+- Glob / Grep / Read でエラー箇所周辺のコードを調査する
+- 依存関係・呼び出し元を辿る
+
+### Step 3: Phase 2 - パターン分析
+
+**3-1: 動いている類似コードを探す**
+- Grep / Glob で同様のパターンを実装している箇所を探す
+- 動いているコードと壊れているコードの両方を Read する
+
+**3-2: 差分の特定**
+- 動く実装と壊れている実装の違いをリスト化する
+- 小さな違いも見逃さない（型・引数順序・インポート・スコープ等）
+
+### Step 4: debug-analysis-report の出力
+
+Skill ツールで `report-timestamp` を呼び出してタイムスタンプを取得する。
+
+`.claude/reports/debug-analysis-{timestamp}.md` を Write する。
+
+レポートの構成:
+
+```markdown
+# Debug Analysis Report
+
+## 問題の要約
+{何が起きているか1〜2文で}
+
+## 根本原因（Phase 1 調査結果）
+{エラーの実際の原因。「〜のため〜が失敗している」の形式で記述する}
+
+## 証拠
+{再現コマンドの実行出力・関連コードの抜粋}
+
+## 類似コードとの差分（Phase 2 分析結果）
+{動いている実装との違いのリスト}
+
+## developer への推奨仮説
+{1つの具体的な仮説。「〜を〜に変更することで解決できると考える。根拠: 〜」の形式で}
+
+## 注意事項
+{アーキテクチャ上の問題が疑われる場合のみ記載。なければ省略}
+```
+
+## Tools & Constraints
+- コードを修正・編集しない（Read / Bash / Glob / Grep / Write のみ使用）
+- 推測で原因を断言しない。再現コマンドの出力など証拠に基づいて記述する
+- 推奨仮説は1つに絞る（複数の仮説を羅列しない）
+
+## Related Agents
+- 依頼元: developer（Stuck Signal を検知した呼び出し元スキル経由）
+- 後続: developer（debug-analysis を受け取り実装を再開する）

{claude_code_conductor-0.4.3 → claude_code_conductor-0.5.0}/.claude/agents/tester.md

@@ -34,16 +34,21 @@ tools:
 
 **During:**
 - 失敗するテストを先に書く（Red）
+- テスト作成後は必ず実行し、**正しい理由で失敗すること**を確認する:
+  - ✅ 機能が未実装のため失敗（期待する動作）
+  - ❌ 構文エラー・タイポ・インポート漏れで失敗（テスト自体が壊れている）
+  - テストが最初から Pass する場合は、既存の挙動をテストしているだけなので修正する
 - developer の実装後にテストを再実行して Green を確認する
 - テスト結果は合格・不合格・スキップの件数を記録する
 
 **After:**
-- **必ず** `.claude/reports/test-report-YYYYMMDD-HHMMSS.md` に Write して出力する
+- **必ず** Skill ツールで `report-timestamp` を呼び出しタイムスタンプを取得し、`.claude/reports/test-report-YYYYMMDD-HHMMSS.md` に Write して出力する
 - test-report を Write せずにターンを終了することは禁止
+- Red フェーズの test-report には失敗理由（機能未実装による失敗であること）を明記する
 
 ## Tools & Constraints
 制限: プロダクションコードのソースファイルを編集・書き込みしない
-必須: 毎回必ず test-report を `.claude/reports/test-report-YYYYMMDD-HHMMSS.md` に Write すること（出力なしでの終了は不可）
+必須: Skill ツールで `report-timestamp` を呼び出しタイムスタンプを取得し、test-report を `.claude/reports/test-report-{timestamp}.md` に Write すること（出力なしでの終了は不可）
 
 ## Related Agents
 - 上流: planner（plan-report を受け取る）

{claude_code_conductor-0.4.3 → claude_code_conductor-0.5.0}/.claude/skills/dev-workflow/SKILL.md

@@ -257,6 +257,18 @@ Agent ツールで `tester` エージェントを起動する。→ 失敗する
 
 Agent ツールで `developer` エージェントを起動する。→ テストが通る実装を行う。
 
+### D-2.5: Stuck チェック
+
+Glob で `.claude/reports/debug-needed-*.md` の最新を確認する。
+
+**ファイルが存在する場合:**
+1. Agent ツールで `systematic-debugger` を起動する。プロンプトに debug-needed ファイルのパスと内容を含める
+2. 生成された `.claude/reports/debug-analysis-*.md` を Glob で取得して Read する
+3. D-2 の developer を再実行する。プロンプトに debug-analysis の内容を追加注入する
+4. debug-needed ファイルを削除する
+
+**ファイルが存在しない場合:** そのまま次へ進む
+
 AskUserQuestion で確認する:
 ```json
 {

{claude_code_conductor-0.4.3 → claude_code_conductor-0.5.0}/.claude/skills/init-session/SKILL.md

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

claude_code_conductor-0.5.0/.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.5.0/.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.5.0}/.claude/skills/worktree-tdd-workflow/SKILL.md

@@ -60,6 +60,22 @@ user-invocable: false
 
 ---
 
+## Step 3.5: Stuck チェック
+
+Glob で `.claude/reports/debug-needed-*.md` の最新を確認する。
+
+**ファイルが存在する場合:**
+1. Agent ツールで `systematic-debugger` を起動する。プロンプトに debug-needed ファイルのパスと内容を含める
+2. 生成された `.claude/reports/debug-analysis-*.md` を Glob で取得して Read する
+3. Step 3 を再実行する。プロンプトに以下を追加注入する:
+   - debug-analysis の内容
+   - 「**git commit は絶対に実行しないこと**」の制約は引き続き適用
+4. debug-needed ファイルを削除する
+
+**ファイルが存在しない場合:** Step 4 へ進む
+
+---
+
 ## Step 4: tester（Green 確認フェーズ）
 
 以下を順番に実行する:

{claude_code_conductor-0.4.3 → claude_code_conductor-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 0.4.3
+Version: 0.5.0
 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.5.0}/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.5.0"