claude-code-conductor 2.54.0__tar.gz → 2.55.0__tar.gz

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.0}/.claude/hooks/_hook_utils.py

@@ -7,8 +7,12 @@ PYTHONPATH に追加してから `from _hook_utils import ...` する経路を
 
 ## Exports
 
+- ``norm_component(s)`` — パス成分を正規化する（`.lower().rstrip('. ')`）。
+  ディレクトリ比較・拡張子判定の際にケース非依存化・末尾ドット/スペース除去を行う。
 - ``write_debug_log(log_path, line)`` — ``C3_HOOK_DEBUG=1`` のときのみログを追記する
   fail-safe な書き込みヘルパー。
+- ``sanitize_for_terminal(text)`` — 端末出力（stderr / stdout JSON）へ載せる前に
+  C0 + DEL + C1 制御文字を除去するヘルパー。
 """
 
 from __future__ import annotations
@@ -32,6 +36,27 @@ DEBUG_ENV = "C3_HOOK_DEBUG"
 _CONTROL_CHARS_RE = re.compile(r"[\x00-\x1f\x7f-\x9f]")
 
 
+def norm_component(s: str) -> str:
+    """パス成分を正規化する（ケース非依存化・末尾ドット/スペース除去）。
+
+    Windows・macOS の既定（ケース非依存 FS）では大文字・小文字の違い、
+    末尾のドットやスペースは同一実体を示す。複数ディレクトリ・拡張子判定の際に
+    `.lower().rstrip('. ')` で正規化してから比較する。
+    """
+    return str(s).lower().rstrip('. ')
+
+
+def sanitize_for_terminal(text: str) -> str:
+    """端末インジェクション対策: C0 制御文字 / DEL / C1 制御文字を除去する。
+
+    - 除去範囲は ``_CONTROL_CHARS_RE``（C0 + DEL + C1）と共通。ANSI エスケープの
+      ESC (``\\x1b``) と CSI (``\\x9b``) の双方をカバーする。
+    - hook が stderr / stdout JSON（additionalContext）へ外部由来の文字列
+      （ファイル名など）を載せる前に通す。
+    """
+    return _CONTROL_CHARS_RE.sub("", str(text))
+
+
 def write_debug_log(log_path: Path, line: str) -> None:
     """``C3_HOOK_DEBUG=1`` のとき、ログファイルに ``ISO8601 line`` を 1 行追記する。
 

claude_code_conductor-2.55.0/.claude/hooks/patterns_guard.py

