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

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.claude/CLAUDE.md

@@ -143,11 +143,28 @@ session ファイルの JSON ブロックにパターンを記録する:
 - **冗長なコード断片（Snippets）** — git 管理されているソースコード本体の重複コピー
 - **期限切れのタスク（Old Tasks）** — 既に完了し、今後の開発に影響を与えない古い作業記録
 
+### いつ /compact を使うか
+
+マイルストーン（フェーズ完了・wave 完了・大きなタスク区切り）に到達したら、以下の判断フローで `/compact` か **セッション再起動** を選ぶ。
+
+| 状況 | 推奨 |
+|---|---|
+| 同じタスクを継続中で、直前の判断・議論を圧縮しつつ残したい | `/compact`（KEEP/DISCARD ルールに従い圧縮） |
+| 別タスクに切り替える・長時間中断する・コンテキストを完全リセットしたい | セッションを終了し、次回 `/init-session` で再開 |
+| 残タスクが session ファイルに記録されており、Claude の記憶を保持する必要がない | セッション再起動が推奨（情報損失なし） |
+| Claude に直前の試行錯誤の経緯を覚えていてほしい | `/compact` |
+
+**注意:**
+- `/compact` 実行時は `pre_compact.py` フックが session ファイルにチェックポイントを自動記録する
+- セッション再起動時は `/init-session` が前回 session ファイルを読み込んで残タスクを復元する
+- どちらを選んでも session ファイルへの記録があれば情報は失われない
+
 ## Available Commands
 
 | コマンド | 目的 |
 |---|---|
 | `/init-session` | セッション初期化・前回状態の復元 |
