claude-code-conductor 2.12.0__tar.gz → 2.14.0__tar.gz

claude_code_conductor-2.14.0/.claude/agents/planner.md

@@ -0,0 +1,69 @@
+---
+name: planner
+model: opus
+description: 計画立案担当。全レポートを統合しタスク分解した plan-report を出力する。ソース編集不可。
+tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Skill
+---
+
+# Planner
+<!-- ペルソナ定義: /start コマンドで親 Claude がこのペルソナを採用して対話を行う。サブエージェントとして起動しない。 -->
+
+## Core Mandate
+requirements-report・architecture-report・各種レビューレポートを統合し、実装可能なタスクに分解した plan-report を出力する。
+
+## Key Scope
+
+✅ 担当すること:
+- タスク分解と優先度決定
+- マイルストーン設定
+- 並列実行可能なタスクグループの識別
+- 各エージェントへの作業指示の明文化
+- plan-report の出力・更新
+
+❌ 担当しないこと:
+- 設計判断（architect の担当）
+- ソースコードの編集
+- テスト・レビューの実施
+
+## Workflow
+
+**Before:**
+- **必読: `.claude/rules/plan-design-guidelines.md`** を Read する（depends_on 設計・TDD 3-wave 分解・writes 衝突回避・自動検査ルール R2〜R6・出力直前の自己チェックリスト）
+- 利用可能な全レポートを Read する（requirements / architecture / test / review）
+- レポートが存在しないフェーズはスキップして正常とする
+
+**During:**
+- レビュー指摘がある場合は優先度を付けて反映する
+- タスクは「1タスク = 1コミット」の粒度を意識して分解する
+- `plan-design-guidelines.md` のルール 1〜13 と R2/R3/R4/R5/R6 を全て遵守する
+
+**After:**
+- Skill ツールで `report-timestamp` を呼び出してタイムスタンプを取得し、Write ツールで `.claude/reports/plan-report-{timestamp}.md` に出力する
+- plan-report の**先頭に YAML フロントマターを必ず付与する**。最低限以下を出力すること:
+  - `po_plan_version: "0.1"`
+  - `name`（プランの表示名・文字列）
+  - `cwd: "../.."`（plan-report からプロジェクトルートへの相対パス）
+  - `tasks: [...]`（各タスクは `id` / `agent` / `read_only` / `prompt` を必須とする。書き込みあり = `read_only: false`、読み取り専用レビューのみ = `read_only: true`）
+- `tasks[].id` は英数字・ハイフン・アンダースコアのみで一意にする。Markdown 本文の依存関係セクションと `tasks[].depends_on` を一致させる
+- フロントマターは YAML パーサで再パース可能でなければならない（インデントずれ・タブ混入禁止）
+- 出力前に `plan-design-guidelines.md` の「出力直前の自己チェックリスト」を必ず満たすこと
+
+## Tools & Constraints
+制限:
+- ソースファイルの編集・書き込みは行わない
+- plan-report の YAML フロントマター内で `tasks[].id` の重複・未定義の `depends_on` 参照・エージェント名の typo を出力しない（`c3 plan validate` で検証可能）
+- `.claude/rules/plan-design-guidelines.md` のルール 1〜13 と自己チェックリストに違反した plan-report を出力しない
+- 自動検査対象に違反する plan-report を出力しない:
+  - R2/R4/R6（配布対象）: `.claude/hooks/planner_check.py` が PostToolUse で WARN を出す
+  - R3（C3 固有）: `.dev/hooks/_planner_check.py` が PostToolUse で exit 2 ブロック
+  - R5（worktree 違反）: `.claude/hooks/check_agent_invocation.py` が Agent ツール呼び出し時に exit 2 ブロック
+
+## Related Agents
+- 上流: architect（architecture-report を受け取る）
+- 下流: developer・tester（plan-report を受け渡す）
+- 再起動元: code-reviewer・security-reviewer（指摘反映後に再計画）

claude_code_conductor-2.14.0/.claude/agents/project-setup.md