@@ -0,0 +1,126 @@
+#!/usr/bin/env python3
+"""PreToolUse hook: patterns.json への直接編集を事故防止ガード（P1・配布対象）。
+
+Write / Edit ツールで `.claude/memory/patterns.json` への書き込みを検出し、
+許可フラグがなければブロックする（TTL 型・600 秒）。正規経路は session.tmp 経由の
+promote-pattern skill。意図的な編集は `.claude/state/patterns_guard_allow.flag` で
+一時許可できる。
+
+## 射程の明記（設計の限界）
+
+- 対象: Write / Edit ツール呼び出しのみ
+- 対象外: Bash（python -c・sed 等）/ NotebookEdit 経由の書き込み
+- worktree 実行時: 基準が main/worktree のどちらになるかは環境解決に依存
+  （本 hook の基準は main の patterns.json 本体の事故防止。main 側保護が
+  保護されない場合は検知が働かない限界あり）
+- resolve() による大小文字の正準化は実在ファイルのみ（Windows nt._getfinalpathname）。
+  patterns.json が未作成の初期環境（c3 init 直後）ではケース違い指定が素通りする
+- Windows の末尾ドット・スペース正規化も実在パス限定。非実在パスでは本 hook が検知できない限界
+"""
+
+import json
+import os
+import sys
+import time
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.sanitize_for_terminal) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import sanitize_for_terminal  # noqa: E402
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+# 許可フラグの有効期間（秒）。判定式はこの定数を参照する。
+TTL_SECONDS = 600
+
+
+def main():
+    # bypass: 恒久 disable 環境変数の確認
+    if os.environ.get('C3_PATTERNS_GUARD_DISABLE') == '1':
+        sys.exit(0)
+
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    # tool_name の確認（Write/Edit 以外は対象外）
+    tool_name = payload.get('tool_name', '')
+    if tool_name not in ('Write', 'Edit'):
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落は fail-open）
+    file_path = payload.get('tool_input', {}).get('file_path', '')
+    if not file_path:
+        sys.exit(0)
+
+    # プロジェクトルートと保護対象パスの導出（Path(__file__) ベース）
+    hook_dir = Path(__file__).resolve().parent
+    project_root = hook_dir.parent.parent
+    flag_path = project_root / ".claude" / "state" / "patterns_guard_allow.flag"
+
+    # file_path と保護対象を同じ正規化（realpath）にそろえて比較する。
+    # NUL byte 混入など不正なパス文字列は OSError / ValueError になるため fail-open。
+    try:
+        protected_path = (
+            project_root / ".claude" / "memory" / "patterns.json"
+        ).resolve()
+        if os.path.isabs(file_path):
+            resolved = Path(file_path).resolve()
+        else:
+            # 相対パスは CWD を基準に解決（worktree 実行時は worktree CWD）
+            resolved = (Path.cwd() / file_path).resolve()
+    except (OSError, ValueError):
+        sys.exit(0)
+
+    # realpath 一致チェック
+    if resolved != protected_path:
+        sys.exit(0)
+
+    # patterns.json への書き込みが検出された → フラグチェック
+    # フラグが存在し TTL 内なら allow（削除しない＝複数操作可）
+    #
+    # TOCTOU 免責: exists() / getmtime() / unlink() の間にフラグが差し替えられる
+    # 競合は原理的に残る。本 hook は「事故防止ガード」であり悪意ある同時操作に対する
+    # セキュリティ境界ではないため、この競合は許容する。
+    if flag_path.exists():
+        mtime = os.path.getmtime(flag_path)
+        age = time.time() - mtime
+        if age <= TTL_SECONDS:
+            # TTL 内: 許可
+            sys.exit(0)
+        else:
+            # TTL 超過: フラグを削除して block
+            try:
+                flag_path.unlink()
+            except OSError:
+                pass
+
+    # ブロック: stderr と exit 2
+    flag_create_instruction = (
+        f".claude/state/patterns_guard_allow.flag を作成してください（空ファイルで可）。\n"
+        f"  例 Bash: touch {sanitize_for_terminal(str(flag_path))}\n"
+        f"  例 PowerShell: New-Item -ItemType File -Force "
+        f"{sanitize_for_terminal(str(flag_path))}"
+    )
+
+    message = (
+        f"[PatternGuard BLOCK] patterns.json への直接編集がブロックされました。\n"
+        f"正規経路: session.tmp の「##残タスク」へ記載後、promote-pattern skill を実行してください\n"
+        f"          または LLM が patterns.json を直接編集する場合は以下を実行:\n"
+        f"{flag_create_instruction}\n"
+        f"恒久 bypass: C3_PATTERNS_GUARD_DISABLE=1 環境変数を設定してください"
+    )
+
+    print(message, file=sys.stderr)
+    sys.exit(2)
+
+
+if __name__ == '__main__':
+    main()