+| `/pattern-status` | patterns.json の現状（信用度・昇格候補・期限残・既昇格）を可視化 |
 | `/promote-pattern` | 昇格候補パターンを rules/ または skills/ に昇格 |
 | `/setup` | コーディング規約の設定（標準規約 + 独自規約） |
 | `/start` | 開発ワークフローの入口（ヒアリング→設計→計画）|

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.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.1/.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.4 → claude_code_conductor-0.5.1}/.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.5.1/.claude/hooks/pre_compact.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""PreCompact hook: append checkpoint marker and inject save instruction."""
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
+
+_HOOKS_DIR = os.path.dirname(os.path.abspath(__file__))
+_CLAUDE_DIR = os.path.dirname(_HOOKS_DIR)
+SESSIONS_DIR = os.path.join(_CLAUDE_DIR, 'memory', 'sessions')
+
+from session_utils import append_checkpoint, is_worktree
+
+
+SAVE_INSTRUCTION = (
+    "コンテキスト圧縮が間もなく発生します。圧縮で詳細な文脈が失われる前に、"
+    "CLAUDE.md の Compact Instructions（KEEP/DISCARD ルール）に従って "
+    "今日のセッションファイル（.claude/memory/sessions/YYYYMMDD.tmp）に "
+    "現在の残タスク・直近の重要な判断・解決済みのハマりどころを書き出してください。"
+    "雑談・解決済みエラーログ・冗長なコード断片は書かず、KEEP に該当する情報のみ。"
+)
+
+
+def main():
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        payload = {}
+
+    cwd = os.getcwd()
+    if is_worktree(cwd):
+        sys.exit(0)
+
+    trigger = payload.get('trigger', 'unknown')
+    context_items_before = payload.get('context_items_before', 0)
+
+    now = datetime.now(timezone.utc)
+    date_str = now.strftime('%Y%m%d')
+    session_file = os.path.join(SESSIONS_DIR, f'{date_str}.tmp')
+
+    summary = (
+        f"- trigger: {trigger}\n"
+        f"- context_items_before: {context_items_before}\n"
+        f"- このポイント以前の詳細な文脈は圧縮により失われます。"
+    )
+    append_checkpoint(session_file, f'PreCompact: {trigger}', summary)
+
+    output = {
+        "hookSpecificOutput": {
+            "hookEventName": "PreCompact",
+            "additionalContext": SAVE_INSTRUCTION,
+        }
+    }
+    print(json.dumps(output, ensure_ascii=False))
+
+    print(f'[PreCompact] セッション状態を {session_file} に保存しました', file=sys.stderr)
+
+
+if __name__ == '__main__':
+    main()

claude_code_conductor-0.5.1/.claude/hooks/session_utils.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+"""Shared utilities for session management hooks (stop.py, pre_compact.py)."""
+
+import os
+from datetime import datetime, timezone
+
+_HOOKS_DIR = os.path.dirname(os.path.abspath(__file__))
+_CLAUDE_DIR = os.path.dirname(_HOOKS_DIR)
+SESSIONS_DIR = os.path.join(_CLAUDE_DIR, 'memory', 'sessions')
+
+SESSION_JSON_MARKER = 'C3:SESSION:JSON'
+
+
+def is_worktree(cwd: str) -> bool:
+    git_path = os.path.join(cwd, '.git')
+    return os.path.exists(git_path) and os.path.isfile(git_path)
+
+
+def create_session_template(date_str: str) -> str:
+    return (
+        f"SESSION: {date_str}\n"
+        f"AGENT: \n"
+        f"DURATION: \n"
+        f"\n"
+        f"## うまくいったアプローチ\n"
+        f"\n"
+        f"## 試みたが失敗したアプローチ\n"
+        f"\n"
+        f"## 残タスク\n"
+        f"\n"
+        f"## 事実ログ（自動生成 / stop.py）\n"
+        f"- 記録時刻: \n"
+        f"\n"
+        f"<!-- {SESSION_JSON_MARKER}\n"
+        f"{{\n"
+        f'  "session": "{date_str}",\n'
+        f'  "patterns": [],\n'
+        f'  "successes": [],\n'
+        f'  "failures": [],\n'
+        f'  "todos": []\n'
+        f"}}\n"
+        f"-->\n"
+    )
+
+
+def append_checkpoint(session_file: str, label: str, summary: str) -> None:
+    """Append a checkpoint block to the session file.
+
+    Used by wave-execution (milestone snapshots) and pre_compact.py
+    (compaction markers). Checkpoint blocks are append-only — they record
+    the state at a point in time and never overwrite earlier entries.
+
+    Args:
+        session_file: Absolute path to the session file (.tmp).
+        label: Short identifier shown in the heading
+            (e.g. "Wave 2 success", "PreCompact: manual").
+        summary: Multi-line Markdown body describing the state.
+    """
+    os.makedirs(os.path.dirname(session_file), exist_ok=True)
+
+    needs_template = (
+        not os.path.exists(session_file)
+        or os.path.getsize(session_file) == 0
+    )
+    if needs_template:
+        date_str = os.path.splitext(os.path.basename(session_file))[0]
+        with open(session_file, 'w', encoding='utf-8') as f:
+            f.write(create_session_template(date_str))
+
+    ts = datetime.now(timezone.utc).isoformat()
+    body = summary.strip()
+    block = (
+        f"\n"
+        f"## [Checkpoint: {label} - {ts}]\n"
+        f"{body}\n"
+    )
+
+    with open(session_file, 'a', encoding='utf-8') as f:
+        f.write(block)

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.claude/settings.json

@@ -39,7 +39,8 @@
       "Bash(git log*)",
       "Bash(git add*)",
       "Bash(git commit*)",
-      "Bash(git rev-parse*)"
+      "Bash(git rev-parse*)",
+      "WebSearch"
     ],
     "deny": [
       "Read(.env)",

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.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.5.1/.claude/skills/pattern-status/SKILL.md

@@ -0,0 +1,103 @@
+---
+description: patterns.json の現状（信用度・昇格候補・期限残・既昇格）を表形式で可視化する読み取り専用コマンド。/promote-pattern の前段としてパターンの状態確認に使う。
+disable-model-invocation: true
+---
+
+# pattern-status
+
+`patterns.json` の現状を可視化する。**読み取り専用** で patterns.json を変更しない。
+
+---
+
+## Step 1: patterns.json を読み込む
+
+`.claude/memory/patterns.json` を Read する。
+ファイルが存在しない、または `patterns` 配列が空の場合は以下を表示して終了する:
+
+```
+## パターン統計
+
+現在、登録されているパターンはありません。
+セッション内で発見したパターンは session ファイルの JSON ブロックに記録され、
+セッション終了時に stop.py が patterns.json へ統合します。
+```
+
+---
+
+## Step 2: パターンを分類する
+
+各パターンを以下の 4 区分に分類する:
+
+| 区分 | 条件 |
+|---|---|
+| 昇格済み | `promoted: true` |
+| 昇格候補 | `promotion_candidate: true` かつ `promoted: true` でない |
+| 蓄積中 | `promotion_candidate` が false または未設定で、`promoted` が true でない |
+| 期限切れ間近 | `registered_date` から 25 日以上経過（30 日で自動削除） |
+
+「期限切れ間近」は他区分と排他ではない（蓄積中かつ期限切れ間近 → 両方に表示してよい）。
+
+---
+
+## Step 3: サマリを表形式で表示する
+
+以下の形式で表示する。空のセクションは「（なし）」と書く。
+
+```
+## パターン統計 ({今日の日付})
+
+### 昇格候補（{N}件）
+| trust | id | description | 登録日 | 経過 |
+|---|---|---|---|---|
+| 0.85 | example_pattern | パターンの説明 | 2026-04-30 | 5日 |
+...
+
+→ `/promote-pattern` で昇格できます。
+
+### 蓄積中（{N}件）
+| trust | id | description | 登録日 | 観測 |
+|---|---|---|---|---|
+| 0.33 | another_pattern | パターンの説明 | 2026-05-02 | 1回 |
+...
+
+### 昇格済み（{N}件）
+| id | 昇格先 | 昇格日 | trust |
+|---|---|---|---|
+| promoted_pattern | rules/promoted/20260503-promoted_pattern.md | 2026-05-03 | 0.90 |
+...
+
+### 期限切れ間近（25日以上経過 / 30日で自動削除）（{N}件）
+| trust | id | 登録日 | 残り日数 |
+|---|---|---|---|
+| 0.20 | stale_pattern | 2026-04-10 | 5日 |
+...
+
+### 信用度別分布
+- 0.8 以上: {N}件（昇格候補入り）
+- 0.5 〜 0.8: {N}件
+- 0.3 〜 0.5: {N}件
+- 0.1 〜 0.3: {N}件
+
+合計: {N}件
+```
+
+---
+
+## Step 4: 次のアクションを案内する
+
+表示の最後に、状況に応じた一文を案内する:
+
+| 状況 | 案内 |
+|---|---|
+| 昇格候補が 1 件以上 | `/promote-pattern` で昇格できます。 |
+| 期限切れ間近が 1 件以上 | あと {N} 日で削除されるパターンがあります。観測されると信用度が上がり、昇格候補になります。 |
+| 蓄積中のみで昇格候補なし | 信用度 0.8 以上・登録から 3 日以上で昇格候補になります。 |
+| すべて空 | （Step 1 のメッセージで終了済み） |
+
+---
+
+## 注意事項
+
+- patterns.json を **絶対に変更しない**。読み取り専用のコマンドである
+- ファイルの修正・パターンの追加削除は `/promote-pattern` または `stop.py` の担当
+- 経過日数は `registered_date` (YYYYMMDD) と今日の日付から計算する

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.claude/skills/wave-execution/SKILL.md

@@ -263,6 +263,21 @@ case A で TDD ループが不合格のまま終わった、または case B で
 
 全タスク成功した wave のみ、セッションファイルの `- [ ] Wave {N} (M tasks)` を `- [x] Wave {N} (M tasks)` に Edit する。
 
+**さらに `session_utils.append_checkpoint()` を呼び出して checkpoint ブロックを追記する。** これにより wave 完了時の状態（成功 wave 数・残 wave 数・成果物の要約）が時系列で残り、後続の `/init-session` や `/pattern-status` で進捗が追跡できる。
+
+呼び出し例（Bash 経由）:
+```bash
+python -c "from session_utils import append_checkpoint, SESSIONS_DIR; import os; \
+  append_checkpoint(os.path.join(SESSIONS_DIR, '{YYYYMMDD}.tmp'), \
+    'Wave {N} success', \
+    '- 成功タスク: {M}件\n- 残 wave: {K}/{TOTAL}\n- 成果物: {要約}')" \
+  --hooks-dir .claude/hooks
+```
+
+または Python ヘルパーを直接呼び出してもよい。**checkpoint の summary には KEEP ルール（設計判断・決定事項・解決済みのハマりどころ）に該当する情報のみ書く**。雑談・進捗報告はセッションファイル本体（`## うまくいったアプローチ` 等）へ。
+
+**失敗 wave を「スキップして次の wave へ」した場合も同じ仕組みで記録する。** label は `Wave {N} skipped`、summary に失敗内容と判断理由を書く。
+
 **次の wave に進む前に main をコミットしてクリーンに保つ。** wave 成果物を未コミットのまま次の wave で PO に入ると、worktree が同名ファイルを再生成して必ず auto-merge 衝突が起きる（Step 0-pre と同じ理由）。親 Claude が wave の成果物を確認のうえ「Wave {N}: {要約}」のメッセージでコミットしてから 2-A の次のループに戻る。
 
 ---

{claude_code_conductor-0.4.4 → claude_code_conductor-0.5.1}/.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.4 → claude_code_conductor-0.5.1}/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## [0.5.1] - 2026-05-05
+
+### Added
+- New `/pattern-status` skill (read-only) that visualizes `patterns.json`:
+  trust score distribution, promotion candidates, expiry-near patterns,
+  and already-promoted patterns. Use it before `/promote-pattern` to
+  inspect the current state without modifying the file.
+- `session_utils.append_checkpoint(session_file, label, summary)` helper
+  for milestone state snapshots. Safely handles non-existent and empty
+  session files by writing the template before appending. Used by both
+  `wave-execution` (success/skipped-failure waves) and `pre_compact.py`.
+- `CLAUDE.md` "When to use /compact" guideline — decision flow for
+  `/compact` vs session restart, aimed at clarifying the choice for
+  power users (restart) vs casual users (`/compact`).
+
+### Changed
+- `pre_compact.py` now emits `hookSpecificOutput.additionalContext` to
+  inject KEEP/DISCARD save instructions into Claude's context just
+  before compaction. Previously the hook only wrote a timestamp marker
+  to the session file. Claude now writes important state (remaining
+  tasks, key decisions, resolved gotchas) to the session before the
+  context shrinks.
+- `wave-execution` Step 2-F now records a checkpoint block to the
+  session file on every wave completion (success or skipped failure),
+  in addition to flipping `[ ]` → `[x]`. This gives a time-stamped
+  trail of milestones for `/init-session` and `/pattern-status`.
+- Added `WebSearch` to `permissions.allow` in `settings.json` so
+  research subagents can use it without prompting.
+
+## [0.5.0] - 2026-05-05
+
+### Added
+- New `systematic-debugger` agent: dedicated investigation phase for
+  root-cause analysis and pattern matching when `developer` gets stuck.
+  Runs in a separate phase from implementation, preserving C3's
+  multi-agent separation.
+- `developer` agent: Stuck Signal — after 3 failed attempts at the
+  same problem, write a `debug-needed` report and stop, letting the
+  orchestrator dispatch `systematic-debugger`.
+- `dev-workflow` D-2.5 and `worktree-tdd-workflow` Step 3.5: detect
+  Stuck Signal, run systematic-debugger, re-invoke developer with the
+  debug analysis injected.
+- `tester` agent: Verify RED rule — before handing off to developer,
+  confirm tests fail for the right reason (missing feature, not
+  syntax errors), and document the verification in the test-report.
+- `developer` agent: minimal code principle — Green phase writes
+  only what tests require, no premature extensions or speculative
+  abstractions.
+- `developer` agent: lightweight verification before tester handoff
+  (syntax/build check) drawn from superpowers' verification ideas
+  while keeping C3's agent-separated structure.
+
 ## [0.4.0] - 2026-05-04
 
 ### Breaking Changes

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

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

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

claude_code_conductor-0.4.4/.claude/hooks/pre_compact.py

@@ -1,59 +0,0 @@
-#!/usr/bin/env python3
-"""PreCompact hook: append checkpoint marker to today's session file."""
-
-import json
-import os
-import sys
-from datetime import datetime, timezone
-
-sys.stdout.reconfigure(encoding='utf-8')
-sys.stderr.reconfigure(encoding='utf-8')
-
-_HOOKS_DIR = os.path.dirname(os.path.abspath(__file__))
-_CLAUDE_DIR = os.path.dirname(_HOOKS_DIR)
-SESSIONS_DIR = os.path.join(_CLAUDE_DIR, 'memory', 'sessions')
-
-from session_utils import is_worktree, create_session_template
-
-
-def main():
-    try:
-        payload = json.loads(sys.stdin.read())
-    except (json.JSONDecodeError, ValueError):
-        payload = {}
-
-    cwd = os.getcwd()
-    if is_worktree(cwd):
-        sys.exit(0)
-
-    trigger = payload.get('trigger', 'unknown')
-    context_items_before = payload.get('context_items_before', 0)
-
-    os.makedirs(SESSIONS_DIR, exist_ok=True)
-
-    now = datetime.now(timezone.utc)
-    date_str = now.strftime('%Y%m%d')
-    session_file = os.path.join(SESSIONS_DIR, f'{date_str}.tmp')
-
-    try:
-        with open(session_file, 'x', encoding='utf-8') as f:
-            f.write(create_session_template(date_str))
-    except FileExistsError:
-        pass  # already created by stop.py or another process
-
-    ts = now.isoformat()
-    checkpoint = (
-        f'\n'
-        f'## [PreCompact checkpoint: {trigger} - {ts}]\n'
-        f'コンテキスト圧縮 ({trigger}) が発生しました。圧縮前: {context_items_before} アイテム。\n'
-        f'このポイント以前の詳細な文脈は失われています。\n'
-    )
-
-    with open(session_file, 'a', encoding='utf-8') as f:
-        f.write(checkpoint)
-
-    print(f'[PreCompact] セッション状態を {session_file} に保存しました', file=sys.stderr)
-
-
-if __name__ == '__main__':
-    main()