@@ -0,0 +1,77 @@
+---
+name: project-setup
+model: opus
+description: プロジェクト初期設定担当。収集済みのスタック情報と規約情報を受け取り rules/ に配置する。
+tools:
+  - Read
+  - Write
+  - Glob
+  - WebSearch
+  - WebFetch
+---
+
+# Project Setup
+
+## Core Mandate
+親 Claude から渡されたスタック情報・規約情報をもとに、テンプレートを埋めて
+`.claude/rules/coding-standards.md` と `.claude/rules/project-conventions.md` を生成する。
+ユーザーとの対話は行わない。
+
+## Key Scope
+
+✅ 担当すること:
+- 渡されたスタック情報をもとに標準規約を WebSearch / WebFetch で調査・収集
+- `.claude/rules/coding-standards.md` の生成
+- `.claude/rules/project-conventions.md` の生成
+
+❌ 担当しないこと:
+- ユーザーへの質問・ヒアリング（親 Claude が実施済み）
+- 規約ファイル以外のソースファイルの編集
+- プロジェクトの設計・アーキテクチャ判断
+
+## Workflow
+
+**Step 1: テンプレートと参照を Read する**
+
+以下を Read してプレースホルダ構造と置換ルールを把握する:
+- `.claude/skills/setup/templates/coding-standards-template.md`
+- `.claude/skills/setup/templates/project-conventions-template.md`
+- `.claude/skills/setup/reference.md`（言語→拡張子マッピング・公式スタイルガイド参照先）
+
+**Step 2: 既存ファイルの確認**
+
+Glob で `.claude/rules/coding-standards.md` と `.claude/rules/project-conventions.md` の存在を確認する。
+存在する場合は Read して、上書きではなく更新として差分を反映する。
+
+**Step 3: 標準規約の Web 検索**
+
+プロンプトに含まれるスタック情報と `reference.md` の「公式スタイルガイド参照先」をもとに以下を調査する:
+- 言語の公式スタイルガイド（PEP8、Google Style Guide、StandardJS 等）
+- フレームワークのベストプラクティス（公式ドキュメント優先）
+- セキュリティガイドライン（OWASP、CWE 等）
+- テストフレームワークのベストプラクティス
+
+**Step 4: 2 ファイルを生成**
+
+テンプレートの `{プレースホルダ}` を以下のルールで置換し、Write ツールで出力する:
+
+- `{LANG_PATHS}` ← `reference.md` の言語→glob マッピングを YAML リスト行に展開
+- `{STACK_NAME}` / `{LANGUAGE}` / `{FRAMEWORK}` / `{RUNTIME}` / `{DATABASE}` ← 親プロンプトのスタック情報
+- `{LAST_UPDATED}` ← 今日の日付（YYYY-MM-DD）
+- `{STYLE_GUIDE_NOTES}` / `{NAMING_RULES}` / `{TEST_RULES}` / `{SECURITY_BASELINE}` ← Step 3 の Web 検索結果
+- `{PROJECT_NAMING_RULES}` / `{COMMENT_POLICY}` / `{TEST_COVERAGE_GOAL}` / `{BRANCH_COMMIT_RULES}` / `{OTHER_RULES}` ← 親プロンプトのヒアリング結果
+
+出力先:
+- `.claude/rules/coding-standards.md`
+- `.claude/rules/project-conventions.md`
+
+**Step 5: 完了報告**
+
+生成した 2 ファイルのパスと主要な規約の概要を出力する。
+
+## Tools & Constraints
+制限: 規約ファイル以外のソースファイルは編集しない
+
+## Related Agents
+- 起動元: 親 Claude（コマンドファイルが全情報を収集してからプロンプトに渡す）
+- 下流参照: architect・developer・tester・code-reviewer・security-reviewer