claude_code_conductor-2.55.0/.claude/hooks/report_contract_check.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+"""PostToolUse hook: タイムスタンプ報告契約の検査（P2・配布対象）。
+
+`.claude/reports/` 直下への Write で、以下 4 prefix のタイムスタンプ契約逸脱を warn する:
+  - requirements-report-
+  - architecture-report-
+  - plan-report-
+  - design-review-report-
+
+判定は basename 全体のフルマッチ `^{prefix}\\d{8}-\\d{6}\\.md$` で行う
+（prefix 一致と suffix 一致の独立 2 条件ではない。`plan-report-badname-extra-20260725-180252.md`
+のように prefix と タイムスタンプの間へ任意文字列を挟む名前も逸脱として検出するため）。
+不一致の場合は 2 経路で警告: stderr（人間向け）+ stdout JSON（LLM向け）。
+
+## ディレクトリ判定とケース非依存化
+
+reports ディレクトリの判定は `.claude/reports/` 直下かどうかを名前ベースで確認する。
+Windows・macOS の既定（ケース非依存 FS）では `.CLAUDE` や `REPORTS` は `.claude` / `reports` と
+同一実体の別名であり、名前比較は `.lower()` を使用してケース非依存で行う。
+basename（prefix・タイムスタンプ・`.md`）の判定は厳密に行う（`re.ASCII` で Unicode 偽装を防止）。
+
+## 出力契約（PostToolUse warn の標準形）
+
+exit 0 でも stdout JSON が LLM コンテキストへ additionalContext として注入される。
+stderr は人間にのみ届く。詳細は Claude Code 公式仕様を参照:
+  https://code.claude.com/docs/en/hooks
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.sanitize_for_terminal, norm_component) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import norm_component, sanitize_for_terminal  # noqa: E402
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+
+def main():
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    # tool_name の確認（Write 以外は対象外＝新規命名は Write でのみ発生）
+    tool_name = payload.get('tool_name', '')
+    if tool_name != 'Write':
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落は fail-open）
+    file_path = payload.get('tool_input', {}).get('file_path', '')
+    if not file_path:
+        sys.exit(0)
+
+    # `.claude/reports/` 直下かどうかの判定
+    path_obj = Path(file_path)
+    basename = path_obj.name
+    parent = path_obj.parent
+
+    # 構造判定: 親が `reports` かつ祖父が `.claude`（= `.claude/reports/` 直下）。
+    # 上流に同名の `reports/` があっても誤アンカーしない（resolve は使わない）。
+    # ケース非依存 FS（Windows・macOS）では `.CLAUDE` や `REPORTS` は `.claude` / `reports` と
+    # 同一実体の別名のため、比較は norm_component() で正規化してから行う。
+    # Windows の末尾ドット・スペースも norm_component() が除去する。
+    # 例: `/foo/.claude/reports/plan-report-20260725-180252.md` → 対象
+    # 例: `/foo/.claude/reports/archive/plan-report-final.md` → 対象外（直下でない）
+    if norm_component(parent.name) != 'reports' or norm_component(parent.parent.name) != '.claude':
+        sys.exit(0)
+
+    # strict-4: 対象 prefix の確認
+    strict4_prefixes = [
+        'requirements-report-',
+        'architecture-report-',
+        'plan-report-',
+        'design-review-report-',
+    ]
+
+    matched_prefix = None
+    for prefix in strict4_prefixes:
+        if basename.startswith(prefix):
+            matched_prefix = prefix
+            break
+    if matched_prefix is None:
+        sys.exit(0)
+
+    # basename 全体のフルマッチ確認（`{prefix}YYYYMMDD-HHMMSS.md`）
+    # re.ASCII を指定してタイムスタンプを ASCII 数字に限定し、全角数字による偽装を防止する。
+    contract_pattern = re.compile(re.escape(matched_prefix) + r'\d{8}-\d{6}\.md', re.ASCII)
+    if contract_pattern.fullmatch(basename):
+        # 正しい形式
+        sys.exit(0)
+
+    # 違反: 警告を出す（2 経路）
+    # stderr（人間向け）
+    print(
+        f'[ReportContract WARN] {sanitize_for_terminal(basename)} '
+        f'のファイル名形式が違反しています。'
+        f'期待形式: {{prefix}}YYYYMMDD-HHMMSS.md\n'
+        f'採番は report-timestamp skill を使用してください。',
+        file=sys.stderr
+    )
+
+    # stdout JSON（LLM向け）
+    context = (
+        f'ファイル名: {sanitize_for_terminal(basename)}\n'
+        f'期待形式: {{prefix}}YYYYMMDD-HHMMSS.md\n'
+        f'採番方法: report-timestamp skill で取得したタイムスタンプを使用してください。'
+    )
+    output = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context
+        }
+    }
+    print(json.dumps(output), file=sys.stdout)
+
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

claude_code_conductor-2.55.0/.claude/hooks/session_mode_watch.py

@@ -0,0 +1,275 @@
+#!/usr/bin/env python3
+"""PostToolUse hook: session.tmp のモード行挿入・plan= 差し替えを監視（P3・配布対象）。
+
+Edit ツールで `sessions/*.tmp` ファイルを検出し、`^モード: 自律` / `^モード: HITL` 行の
+挿入、複数行にわたる plan= 差し替え、実効モード行の状態遷移を警告する。
+削除（HITL 復帰）・cycles= 更新は沈黙。
+
+## 対象パス判定とケース非依存化
+
+ファイルパスが `sessions/` を含み `.tmp` で終わるかを判定する。
+Windows・macOS の既定（ケース非依存 FS）では `Sessions` や `.TMP` は `sessions` / `.tmp` と
+同一実体の別名であり、判定はメンバシップ検査・拡張子比較ともに `.lower()` でケース非依存で行う。
+否定形の構造自体は変わらない（各成分に `.lower()` を適用するのみ）。
+
+## 判定の SSOT（state transition table） — 複数モード行への拡張
+
+実効モード行は「最初の `^モード: ` 行」（HITL 行を含む。init-session/autonomous-mode が
+`grep -m1 '^モード: '` で読む意味論）。警告判定は以下 3 条件の OR:
+  1. (a) 挿入: old に `^モード: 自律` 行が 0 本、new に 1 本以上
+  2. (b) 新出値: new の有効 plan= 値集合に old の集合に無い値がある
+  3. (c) 実効行遷移: 各側の実効行（最初の `^モード: ` 行。HITL/行なしは「行なし」に写像）の
+     ペアに単一行の状態遷移表を適用し、表が警告と定める遷移に該当
+
+検知種別は (c) が警告なら表の種別を採用、それ以外は (a) / (b) の順。
+
+| old実効 | new実効 | 動作 |
+|---|---|---|
+| 行なし | 行あり(E/N) | 挿入として警告 |
+| 行あり | 行なし | 沈黙（削除・HITL 復帰） |
+| E | E(同値) | 沈黙（cycles= 更新等） |
+| E | E(異値) | 差し替えとして警告 |
+| N | E | 差し替えとして警告（無効→有効昇格） |
+| E | N | 沈黙（有効→無効降格） |
+| N | N | 沈黙 |
+| 行なし | 行なし | 沈黙 |
+
+## 出力契約
+
+2 経路: stderr（人間向け）+ stdout JSON（LLM向け）。
+exit 0 でも stdout JSON が LLM コンテキストへ注入される。
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.sanitize_for_terminal, norm_component) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import norm_component, sanitize_for_terminal  # noqa: E402
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except AttributeError:
+    pass
+
+
+def _find_mode_lines(text: str) -> list[str]:
+    """テキストから `^モード: 自律` にマッチする行を全て探す（複数行対応）。"""
+    lines = text.split('\n')
+    result = []
+    for line in lines:
+        if re.match(r'^モード: 自律', line):
+            result.append(line)
+    return result
+
+
+def _find_effective_mode_line(text: str) -> str | None:
+    """
+    テキストから実効モード行を取得する。
+
+    実効モード行は「最初の `^モード: ` 行」（HITL を含む）。
+    init-session/autonomous-mode SKILL.md の `grep -m1 '^モード: '` に対応。
+    モード行なしなら None を返す。
+    """
+    lines = text.split('\n')
+    for line in lines:
+        if re.match(r'^モード: ', line):
+            return line
+    return None
+
+
+def _extract_plan_value(mode_line: str) -> tuple[str, bool]:
+    """
+    モード行から plan= の値を抽出する。
+
+    Returns:
+        (value, is_extractable): value は抽出値、is_extractable は抽出成功の可否
+          - 正規行（E）: value は plan= 値、is_extractable = True
+          - plan= 欠落（N）: value = "", is_extractable = False
+          - unclosed quote（N）: value = "", is_extractable = False
+    """
+    # plan= を探す
+    match = re.search(r'plan=', mode_line)
+    if not match:
+        # plan= 欠落（N）
+        return "", False
+
+    rest = mode_line[match.end():]
+
+    # plan= 直後が引用符の場合
+    if rest.startswith('"'):
+        # 次の引用符を探す
+        close_quote_idx = rest.find('"', 1)
+        if close_quote_idx == -1:
+            # unclosed quote（N）
+            return "", False
+        # 引用符に囲まれた値（E）
+        value = rest[1:close_quote_idx]
+        return value, True
+
+    # 引用符なしの場合: \s+cycles= または行末まで
+    # SSOT（mode_line.py:89）: \s+cycles= の終端
+    cycles_match = re.search(r'\s+cycles=', rest)
+    if cycles_match:
+        # 値は rest の開始から cycles= 前の空白前まで（strip）
+        value = rest[:cycles_match.start()].strip()
+    else:
+        # 行末まで（strip）
+        value = rest.strip()
+
+    return value, True
+
+
+def main():
+    # JSON payload の読み込み（fail-open）
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    # tool_name の確認（Edit のみ・Write は対象外）
+    tool_name = payload.get('tool_name', '')
+    if tool_name != 'Edit':
+        sys.exit(0)
+
+    # file_path の抽出（キー欠落は fail-open）
+    file_path = payload.get('tool_input', {}).get('file_path', '')
+    if not file_path:
+        sys.exit(0)
+
+    # `sessions/*.tmp` パスかどうかの判定
+    path_obj = Path(file_path)
+    parts = path_obj.parts
+    basename = path_obj.name
+
+    # sessions を含むかつ .tmp で終わるかの確認（ケース非依存）
+    # ケース非依存 FS では Sessions や .TMP も対象に含める。
+    # パス成分は norm_component() で正規化してから比較（末尾ドット・スペース除去も含む）。
+    # basename の拡張子判定も norm_component() でファイル名全体を正規化してから endswith() を適用する。
+    if not any(norm_component(p) == 'sessions' for p in parts) or not norm_component(basename).endswith('.tmp'):
+        sys.exit(0)
+
+    # old_string / new_string の抽出（キー欠落は fail-open）
+    tool_input = payload.get('tool_input', {})
+    old_string = tool_input.get('old_string', '')
+    new_string = tool_input.get('new_string', '')
+
+    # モード行の検出 — F9 では全行走査
+    old_mode_lines = _find_mode_lines(old_string)  # 自律行のみ
+    new_mode_lines = _find_mode_lines(new_string)  # 自律行のみ
+    old_effective_line = _find_effective_mode_line(old_string)  # 最初のモード: 行（HITL含む）
+    new_effective_line = _find_effective_mode_line(new_string)  # 最初のモード: 行
+
+    # 3 条件を全て評価してから優先度で判定する（F10 修正）
+    # 優先順位: (c) 実効行遷移 > (a) 挿入 > (b) 新出値
+    should_warn_c = False
+    warn_kind_c = ''
+    should_warn_a = False
+    should_warn_b = False
+
+    # (c) 実効行遷移: 実効行ペアに単一行の状態遷移表を適用
+    # 実効行の状態を求める
+    old_eff_state = None
+    if old_effective_line is not None:
+        if re.match(r'^モード: 自律', old_effective_line):
+            # 自律行: E/N を判定
+            old_eff_state = 'E' if _extract_plan_value(old_effective_line)[1] else 'N'
+        # else: HITL 行は「行なし」に写像
+
+    new_eff_state = None
+    if new_effective_line is not None:
+        if re.match(r'^モード: 自律', new_effective_line):
+            # 自律行: E/N を判定
+            new_eff_state = 'E' if _extract_plan_value(new_effective_line)[1] else 'N'
+        # else: HITL 行は「行なし」に写像
+
+    # 状態遷移表に基づいて判定
+    if old_eff_state is None and new_eff_state is not None:
+        # 行なし → E/N: 挿入として警告
+        should_warn_c = True
+        warn_kind_c = '挿入'
+    elif old_eff_state == 'E' and new_eff_state == 'E':
+        # E → E: 値が異なれば警告
+        old_value, _ = _extract_plan_value(old_effective_line)
+        new_value, _ = _extract_plan_value(new_effective_line)
+        if old_value != new_value:
+            should_warn_c = True
+            warn_kind_c = '差し替え'
+    elif old_eff_state == 'N' and new_eff_state == 'E':
+        # N → E: 無効→有効昇格は警告
+        should_warn_c = True
+        warn_kind_c = '差し替え'
+
+    # (a) 挿入: old に自律行が 0 本、new に 1 本以上
+    if len(old_mode_lines) == 0 and len(new_mode_lines) >= 1:
+        should_warn_a = True
+
+    # (b) 新出値: new の有効 plan= 値集合に old に無い値
+    if len(new_mode_lines) > 0:
+        # old 側の有効値集合を収集
+        old_values = set()
+        for line in old_mode_lines:
+            value, is_extractable = _extract_plan_value(line)
+            if is_extractable:
+                old_values.add(value)
+
+        # new 側の有効値集合を収集
+        new_values = set()
+        for line in new_mode_lines:
+            value, is_extractable = _extract_plan_value(line)
+            if is_extractable:
+                new_values.add(value)
+
+        # new に old に無い値があるか
+        if new_values - old_values:
+            should_warn_b = True
+
+    # 優先度で判定: (c) > (a) > (b)
+    should_warn = False
+    warn_kind = ''
+    if should_warn_c:
+        should_warn = True
+        warn_kind = warn_kind_c
+    elif should_warn_a:
+        should_warn = True
+        warn_kind = '挿入'
+    elif should_warn_b:
+        should_warn = True
+        warn_kind = '差し替え'
+
+    if not should_warn:
+        # 沈黙
+        sys.exit(0)
+
+    # 警告を出す（2 経路）
+    # stderr（人間向け）
+    print(
+        f'[SessionModeWatch WARN] {sanitize_for_terminal(basename)} '
+        f'のモード行に {warn_kind} が検出されました。',
+        file=sys.stderr
+    )
+
+    # stdout JSON（LLM向け）
+    context = (
+        f'ファイル: {sanitize_for_terminal(basename)}\n'
+        f'検知種別: {warn_kind}\n'
+        f'確認: 委任プラン承認直後の挿入か、承認済みプランへの変更かご確認ください。'
+    )
+    output = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context
+        }
+    }
+    print(json.dumps(output), file=sys.stdout)
+
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.0}/.claude/settings.json