claude_code_conductor-0.4.4/.claude/hooks/session_utils.py

@@ -1,42 +0,0 @@
-#!/usr/bin/env python3
-"""Shared utilities for session management hooks (stop.py, pre_compact.py)."""
-
-import os
-
-_HOOKS_DIR = os.path.dirname(os.path.abspath(__file__))
-_CLAUDE_DIR = os.path.dirname(_HOOKS_DIR)
-SESSIONS_DIR = os.path.join(_CLAUDE_DIR, 'memory', 'sessions')
-
-SESSION_JSON_MARKER = 'C3:SESSION:JSON'
-
-
-def is_worktree(cwd: str) -> bool:
-    git_path = os.path.join(cwd, '.git')
-    return os.path.exists(git_path) and os.path.isfile(git_path)
-
-
-def create_session_template(date_str: str) -> str:
-    return (
-        f"SESSION: {date_str}\n"
-        f"AGENT: \n"
-        f"DURATION: \n"
-        f"\n"
-        f"## うまくいったアプローチ\n"
-        f"\n"
-        f"## 試みたが失敗したアプローチ\n"
-        f"\n"
-        f"## 残タスク\n"
-        f"\n"
-        f"## 事実ログ（自動生成 / stop.py）\n"
-        f"- 記録時刻: \n"
-        f"\n"
-        f"<!-- {SESSION_JSON_MARKER}\n"
-        f"{{\n"
-        f'  "session": "{date_str}",\n'
-        f'  "patterns": [],\n'
-        f'  "successes": [],\n'
-        f'  "failures": [],\n'
-        f'  "todos": []\n'
-        f"}}\n"
-        f"-->\n"
-    )