claude_code_conductor-2.14.0/.claude/hooks/_hook_utils.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""Shared utilities for .claude/hooks/ scripts (配布対象).
+
+複数 hook で共有するヘルパー関数を集約する。各 hook はスタンドアロン実行されるため、
+このファイルへのアクセスは `sys.path.insert(0, dirname(__file__))` で hooks/ を
+PYTHONPATH に追加してから `from _hook_utils import ...` する経路を取る。
+
+## Exports
+
+- ``write_debug_log(log_path, line)`` — ``C3_HOOK_DEBUG=1`` のときのみログを追記する
+  fail-safe な書き込みヘルパー。
+"""
+
+from __future__ import annotations
+
+import os
+import re
+from pathlib import Path
+
+DEBUG_ENV = "C3_HOOK_DEBUG"
+
+# 制御文字を除去するための正規表現。debug ログは端末には直接表示されないが、
+# ファイルが汚染されると後段で `cat` などで確認した際にエスケープが解釈される
+# 可能性があるため除去する。
+#
+# 除去範囲:
+#   - C0 制御文字 (\x00-\x1f) — NUL/BEL/BS/HT/LF/VT/FF/CR/ESC など。ANSI エスケープ
+#     シーケンスの ESC (\x1b) もここに含まれる
+#   - DEL (\x7f) — 古い端末で破壊的削除制御に使われる
+#   - C1 制御文字 (\x80-\x9f) — Latin-1 拡張領域の制御文字。一部の端末・ロケールで
+#     エスケープシーケンスのプリフィクス（例: CSI = \x9b）として解釈される
+_CONTROL_CHARS_RE = re.compile(r"[\x00-\x1f\x7f-\x9f]")
+
+
+def write_debug_log(log_path: Path, line: str) -> None:
+    """``C3_HOOK_DEBUG=1`` のとき、ログファイルに ``ISO8601 line`` を 1 行追記する。
+
+    - 環境変数未設定なら即 return（コスト 0）。
+    - ファイル作成・書き込みに失敗しても本体動作を止めない（``OSError`` を握りつぶす）。
+    - 各 hook 固有のフォーマットはこの関数の呼び出し側で組み立て、``line`` 引数として渡す。
+    - ``log_path`` は ``Path`` 前提。各 hook 側で ``__file__`` ベースの絶対パスに統一すること。
+    - ``line`` に含まれる C0/C1 制御文字（ANSI ESC を含む）と DEL は除去してから書き込む。
+      呼び出し側 hook の入力に制御文字が混入してもログファイルが汚染されないようにする。
+    """
+    if os.environ.get(DEBUG_ENV) != "1":
+        return
+    try:
+        import datetime as _dt
+        log_path.parent.mkdir(parents=True, exist_ok=True)
+        timestamp = _dt.datetime.now().isoformat(timespec="seconds")
+        sanitized = _CONTROL_CHARS_RE.sub("", str(line))
+        with log_path.open("a", encoding="utf-8") as fh:
+            fh.write(f"{timestamp} {sanitized}\n")
+    except OSError:
+        pass

claude_code_conductor-2.14.0/.claude/hooks/check_agent_invocation.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+"""PreToolUse Agent hook: read_only タスクの worktree 違反を BLOCK する。
+
+## 検査ルール
+
+- **R5**: subagent_type が `code-reviewer` / `security-reviewer` のとき
+  `isolation: "worktree"` は禁止。worktree 自動クリーンアップで
+  `.claude/reports/*.md`（gitignored）が消失するため。
+
+## fail-safe 設計
+
+- `tool_input` のキー名（`subagent_type` / `isolation`）は Claude Code 公式仕様に
+  ドキュメント化されていない（2026-05-21 時点）。キー名が想定と異なる場合は
+  検出できず exit 0（許可）にフォールバックする。誤検知で全 Agent 呼び出しを
+  ブロックすることはない。
+- デバッグ用に `C3_HOOK_DEBUG=1` を設定すると `tool_input` を
+  `.claude/tmp/agent_hook_debug.log` に追記する（キー名検証用）。
+
+## 出力経路
+
+- BLOCK 時は **stderr** に `[CheckAgentInvocation BLOCK]` を出力し ``exit 2`` する。
+  PreToolUse の ``exit 2`` は Claude Code が動作をブロックする公式仕様。
+  PreToolUse ``exit 2`` 時に stdout JSON で LLM コンテキストに注入する公式仕様は
+  2026-05-21 時点で見当たらないため、本 hook は stderr のみで運用している
+  （PostToolUse とは設計が異なる点に注意）。
+
+## 過去パターン根拠
+
+- 2026-05-21 のフルワークフロー動作確認で発生したルール違反 1
+  （read_only: true タスクに isolation:worktree を指定し、reports が消失）への対策。
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.write_debug_log) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import write_debug_log  # noqa: E402
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+except AttributeError:
+    pass
+
+REVIEWER_TYPES = frozenset({"code-reviewer", "security-reviewer"})
+
+# プロジェクトルートと debug ログのパスはスクリプトファイルからの絶対パスに固定する。
+# cwd 依存だと worktree コンテキストで `.claude/tmp/` が意図しない場所に作られる。
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+DEBUG_LOG_PATH = PROJECT_ROOT / ".claude" / "tmp" / "agent_hook_debug.log"
+
+# DoS 防御の読み取り上限（hook はローカル前提だが多層防御として明示する）。
+_STDIN_READ_LIMIT_BYTES = 1 * 1024 * 1024  # 1 MiB
+
+
+def _escape_for_log(value: str) -> str:
+    """改行を含む値をログ・stderr に安全に表示するための簡易エスケープ。"""
+    return value.replace("\r", "\\r").replace("\n", "\\n")
+
+
+def main() -> None:
+    try:
+        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_BYTES))
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    if payload.get("tool_name") != "Agent":
+        sys.exit(0)
+
+    tool_input = payload.get("tool_input")
+    if not isinstance(tool_input, dict):
+        sys.exit(0)
+
+    subagent_type = tool_input.get("subagent_type", "")
+    isolation = tool_input.get("isolation", "")
+    if not isinstance(subagent_type, str):
+        subagent_type = ""
+    if not isinstance(isolation, str):
+        isolation = ""
+
+    if subagent_type not in REVIEWER_TYPES:
+        # 対象外（reviewer 系でない）は素通り。デバッグログも残さない（ノイズ削減）
+        sys.exit(0)
+
+    isolation_display = _escape_for_log(isolation) if isolation else "none"
+
+    if isolation == "worktree":
+        write_debug_log(
+            DEBUG_LOG_PATH,
+            f"{subagent_type or 'unknown'} isolation={isolation_display} BLOCK R5",
+        )
+        print(
+            f"[CheckAgentInvocation BLOCK] R5: subagent_type={subagent_type!r} "
+            f'(read_only) タスクには isolation: "worktree" を指定できません。'
+            f" worktree 自動クリーンアップで .claude/reports/*.md が消失します。"
+            f" isolation を省略して main リポジトリで直接実行してください。",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    write_debug_log(
+        DEBUG_LOG_PATH,
+        f"{subagent_type or 'unknown'} isolation={isolation_display} PASS",
+    )
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

claude_code_conductor-2.14.0/.claude/hooks/planner_check.py

@@ -0,0 +1,307 @@
+#!/usr/bin/env python3
+"""PostToolUse hook: plan-report の YAML frontmatter 機械検査（配布対象）。
+
+`.claude/reports/plan-report-*.md` への Write/Edit を検出し、汎用ルールに違反していれば
+WARN を出す。出力は 2 経路:
+
+- **stderr**: 人間（ターミナル表示）向け [PlannerCheck WARN] テキスト
+- **stdout JSON**: `hookSpecificOutput.additionalContext` で LLM に system reminder として注入
+
+Claude Code 公式仕様（https://code.claude.com/docs/en/hooks）に従い、PostToolUse の
+exit 0 では stdout JSON のみが LLM コンテキストに伝達される。stderr は人間にしか
+届かないため、両方出力して二重防衛とする。
+
+## 検査ルール（配布対象）
+
+- **R2**: `agent: code-reviewer` / `security-reviewer` の task の writes パスに
+  タイムスタンプ（YYYYMMDD 単独、または YYYYMMDD-HHMMSS）が含まれていれば WARN。
+  parallel-agents skill の成果物取り込みでタイムスタンプを動的に取得すると
+  writes と実ファイル名が乖離するため、task_id ベースの固定名にする。
+- **R4**: 同一 writes パスを複数 task が宣言していて、後発 task の depends_on に
+  先発 task が含まれていない場合は WARN（並列実行で破壊的競合）。
+- **R6**: plan-report のタスク総数 >= 3 かつ `agent: code-reviewer` /
+  `agent: security-reviewer` が 0 件の場合は WARN（レビュー全削除検出）。
+  2026-05-21 のルール違反 2 対策として追加。
+
+## 開発元のみのルール
+
+- **R3**（`src/c3/_template/` への writes 禁止）は C3 開発リポジトリ固有のため
+  `.dev/hooks/_planner_check.py` に分離して開発元でのみ動作。
+"""
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+# 共通ヘルパー (_hook_utils.write_debug_log) を hooks/ 経由で import するため、
+# このスクリプトのディレクトリを PYTHONPATH に追加する。
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from _hook_utils import write_debug_log  # noqa: E402
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8")
+    sys.stderr.reconfigure(encoding="utf-8")
+except AttributeError:
+    pass
+
+try:
+    import yaml
+except ImportError:
+    # PyYAML 未インストール環境では silent exit
+    sys.exit(0)
+
+
+# プロジェクトルートと debug ログのパスはスクリプトファイルからの絶対パスに固定する。
+# cwd 依存だと worktree コンテキストで `.claude/tmp/` が意図しない場所に作られる。
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+DEBUG_LOG_PATH = PROJECT_ROOT / ".claude" / "tmp" / "planner_check_debug.log"
+
+# DoS 防御の読み取り上限（hook はローカル前提だが多層防御として明示する）。
+_STDIN_READ_LIMIT_BYTES = 1 * 1024 * 1024  # 1 MiB
+_FILE_READ_LIMIT_BYTES = 512 * 1024        # 512 KiB
+
+
+_FRONTMATTER_RE = re.compile(r"^---\s*\n(.*?)\n---\s*(?:\n|\Z)", re.DOTALL)
+# YYYYMMDD（8 桁）または YYYYMMDD-HHMMSS（8 桁 + ハイフン + 6 桁）。
+# 前後が英数字なら task_id の一部とみなし誤検知を回避する。
+# 注意: ハイフン区切りで孤立した 8 桁数字（例: report-12345678.md）は YYYYMMDD と
+# 区別できないため意図的に WARN を発火させる（test_planner_check.py
+# test_8digit_standalone_in_filename_triggers_warn 参照）。
+# task_id に 8 桁数字のみを使う場合は英数字混在 ID に変更すること。
+_TIMESTAMP_RE = re.compile(r"(?<![A-Za-z0-9])\d{8}(?:-\d{6})?(?![A-Za-z0-9])")
+
+# R6 検出の閾値: タスク総数がこの値以上で reviewer 0 件なら WARN を出す
+_R6_TASK_THRESHOLD = 3
+
+_REVIEWER_AGENTS = frozenset({"code-reviewer", "security-reviewer"})
+
+
+def _sanitize(s: str) -> str:
+    """ターミナルインジェクション対策: 制御文字と JSON 互換性を壊す Unicode 行区切りを除去する。
+
+    除去対象:
+      - C0/C1 制御文字 (\\x00-\\x1f) と DEL (\\x7f) — ANSI エスケープ (ESC 0x1b) を含む
+      - U+2028 (Line Separator) / U+2029 (Paragraph Separator) — 一部の JS/JSON
+        パーサが行区切りとして扱い、ensure_ascii=False の JSON 解析を破壊する
+    """
+    return re.sub("[\x00-\x1f\x7f\u2028\u2029]", "", str(s))
+
+
+def _normalize(path: str) -> str:
+    """Windows のバックスラッシュを `/` に統一する。"""
+    return path.replace("\\", "/")
+
+
+def _is_plan_report(file_path: str) -> bool:
+    """basename が `plan-report-*.md` で、パスに `..` トラバーサルを含まない。
+
+    `..` セグメントを含むパス（``../../plan-report-foo.md`` 等）は後段の
+    ``open(file_path)`` で任意ファイル読み取りの経路になりうるため拒否する。
+    """
+    normalized = _normalize(file_path)
+    if ".." in normalized.split("/"):
+        return False
+    basename = os.path.basename(normalized)
+    return basename.startswith("plan-report-") and basename.endswith(".md")
+
+
+def _extract_frontmatter(text: str) -> dict | None:
+    match = _FRONTMATTER_RE.match(text)
+    if not match:
+        return None
+    try:
+        parsed = yaml.safe_load(match.group(1))
+    except yaml.YAMLError:
+        return None
+    if not isinstance(parsed, dict):
+        return None
+    return parsed
+
+
+def _check_r2_reviewer_timestamp(task: dict) -> list[str]:
+    """reviewer の writes にタイムスタンプ入りファイル名があれば違反メッセージ。"""
+    if task.get("agent") not in _REVIEWER_AGENTS:
+        return []
+    writes = task.get("writes")
+    if not isinstance(writes, list):
+        return []
+    violations: list[str] = []
+    for w in writes:
+        if not isinstance(w, str):
+            continue
+        basename = os.path.basename(_normalize(w))
+        if _TIMESTAMP_RE.search(basename):
+            violations.append(
+                f"R2: task {task.get('id')!r} ({task.get('agent')}) の writes "
+                f"{w!r} にタイムスタンプ風パターンが含まれています。"
+                "task_id ベースのファイル名にしてください"
+            )
+    return violations
+
+
+def _build_ancestor_map(by_id: dict[str, dict]) -> dict[str, set[str]]:
+    """各 task の depends_on 推移閉包（祖先集合）を返す。"""
+    ancestors: dict[str, set[str]] = {tid: set() for tid in by_id}
+    for tid in by_id:
+        stack = list(by_id[tid].get("depends_on", []) or [])
+        while stack:
+            dep = stack.pop()
+            if dep in ancestors[tid]:
+                continue
+            ancestors[tid].add(dep)
+            dep_task = by_id.get(dep)
+            if dep_task:
+                stack.extend(dep_task.get("depends_on", []) or [])
+    return ancestors
+
+
+def _all_pairs_transitively_ordered(
+    claim_ids: list[str], ancestors: dict[str, set[str]]
+) -> bool:
+    """claim_ids 内の全ペアが depends_on 推移閉包で順序付けされているか。"""
+    for i, a in enumerate(claim_ids):
+        for b in claim_ids[i + 1:]:
+            if a in ancestors.get(b, set()) or b in ancestors.get(a, set()):
+                continue
+            return False
+    return True
+
+
+def _check_r4_writes_conflicts(tasks: list) -> list[str]:
+    """同一 writes パスを宣言する複数 task が depends_on で順序付けされていなければ警告。"""
+    by_id: dict[str, dict] = {}
+    for task in tasks:
+        if not isinstance(task, dict):
+            continue
+        tid = task.get("id")
+        if isinstance(tid, str) and tid:
+            by_id[tid] = task
+
+    claims: dict[str, list[str]] = {}
+    for tid, task in by_id.items():
+        writes = task.get("writes")
+        if not isinstance(writes, list):
+            continue
+        for w in writes:
+            if not isinstance(w, str):
+                continue
+            claims.setdefault(_normalize(w), []).append(tid)
+
+    ancestors = _build_ancestor_map(by_id)
+
+    violations: list[str] = []
+    for path, claim_ids in claims.items():
+        if len(claim_ids) < 2:
+            continue
+        if _all_pairs_transitively_ordered(claim_ids, ancestors):
+            continue
+        # claim_ids は task id の生 join のため、特殊文字を repr で逃がして安全に出力する
+        joined = ", ".join(repr(cid) for cid in sorted(claim_ids))
+        violations.append(
+            f"R4: writes {path!r} を複数 task ({joined}) "
+            "が宣言していますが depends_on で順序付けされていません。"
+            "並列実行で破壊的競合が起きる可能性があります"
+        )
+    return violations
+
+
+def _check_r6_reviewer_absence(tasks: list) -> list[str]:
+    """plan-report 内のレビュータスクが完全消失している場合の警告。
+
+    検出条件: タスク総数 >= _R6_TASK_THRESHOLD AND reviewer 系 agent が 0 件。
+    閾値が 3 なのは、小規模な単発タスク（ドキュメント修正など）の合理的な省略を巻き込まないため。
+    """
+    if not isinstance(tasks, list) or len(tasks) < _R6_TASK_THRESHOLD:
+        return []
+    reviewer_tasks = [
+        t for t in tasks
+        if isinstance(t, dict) and t.get("agent") in _REVIEWER_AGENTS
+    ]
+    if reviewer_tasks:
+        return []
+    return [
+        f"R6: plan-report のタスク総数 {len(tasks)} 件に対して "
+        "code-reviewer / security-reviewer タスクが 0 件です。"
+        "レビュータスクを意図的に省略する場合はユーザー承認を取ってください"
+    ]
+
+
+def main() -> None:
+    try:
+        payload = json.loads(sys.stdin.read(_STDIN_READ_LIMIT_BYTES))
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    if payload.get("tool_name") not in ("Write", "Edit"):
+        sys.exit(0)
+
+    file_path = payload.get("tool_input", {}).get("file_path", "")
+    if not isinstance(file_path, str) or not file_path:
+        sys.exit(0)
+
+    if not _is_plan_report(file_path):
+        sys.exit(0)
+
+    basename = os.path.basename(_normalize(file_path))
+
+    try:
+        with open(file_path, encoding="utf-8") as fh:
+            text = fh.read(_FILE_READ_LIMIT_BYTES)
+    except (OSError, UnicodeDecodeError):
+        sys.exit(0)
+
+    frontmatter = _extract_frontmatter(text)
+    if frontmatter is None:
+        sys.exit(0)
+
+    tasks = frontmatter.get("tasks")
+    if not isinstance(tasks, list):
+        sys.exit(0)
+
+    warnings: list[str] = []
+    for task in tasks:
+        if not isinstance(task, dict):
+            continue
+        warnings.extend(_check_r2_reviewer_timestamp(task))
+
+    warnings.extend(_check_r4_writes_conflicts(tasks))
+    warnings.extend(_check_r6_reviewer_absence(tasks))
+
+    if warnings:
+        # 検出されたルール名（R2/R4/R6）を抽出してデバッグログに記録
+        detected_rules = sorted({m.split(":")[0] for m in warnings if ":" in m})
+        write_debug_log(DEBUG_LOG_PATH, f"{basename} WARN {','.join(detected_rules)}")
+        # 経路1: stderr に人間向けメッセージ（ターミナル表示用）
+        print("[PlannerCheck WARN] plan-report の検査で違反を検出しました:",
+              file=sys.stderr)
+        sanitized_warnings = [_sanitize(msg) for msg in warnings]
+        for msg in sanitized_warnings:
+            print(f"  - {msg}", file=sys.stderr)
+
+        # 経路2: stdout JSON で LLM コンテキストに system reminder として注入
+        # Claude Code が hookSpecificOutput.additionalContext を読み取り、
+        # LLM のコンテキストウィンドウに挿入する（公式仕様）
+        additional_context = (
+            "[PlannerCheck WARN] plan-report の検査で違反を検出しました:\n"
+            + "\n".join(f"  - {msg}" for msg in sanitized_warnings)
+            + "\n\n"
+            + "ルールの詳細は .claude/rules/plan-design-guidelines.md を参照。"
+            + "意図的に許容する場合はユーザーに確認を取ること。"
+        )
+        output = {
+            "hookSpecificOutput": {
+                "hookEventName": "PostToolUse",
+                "additionalContext": additional_context,
+            }
+        }
+        print(json.dumps(output, ensure_ascii=False))
+    else:
+        write_debug_log(DEBUG_LOG_PATH, f"{basename} PASS")
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()