@@ -79,6 +79,11 @@
             "type": "command",
             "command": "c3",
             "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"]
+          },
+          {
+            "type": "command",
+            "command": "c3",
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"]
           }
         ]
       },
@@ -89,6 +94,11 @@
             "type": "command",
             "command": "c3",
             "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/worktree_guard.py"]
+          },
+          {
+            "type": "command",
+            "command": "c3",
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/patterns_guard.py"]
           }
         ]
       },
@@ -121,6 +131,11 @@
             "type": "command",
             "command": "c3",
             "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/planner_check.py"]
+          },
+          {
+            "type": "command",
+            "command": "c3",
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/report_contract_check.py"]
           }
         ]
       },
@@ -136,6 +151,11 @@
             "type": "command",
             "command": "c3",
             "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/planner_check.py"]
+          },
+          {
+            "type": "command",
+            "command": "c3",
+            "args": ["run", "${CLAUDE_PROJECT_DIR}/.claude/hooks/session_mode_watch.py"]
           }
         ]
       }

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.0}/.claude/skills/promote-pattern/SKILL.md

@@ -114,6 +114,13 @@ trust_score: {スコア}
 
 ## Step 6: patterns.json を更新する
 
+**注意:** patterns.json への直接編集は patterns_guard.py hook でブロックされます。以下の順序で実行してください:
+
+1. まず `.claude/state/patterns_guard_allow.flag` を作成します（空ファイルで可）:
+   - Bash: `touch .claude/state/patterns_guard_allow.flag`
+   - PowerShell: `New-Item -ItemType File -Force .claude/state/patterns_guard_allow.flag`
+2. その直後に patterns.json を Edit ツールで更新します（TTL 600 秒以内）
+
 昇格したパターンの entry に以下を追加する:
 
 rule の場合:

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.0}/ARCHITECTURE.md

