claude-code-conductor 2.8.0__tar.gz → 2.9.0__tar.gz

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/permission_handler.py

@@ -369,6 +369,11 @@ def main() -> None:
     rules = load_rules()
     description = describe_tool(tool_name, tool_input)
 
+    # AskUserQuestion は通知のみ。自動承認対象外として扱う。
+    if tool_name == 'AskUserQuestion':
+        notify(f'-> 質問: {description}')
+        return
+
     for pattern in rules.get('auto_allow', []):
         if matches_pattern(tool_name, tool_input, pattern):
             if rules.get('notify_on_auto', True):

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/record_tier_outcome.py

@@ -87,6 +87,40 @@ def _delete_tier_selection() -> None:
         )
 
 
+# prompt-history.jsonl の上限サイズ（バイト）。超過時は末尾 _PROMPT_HISTORY_TRUNCATE_LINES 行
+# だけを残してローテーションする。読み込み側 (select_tier._PROMPT_HISTORY_SCAN_LINES=1000) と
+# 同じオーダーで保持し、ディスク消費を抑える [SR-V-001]。
+_PROMPT_HISTORY_MAX_BYTES = 10 * 1024 * 1024  # 10 MB
+_PROMPT_HISTORY_TRUNCATE_LINES = 2000
+
+
+def _rotate_prompt_history_if_needed() -> None:
+    """prompt-history.jsonl が上限超過なら末尾 N 行を残して切り詰める。
+
+    書き込み側のサイズ無制限成長を防ぐシンプルなローテーション。失敗時は警告のみ。
+    """
+    try:
+        size = os.path.getsize(PROMPT_HISTORY_PATH)
+    except OSError:
+        return
+    if size <= _PROMPT_HISTORY_MAX_BYTES:
+        return
+    try:
+        # 末尾 N 行のみ deque で保持して上書きする（ファイル全体は走査するが I/O のみ）
+        import collections as _c
+        with open(PROMPT_HISTORY_PATH, "r", encoding="utf-8") as f:
+            tail = list(_c.deque(f, maxlen=_PROMPT_HISTORY_TRUNCATE_LINES))
+        tmp_path = PROMPT_HISTORY_PATH + ".tmp"
+        with open(tmp_path, "w", encoding="utf-8") as f:
+            f.writelines(tail)
+        os.replace(tmp_path, PROMPT_HISTORY_PATH)
+    except OSError as exc:
+        print(
+            f"[record_tier_outcome] prompt-history rotate skipped: {exc}",
+            file=sys.stderr,
+        )
+
+
 def _append_prompt_history(selection: dict, success: bool) -> None:
     """Phase 2-C: prompt-history.jsonl に 1 行追記する。
 
@@ -108,6 +142,7 @@ def _append_prompt_history(selection: dict, success: bool) -> None:
     }
     try:
         os.makedirs(os.path.dirname(PROMPT_HISTORY_PATH), exist_ok=True)
+        _rotate_prompt_history_if_needed()
         with open(PROMPT_HISTORY_PATH, "a", encoding="utf-8") as f:
             f.write(json.dumps(record, ensure_ascii=False) + "\n")
     except OSError as exc:

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/restore_session.py

@@ -41,6 +41,15 @@ def find_latest_session() -> str | None:
     return os.path.join(SESSIONS_DIR, max(files))
 
 
+def extract_section(content: str, heading: str) -> str:
+    """``session_utils.extract_section`` への薄いラッパー（後方互換用）。
+
+    過去にこのモジュール直下にあった ``extract_section`` を呼び出すテスト・スクリプトとの
+    互換維持のため、モジュールレベルで公開する。実体は :mod:`session_utils` 側にある。
+    """
+    return _load_session_utils().extract_section(content, heading)
+
+
 def main():
     path = find_latest_session()
     if not path or not os.path.exists(path):

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/select_tier.py

@@ -94,11 +94,15 @@ def _mask_secrets(text: str) -> str:
 
     キー名やプレフィックスは残し、値のみを置換することで
     「何が含まれていたか」は伝わらないようにする。
-    PEM ブロックは開始タグ〜終了タグ全体を ***  に置換する。
+    PEM ブロックは開始タグ + *** + 終了タグ に置換する。
     """
     result = text
     for pattern in _MASK_PATTERNS:
-        result = pattern.sub(lambda m: m.group(1) + "***", result)
+        # group(2) があれば PEM ブロック (BEGIN...END)、なければプレフィックス系
+        result = pattern.sub(
+            lambda m: m.group(1) + "***" + (m.group(2) if m.lastindex and m.lastindex >= 2 else ""),
+            result,
+        )
     return result
 
 # prompt-history.jsonl の末尾から読む最大行数（パフォーマンス対策）
@@ -325,11 +329,11 @@ def write_tier_selection(
     record_tier_outcome.py がこの json を読んで α/β を更新する。
     既存ファイルは上書きされる（最新 1 件のみ保持）。
 
-    tier-routing Phase 2-A: ``suggested_model`` も併せて書く。runner.py がこれを読んで
-    PO 経由のサブエージェント起動時に ``claude --agents`` で動的に上書きする。
-    tier 名と model の短縮名は同一とする。
+    ``suggested_model`` を併せて書く。tier 名と model の短縮名は同一とする。
+    （PO 廃止前は runner.py が読んで ``claude --agents`` 用に使っていたが、v2.0.0 以降は
+    記録目的のみ。将来再利用する余地のために維持する。）
 
-    tier-routing Phase 2-B: ``escalated`` / ``escalation_reason`` を任意で含める。
+    ``escalated`` / ``escalation_reason`` を任意で含める。
     failure rate に基づく昇格が起きた場合のみ True / 文字列が入る。
     """
     os.makedirs(os.path.dirname(TIER_SELECTION_PATH), exist_ok=True)
@@ -337,7 +341,7 @@ def write_tier_selection(
         "complexity": complexity,
         "tier": tier,
         "mode": mode,
-        # Phase 2-A: tier はそのまま claude --agents の model 短縮名として使える
+        # tier はそのまま claude --agents の model 短縮名として使える
         "suggested_model": tier,
     }
     if escalated:
@@ -383,10 +387,8 @@ def build_additional_context(
 
     return (
         f"[tier-routing 推奨] 複雑度: {complexity} / 推奨 Tier: {tier}（{confidence}）。"
-        f"PO 経由のサブエージェント起動時はこの推奨が claude --agents JSON で"
-        f" 自動適用されます（Phase 2-A）。親 Claude の Agent ツール経由は依然"
-        f" frontmatter 指定が優先されるため、コスト最適化したい場合は手動切替"
-        f" してください。{suffix}"
+        f" 親 Claude の Agent ツール経由ではエージェント定義の frontmatter 指定が"
+        f" 優先されるため、コスト最適化したい場合は手動切替してください。{suffix}"
     )
 
 

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/session_utils.py

@@ -20,7 +20,6 @@ def is_worktree(cwd: str) -> bool:
 def create_session_template(date_str: str) -> str:
     return (
         f"SESSION: {date_str}\n"
-        f"TASK_TYPE: \n"
         f"AGENT: \n"
         f"DURATION: \n"
         f"\n"

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/statusline.py

@@ -1,6 +1,10 @@
 #!/usr/bin/env python3
-"""Context gauge statusline script.
-Displays context usage + optional rate limit gauges (when plan provides rate_limits data).
+"""Statusline script for Claude Code.
+
+Displays: [model display name] effort | ctx used X% | 5h lim X% | 7d lim X%
+
+context_window_size (200K / 1M) は ctx used X% と情報重複のため表示しない。
+gauge バー描画も省スペース優先で表示しない。
 """
 
 import json
@@ -35,14 +39,6 @@ def pct_color(pct: int) -> str:
         return GREEN
 
 
-def format_context_size(size: int) -> str:
-    if size >= 900_000:
-        return '1M'
-    elif size >= 100_000:
-        return '200K'
-    return str(size)
-
-
 def format_reset_time(resets_at) -> str:
     if not resets_at:
         return ''
@@ -82,18 +78,13 @@ def render_output(raw: str) -> None:
     header: list[str] = []
     metrics: list[str] = []
 
-    # [model display name]  context_size  effort  — スペース区切り
+    # [model display name]  effort  — スペース区切り
+    # （context_window_size は ctx used X% と情報重複のため表示しない）
     model = data.get('model') or {}
     display_name = model.get('display_name', '')
     if display_name:
         header.append(f'[{display_name}]')
 
-    # context window size: 200K / 1M
-    ctx_window = data.get('context_window') or {}
-    ctx_size = ctx_window.get('context_window_size')
-    if ctx_size:
-        header.append(format_context_size(int(ctx_size)))
-
     # effort level
     effort = data.get('effort') or {}
     effort_level = effort.get('level', '')
@@ -101,6 +92,7 @@ def render_output(raw: str) -> None:
         header.append(effort_level)
 
     # ctx usg %
+    ctx_window = data.get('context_window') or {}
     ctx_pct = round(ctx_window.get('used_percentage') or 0)
     metrics.append('ctx used ' + pct_color(ctx_pct) + str(ctx_pct) + '%' + RESET)
 

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/stop.py

@@ -251,6 +251,10 @@ def update_patterns(date_str: str) -> None:
             continue
 
         registered = _parse_session_date(pattern['registered_date'])
+        if registered is None:
+            # registered_date が parse 不能ならパターンを保持して継続（クラッシュ回避）
+            active.append(pattern)
+            continue
         days_elapsed = (today - registered).days
 
         if days_elapsed >= EXPIRY_DAYS:

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/subagent_log.py

@@ -78,8 +78,8 @@ _SAFE_PAYLOAD_FIELDS = frozenset({
 # U+2028 (LINE SEPARATOR) / U+2029 (PARAGRAPH SEPARATOR) の定数 (sec-H-1)
 # ensure_ascii=False の json.dumps はこれらをエスケープしないため、
 # _append_log で明示的に \\u2028 / \\u2029 へ置換する。
-_U2028 = '
'
-_U2029 = '
'
+_U2028 = '
'  # LINE SEPARATOR
+_U2029 = '
'  # PARAGRAPH SEPARATOR
 
 
 def _now_iso() -> str:

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/hooks/worktree_guard.py

@@ -5,6 +5,10 @@ PO_WORKTREE_GUARD=1 が設定されている場合のみ動作する。
 worktree 内で実装タスクを実行するワークフロー（parallel-agents skill が
 isolation:"worktree" 付きで起動する agent など）が事前にこの env を設定して有効化する。
 Write / Edit ツールの対象パスが CWD（worktree ルート）外であればブロックする。
+
+NOTE [SR-V-002]: env 未設定時にガードが無効化されるリスクは parallel-agents/SKILL.md
+で `PO_WORKTREE_GUARD=1` 設定を必須化することで運用上対処する。CWD parts チェック
+単独で自動有効化する設計変更は次回 major bump で検討予定。
 """
 
 import json

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/settings.json

@@ -63,7 +63,7 @@
   },
   "statusLine": {
     "type": "command",
-    "command": "python \"$CLAUDE_PROJECT_DIR/.claude/hooks/statusline.py\""
+    "command": "python \"${CLAUDE_PROJECT_DIR}/.claude/hooks/statusline.py\""
   },
   "hooks": {
     "PreToolUse": [

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/skills/dev-workflow/SKILL.md

@@ -16,27 +16,6 @@ user-invocable: false
 
 `.claude/agents/interviewer.md` を Read してペルソナを採用する。
 
-### TASK_TYPE の確認
-
-今日のセッションファイル（`.claude/memory/sessions/YYYYMMDD.tmp`）の冒頭から
-`^TASK_TYPE: (\S+)$` を抽出してコンテキストに保持する。
-
-抽出した値が `feature / bug-fix / refactor / security-audit / docs` のいずれでもない場合
-（空欄、enum 外の文字列など）は「TASK_TYPE 未確定」とみなして以下のフォールバックを実施する。
-
-`TASK_TYPE` が空欄や行が無い、または enum 外の場合（`/develop` 直接呼び出しなど Step 0.5 を経由しないケース）:
-- Skill ツールで `task-routing` を呼ぶ。`args` に `from_start=true` を渡すことで
-  「種別確認のみモード」で動作させ、Step 2〜4 をスキップさせる（`/start` Step 0.5 と同じ呼び方）:
-  ```
-  Skill(skill="task-routing", args="from_start=true")
-  ```
-- 戻ってきた種別を当日 tmp 冒頭の `TASK_TYPE:` 行に Edit で書き込む（dev-workflow 側で書き込む）
-- これにより task-routing が再帰的に `/start` を Read して再び `task-routing` を呼ぶ事態を回避する
-
-`TASK_TYPE` が `feature` 以外（bug-fix / refactor / security-audit / docs）の場合は、
-本来 dev-workflow フェーズ A〜E のフルパスを通す必要がない種別であることを通知し、
-ユーザーに本当に dev-workflow を実行するか確認する（誤起動の防止）。
-
 今日のセッションファイルに以下を追記する（未登録の場合のみ）:
 - `- [ ] ヒアリング` / `- [ ] 設計` / `- [ ] 計画`
 
@@ -98,15 +77,6 @@ AskUserQuestion ツール:
 ### A-4: requirements-report の生成と承認
 
 収集した内容をもとに `.claude/reports/requirements-report-YYYYMMDD-HHMMSS.md` に Write する。
-ファイル冒頭のフロントマターに `task_type: {task_type}` を含めること（後段の architect / planner が参照する）:
-
-```yaml
----
-task_type: {task_type}   # /start Step 0.5 で確定した種別（feature / bug-fix / refactor / security-audit / docs のいずれか）を埋める
----
-```
-
-`{task_type}` は plain string で、前述の TASK_TYPE 確認フェーズで保持した値と同じものを書く。
 
 内容を提示した後、AskUserQuestion で確認する:
 
@@ -137,8 +107,6 @@ task_type: {task_type}   # /start Step 0.5 で確定した種別（feature / bug
 
 **フェーズ A から続いている場合:** 要件はコンテキスト内にあるため読み直し不要。
 **直接開始の場合:** Glob で `.claude/reports/requirements-report-*.md` の最新を Read する。
-requirements-report のフロントマターに `task_type:` があれば読み取ってコンテキストに保持する
-（後段で agent 起動方針の判定に使う）。
 
 今日のセッションファイルに以下を追記する（未登録の場合のみ）:
 - `- [ ] 設計` / `- [ ] 計画`
@@ -257,18 +225,30 @@ plan-report の全タスクを走査し、以下の形式でテキスト出力
 ## フェーズ D: 実装
 
 **フェーズ C から続いている場合:** plan-report はコンテキスト内にあるため読み直し不要。
-**直接開始の場合:** Glob で `.claude/reports/plan-report-*.md` の最新を Read する。存在しない場合はフェーズ C から始めるよう案内して終了する。
+**直接開始の場合:** D-0 で実行モードを判定する。
 
 ### D-0: 実行モード自動判別
 
-plan-report の冒頭を Read し、YAML フロントマター（`---` で始まり `po_plan_version: "0.1"` を含む）の有無を確認する。
+以下の順で実行モードを判定する:
+
+1. Glob で `.claude/reports/plan-report-*.md` の最新が存在する場合、冒頭の YAML フロントマター
+   （`---` で始まり `po_plan_version: "0.1"` を含む）の有無を確認する。
+2. plan-report が存在せず、**当日タイムスタンプ**の `.claude/reports/debug-analysis-*.md` が存在する場合は **bug-fix モード** とする。
+   当日判定は LLM のテキスト解釈ではなく以下の Bash で機械的に取得すること（前セッションの残骸 debug-analysis による意図しない bug-fix モード突入を防ぐ）:
+
+   ```bash
+   python -c "import os, glob, datetime; today = datetime.datetime.now().strftime('%Y%m%d'); files = sorted(glob.glob('.claude/reports/debug-analysis-*.md')); today_files = [f for f in files if os.path.basename(f).startswith(f'debug-analysis-{today}-')]; print(today_files[-1] if today_files else '')"
+   ```
 
-**フロントマターありの場合:**
+   標準出力が空でなければそのパスを bug-fix モードの入力として保持する。空なら debug-analysis を「無し」とみなし判定 3 へ進む。
+3. plan-report も当日 debug-analysis も存在しない場合はフェーズ C から始めるよう案内して終了する。
+
+**フロントマターありの場合（parallel-agents モード）:**
 1. **最初に必ず** `.claude/skills/parallel-agents/SKILL.md` を Read する（記憶・推測で進めない）
 2. `.claude/skills/parallel-agents/SKILL.md` の手順に完全に従って wave 単位で実装を進める
 3. 全 wave 完了後はフェーズ E（レビュー）へ進む（wave に reviewer タスクが含まれていれば E をスキップ可能と案内する）
 
-**フロントマターなしの場合（legacy フォールバック）:**
+**フロントマターなしの場合（legacy TDD モード）:**
 
 今日のセッションファイルに以下を追記する（未登録の場合のみ）:
 - `- [ ] tester: Red フェーズ`
@@ -278,6 +258,51 @@ plan-report の冒頭を Read し、YAML フロントマター（`---` で始ま
 
 D-1 へ進む。
 
+**bug-fix モードの場合:**
+
+Glob で当日の `.claude/reports/debug-analysis-*.md` の最新を取得し、ファイルパスのみコンテキストに保持する（内容は後段の agent 側で Read させる。プロンプトに直接展開しない[SR-AI-001] 対策）。
+
+今日のセッションファイルに以下を追記する（未登録の場合のみ）:
+- `- [ ] developer: 修正実装`
+- `- [ ] tester: 動作確認`
+
+bug-fix モードでは D-1（Red tester）と D-4（Refactor）をスキップする。
+以下の順で実行する: **D-2（bug-fix モード）→ D-2.5（Stuck チェック・bug-fix モード）→ D-3（bug-fix モード）→ フェーズ E**。
+
+**D-2（bug-fix モード）**: Agent ツールで `developer` を起動する。プロンプトには debug-analysis の**ファイルパスのみ**を含め、内容は agent 側で Read させる（プロンプトに展開しない）。
+完了後、セッションファイルの `- [ ] developer: 修正実装` を `- [x]` に Edit する。
+
+**D-2.5（bug-fix モード）**: 通常の D-2.5 と同じ Stuck チェック手順（debug-needed-*.md 検出時の systematic-debugger 起動・developer 再実行）を実行する。
+ただし末尾の AskUserQuestion 承認後の Edit 対象は `- [ ] developer: 修正実装` ではなく既に D-2 で `[x]` 化済みのため**スキップする**（bug-fix モードの修正実装承認は D-3 の動作確認で代替する）。
+通常モードの「`- [ ] developer: Green フェーズ` を `[x]` に Edit する」は bug-fix モードでは適用しない。
+
+**D-3（bug-fix モード）**: Agent ツールで `tester` を起動して全テストの Green を確認する。
+AskUserQuestion で確認する:
+
+```json
+{
+  "questions": [{
+    "question": "bug-fix の動作確認結果を確認してください。どうしますか？",
+    "options": [
+      { "label": "全合格・レビューへ進む", "description": "フェーズ E（レビュー）へ進む" },
+      { "label": "不合格あり・再修正を依頼する", "description": "D-2（developer）に戻って再修正する" },
+      { "label": "不合格あり・自分で修正する", "description": "自分で修正してから tester を再実行する" }
+    ]
+  }]
+}
+```
+
+「全合格」承認後 → セッションファイルの `- [ ] tester: 動作確認` を `- [x]` に Edit して**フェーズ E** へ。
+「不合格あり」を選んだ場合 → D-2 に戻る。合格するまで繰り返す。
+
+bug-fix モード固有の動作:
+- D-1（Red フェーズ）をスキップする理由: 既存の不具合自体が「足りないテスト」を示しており、developer が修正と一緒に回帰テストを追加する運用とする
+- D-4（Refactor フェーズ）をスキップする理由: 不具合修正のスコープを最小に保つため。リファクタが必要な場合は後段のレビュー指摘で改めて計画化する
+
+フェーズ E（レビュー）で指摘があり「全て対応する」「対応する指摘を選ぶ」を選んだ場合は、
+通常通りフェーズ C（計画）へ戻る。次回からは plan-report が生成されるため、
+legacy TDD モードまたは parallel-agents モードで実装される。
+
 ### D-1: tester（Red フェーズ）
 
 Agent ツールで `tester` エージェントを起動する。→ 失敗するテストを先に作成する。**必ず `.claude/reports/test-report-YYYYMMDD-HHMMSS.md` を Write してから終了すること。**
@@ -293,9 +318,9 @@ Agent ツールで `developer` エージェントを起動する。→ テスト
 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 の内容を追加注入する
+1. Agent ツールで `systematic-debugger` を起動する。プロンプトに debug-needed ファイルのパスのみを含め、内容は agent 側で Read させる（プロンプトに直接展開しない）[SR-AI-001]
+2. 生成された `.claude/reports/debug-analysis-*.md` を Glob で取得してパスのみコンテキストに保持する（内容は次段で agent に Read させる）
+3. D-2 の developer を再実行する。プロンプトに debug-analysis の**ファイルパスのみ**を含め、内容は agent 側で Read させる（プロンプトに展開しない）[SR-AI-001]
 4. debug-needed ファイルを削除する
 
 **ファイルが存在しない場合:** そのまま次へ進む
@@ -314,7 +339,7 @@ AskUserQuestion で確認する:
 }
 ```
 
-承認後 → セッションファイルの `- [ ] developer: Green フェーズ` を `- [x]` に Edit する。
+承認後 → セッションファイルの `- [ ] developer: Green フェーズ` を `- [x]` に Edit する（**bug-fix モードではこの Edit をスキップする**。D-2 で `- [ ] developer: 修正実装` を既に `[x]` 化済みのため、Green フェーズ行自体がセッションファイルに存在しない）。
 
 **知識蓄積:**
 - 「否認・再実装を依頼する」: `## 試みたが失敗したアプローチ` に教訓をルール形式で追記し `patterns` に追加する

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/skills/init-session/SKILL.md

@@ -18,8 +18,6 @@ description: セッション開始時に前回の作業状態・残タスク・
 Glob で `.claude/memory/sessions/*.tmp` を検索し、ファイル名（YYYYMMDD）が最大のものを Read する。
 ファイルが存在しない場合は「前回セッションなし」として Step 3 へ進む。
 
-冒頭から `^TASK_TYPE: (\S+)$` を抽出して `prev_task_type` として記録する（存在すれば Step 3 のサマリに含める）。
-
 ---
 
 ## Step 1.5: 残タスクと git log を照合する（陳腐化チェック）
@@ -55,7 +53,6 @@ Glob で `.claude/memory/sessions/*.tmp` を検索し、ファイル名（YYYYMM
 ## セッション再開 ({今日の日付})
 
 ### 前回セッション ({前回の日付})
-**前回のタスク種別:** {prev_task_type があれば表示、なければ省略}
 
 **残タスク:**
 {残タスクリスト。完了済み [x] は省略する}
@@ -118,7 +115,7 @@ AskUserQuestion ツールで以下を提示する:
 
 **「ワークフローで始める」の場合:**
 Skill ツールで `start` スキルを呼び出す。
-（`/start` 内の Step 0.5 で task-routing が自動実行されるため、ここで個別呼び出しは不要）
+（`/start` の Step 1 で開始地点を選んで対応する dev-workflow フェーズへ遷移する）
 
 **「直接指示する」の場合:**
 ```

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.claude/skills/parallel-agents/SKILL.md

@@ -153,6 +153,11 @@ AskUserQuestion ツール:
 - `run_in_background`: `true`
 - `description`: タスク id（5 単語以内）
 - `prompt`: 以下を含める（ペルソナ採用は不要、frontmatter / system prompt で自動適用される）:
+  - **先頭に `PO_WORKTREE_GUARD=1` を export する Bash 1 行を必須で含める** [SR-V-002]:
+    ```
+    Bash でまず以下を実行: `export PO_WORKTREE_GUARD=1`（worktree_guard.py PreToolUse が worktree 外書き込みをブロックする条件）
+    ```
+    worktree_guard.py はこの env 未設定時 `sys.exit(0)` で完全無効化されるため、wt_* agent 起動プロンプトの先頭で必ず設定すること。
   - タスクの `prompt` 本文
   - 「**禁止事項: git add / git commit / git push を実行しないこと**。コミットは親 Claude がユーザー承認後に行う」
   - 「**返り値フォーマット厳守**:

claude_code_conductor-2.9.0/.claude/skills/start/SKILL.md

@@ -0,0 +1,136 @@
+---
+description: 開発ワークフローの入口。開始地点（標準ワークフローの各フェーズ / 実装 / デバッグ調査 / レビュー）を選び、対応する dev-workflow フェーズに遷移する。
+---
+
+# start
+
+開発ワークフローの入口。フロー順序: **Step 0（レポート整理）→ Step 1（開始地点選択）→ Step 2（フェーズ遷移）**。
+
+ワークフローは 2 つだけ:
+
+- **標準ワークフロー**: ヒアリング → 設計 → 計画 → 実装(TDD) → レビュー → 指摘ありで計画へ戻る、なしで終了
+- **デバッグワークフロー**: systematic-debugger → 実装(developer + tester Green) → レビュー → 指摘ありで標準ワークフローの計画へ、なしで終了
+
+その他の単発タスク（ドキュメント作成など）は対応する個別コマンド（例: `/doc`）を直接使う。
+
+---
+
+## Step 0: レポートの整理
+
+Glob で `.claude/reports/*.md` を検索する（`archive/` 配下は含まない）。
+レポートが存在しない場合はこの Step をスキップして Step 1 へ進む。
+
+レポートが存在する場合はファイル名の一覧をテキストで提示してから AskUserQuestion で確認する:
+
+```json
+{
+  "questions": [{
+    "question": "既存のレポートがあります。どうしますか？",
+    "options": [
+      { "label": "全てアーカイブして新しく始める", "description": "全レポートを reports/archive/ に移動する" },
+      { "label": "アーカイブするフェーズを選ぶ", "description": "フェーズ単位で選んで一部だけ移動する" },
+      { "label": "そのまま引き継ぐ", "description": "レポートを変更せずに続ける" }
+    ]
+  }]
+}
+```
+
+**「全てアーカイブして新しく始める」の場合:**
+Bash ツールで実行する:
+```bash
+mkdir -p .claude/reports/archive && mv .claude/reports/*.md .claude/reports/archive/
+```
+
+**「アーカイブするフェーズを選ぶ」の場合:**
+AskUserQuestion で対象フェーズを確認する:
+
+```json
+{
+  "questions": [{
+    "question": "アーカイブするフェーズを選んでください（複数選択可）",
+    "options": [
+      { "label": "要件定義", "description": "requirements-report-*.md" },
+      { "label": "設計", "description": "architecture-report-*.md" },
+      { "label": "計画", "description": "plan-report-*.md" },
+      { "label": "レビュー", "description": "code-review-report-*.md / security-review-report-*.md" }
+    ],
+    "multiSelect": true
+  }]
+}
+```
+
+選択されたフェーズに対応するファイルを Bash ツールで移動する（ファイルが存在しない場合はスキップ）:
+- 要件定義: `mkdir -p .claude/reports/archive && mv .claude/reports/requirements-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- 設計: `mkdir -p .claude/reports/archive && mv .claude/reports/architecture-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- 計画: `mkdir -p .claude/reports/archive && mv .claude/reports/plan-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- レビュー: `mkdir -p .claude/reports/archive && mv .claude/reports/code-review-report-*.md .claude/reports/archive/ 2>/dev/null || true && mv .claude/reports/security-review-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+
+---
+
+## Step 1: 開始地点の選択
+
+AskUserQuestion ツールで 4 択を提示する:
+
+```json
+{
+  "questions": [{
+    "question": "どこから始めますか？",
+    "header": "開始地点",
+    "options": [
+      { "label": "標準ワークフロー", "description": "ヒアリング/設計/計画のどれかから始める（新機能・リファクタ・改善など）" },
+      { "label": "実装から", "description": "既存 plan-report を使って実装フェーズへ" },
+      { "label": "デバッグ調査から", "description": "不具合の原因調査から始める" },
+      { "label": "レビューから", "description": "既存コードをレビューする（指摘があれば修正サイクルへ）" }
+    ]
+  }]
+}
+```
+
+「標準ワークフロー」を選んだ場合は続けて Step 1.5 のサブ選択を行う。
+それ以外を選んだ場合は Step 1.5 をスキップして Step 2 へ進む。
+
+---
+
+## Step 1.5: 標準ワークフローのサブ選択
+
+Step 1 で「標準ワークフロー」を選んだ場合のみ実行する。
+AskUserQuestion で 3 択を提示する:
+
+```json
+{
+  "questions": [{
+    "question": "標準ワークフローのどこから始めますか？",
+    "header": "標準サブ選択",
+    "options": [
+      { "label": "ヒアリング", "description": "要件を整理するところから始める（新規・大きな変更）" },
+      { "label": "設計", "description": "要件は明確なので設計から始める" },
+      { "label": "計画", "description": "設計済みなのでタスク計画から始める" }
+    ]
+  }]
+}
+```
+
+---
+
+## Step 2: フェーズ遷移
+
+確定した開始地点に応じて以下のマッピングで遷移する。
+
+| 開始地点 | 遷移先 |
+|---|---|
+| 標準ワークフロー・ヒアリング | `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ A** から |
+| 標準ワークフロー・設計 | `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ B** から |
+| 標準ワークフロー・計画 | `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ C** から |
+| 実装から | `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ D** から（[注 1]） |
+| デバッグ調査から | Agent ツールで `systematic-debugger` を起動 → `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ D** へ（[注 2]） |
+| レビューから | `.claude/skills/dev-workflow/SKILL.md` を Read して **フェーズ E** から |
+
+[注 1] **実装から** の D-0 判定: plan-report-*.md の YAML フロントマターに `po_plan_version` があれば parallel-agents モード、なければ legacy TDD モードで動作する。plan-report が無い場合はフェーズ C へ案内される。
+
+[注 2] **デバッグ調査から** の D-0 判定: systematic-debugger が当日タイムスタンプの debug-analysis-*.md を出力するため、D-0 がそれを検出して bug-fix モードで動作する。D-1（Red tester）と D-4（Refactor）はスキップされる。
+
+**最初に必ず** 遷移先の `dev-workflow/SKILL.md` を Read してから実行する。記憶・推測で進めず、各フェーズに記述された AskUserQuestion・Edit・セッションファイル更新の手順を省略しないこと。
+
+各エージェント完了後は通常の Approval Flow に従う。
+
+レビューサイクルの loop-back（指摘ありで計画フェーズへ戻る）は dev-workflow フェーズ E が担う。`/start` 側で個別に管理する必要はない。

{claude_code_conductor-2.8.0 → claude_code_conductor-2.9.0}/.gitignore

@@ -48,6 +48,7 @@ site/
 .claude/docs/c3候補機能採用.md
 .claude/docs/c3追加予定機能リスト.md
 .claude/docs/ruflo_research_result.md
+.claude/docs/C3_hnsw_機能追加詳細設計.md
 
 # codex 対応調査メモ (個人作業ノート、配布・コミット対象外)
 .claude/docs/codex対応/