@@ -114,9 +114,13 @@ A ヒアリング → B 設計 → C 計画 → D 実装(TDD) → E レビュー
 | `UserPromptSubmit` | （全て） | `recall_inject.py` | 過去類似情報を意味検索しコンテキスト注入（[§4](#4-知能基盤)） |
 | `PreToolUse` | `Bash` | `pre_tool.py` | 破壊的コマンド（`rm -rf` 等）ブロック・secret スキャン |
 | `PreToolUse` | `Write` / `Edit` | `worktree_guard.py` | worktree 外への書き込み禁止（`PO_WORKTREE_GUARD=1` 設定時のみ作動。parallel-agents が並列実行時に有効化） |
+| `PreToolUse` | `Write` / `Edit` | `patterns_guard.py` | patterns.json への直接編集を block（許可フラグ TTL 600 秒・C3_PATTERNS_GUARD_DISABLE=1 で無効化） |
 | `PreToolUse` | `Agent` | `check_agent_invocation.py` | エージェント起動の検査 |
+| `PreToolUse` | `Agent` | `tier_autoapply.py` | 推奨 Tier の `model:` 自動注入（既存登録の表への追随・乖離是正） |
 | `PostToolUse` | `Write` / `Edit` | `post_tool.py` | skills 変更通知・品質パターン（TODO 等）スキャン |
 | `PostToolUse` | `Write` / `Edit` | `planner_check.py` | plan-report の YAML/タイムスタンプ/reviewer 規約検査 |
+| `PostToolUse` | `Write` | `report_contract_check.py` | reports 直下のタイムスタンプ契約 4 種の命名逸脱を warn（stderr + additionalContext） |
+| `PostToolUse` | `Edit` | `session_mode_watch.py` | session.tmp のモード行挿入・plan= 差し替えを warn（stderr + additionalContext） |
 | `PermissionRequest` | （全て） | `permission_handler.py` | `permission_rules.json` の `auto_allow` で自動承認（[config-policy §2 レイヤー B](.claude/docs/config-policy.md)） |
 | `PreCompact` | （全て） | `pre_compact.py` | compact 前にチェックポイントマーカー注入 |
 | `Stop` | （全て） | `session_stop.py` | セッション終了処理のオーケストレータ |

{claude_code_conductor-2.54.0 → claude_code_conductor-2.55.0}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.55.0] - 2026-07-26
+
+### 追加
+
+- **`patterns_guard.py`（PreToolUse block・配布対象）**: `.claude/memory/patterns.json` への Write / Edit を exit 2 でブロックする事故防止ガード。過去の直接 Edit 起因の肥大 defect（98KB）の再発防止で、正規経路（session.tmp 経由で `stop.py` が取り込む promote-pattern フロー）は Python 直接 I/O のため影響を受けない。意図的な編集は `.claude/state/patterns_guard_allow.flag`（TTL 600 秒）で一時許可、緊急時は環境変数 `C3_PATTERNS_GUARD_DISABLE=1` で無効化できる。promote-pattern skill の Step 6 にフラグ発行手順を追記。docstring に射程の限界（Bash / NotebookEdit 経由は対象外・非実在パスのケース正準化不可）を明記
+- **`report_contract_check.py`（PostToolUse warn・配布対象）**: `.claude/reports/` 直下への Write で、strict-4 prefix（requirements / architecture / plan / design-review）のタイムスタンプ契約逸脱を警告する。判定は basename 全体のフルマッチ `^{prefix}\d{8}-\d{6}\.md$`（`re.ASCII`・prefix とタイムスタンプの間に任意文字列を挟む名前も検出）。ディレクトリ判定は `.claude/reports/` 直下を名前ベース・ケース非依存（`norm_component`）で行う。警告は stderr（人間向け）+ stdout JSON `additionalContext`（LLM 向け）の 2 経路
+- **`session_mode_watch.py`（PostToolUse warn・配布対象）**: `sessions/*.tmp` への Edit で autonomous-mode のモード行変更を監視する。警告条件は 3 条件の OR — (a) `^モード: 自律` 行の挿入 (b) 有効 plan= 値の新出 (c) 実効モード行（最初の `^モード: ` 行）の状態遷移表該当。削除（HITL 復帰）・cycles= 更新・有効→無効降格は沈黙。opt-in 不変則の事後検知層として機能する（モード行の検証 SSOT は従来どおり `mode_line.py`）
+- **`_hook_utils.py` に共通ヘルパー追加**: `sanitize_for_terminal()`（C0/C1/DEL 制御文字除去・警告文へ埋め込む外部由来文字列の共通サニタイズ）と `norm_component()`（Windows 末尾ドット・スペース正規化＋ケース非依存比較）を新設し、新 hook 3 本から共用
+- **`.claude/settings.json` に hook 3 本を登録**: PreToolUse（Write|Edit）に patterns_guard、PostToolUse（Write）に report_contract_check、PostToolUse（Edit）に session_mode_watch。テスト +129 件（フルスイート 2152 → 2281 passed）
+
+### 変更
+
+- **ARCHITECTURE.md の hook 一覧を実態へ同期**: 新規 3 hook の行を追加し、tier_autoapply の記述乖離を是正
+
+### 後方互換
+
+- **破壊的変更なし**。patterns.json への直接 Write / Edit はもともと規約違反の経路（taxonomy.md の正規定義・配布元 CLAUDE.md §10）であり、正規経路の promote-pattern フロー・`stop.py` の機械管理は挙動不変。ブロックされた場合も警告文に許可フラグの発行手順が表示され、フラグ / 環境変数で意図的な編集は引き続き可能。P2 / P3 は警告のみ（exit 0）で既存ワークフローを止めない
+
 ## [2.54.0] - 2026-07-24
 
 ### 追加