Doctor Loop

---
description: リポジトリの現状そのもの（コード・文書・CI・開発環境）を読み取り専用で診て、改善候補（減らす・機械チェック化する・構造を正す・時代に合わせる）を掘り、敵対検証で刈り込みながら根本の木を組み立て、生き残った候補と一撃（最も梃子の効く根本）を提案として報告する（刈ったノードと理由も併載）。変更は適用しない。変更を診るのではなく、変更を待たずに診る。起動するのは、人が /doctor-loop と打ったときか「工程に回して」と言ったときだけ——AI は自分から起動せず、リポジトリの現状を診る必要に当たったら人に提案する。技術選定・方式の校正は research-loop。
allowed-tools: Bash, Agent, Workflow, Read, Grep, Glob, WebSearch, WebFetch
---

# doctor-loop

## 位置づけ（一家の分業）

変更を待たずに、リポジトリの現状そのものから候補を掘るのが本ループ。掘った候補の採用と実装は人がやる。構成変更級候補の見立てを一次情報で校正するのは `/research-loop`。1 回の実行の中でもラウンドを回す——**1 ラウンド＝P1→P3 を 1 周**で、新しい目（新規コンテキストの scout）で掘り直し、木のどのノードからも新しいノードが生えなくなるまで続ける（理論的飽和——厳密な収束条件は P4）。回数を数えて「N 回やったから網羅した」と言うな——飽和だけが掘り尽くしの証拠である。

このループを回すセッションが **prospector**（統合者）。prospector はセッションのモデルをそのまま使え——木の構築・一撃の選定は判断作業であり、コスト削減で下位モデルに落とすな（ここが濁ると全下流の判断が濁る）。

**このループは提案のみを行い、リポジトリへの変更を一切適用しない。** Bash は読み取り専用の計器（lint・型検査・未使用検出・テスト実行・git 履歴）としてのみ使え——**例外は「変更禁止の機械確認」が命じる、自分の汚しの復旧だけである**。本ループが起動するサブエージェントは役割 agent（[references/tools.md](references/tools.md) の「依存」）で立てる。どの役も書くツールを持たないが、`investigator` だけは Bash を持つ——起動する `investigator` のプロンプトには、役が自分に課す禁止をこの文のまま書け——「お前はこのサブエージェント。ファイルの作成・編集・削除を自らに禁じる」。保証を与えるのは定義でも自制でもなく、下の「変更禁止の機械確認」の前後突合である。提案の採否・実装・固定化・記録はすべて依頼者が行う。issue 起票も本ループはしない。成果物は最終報告だけである。

## 変更禁止の機械確認

走査を始める前に `git status --porcelain` と `git stash list` を記録し、報告の直前に再取得して突合しろ。差があれば自分が汚した分を元に戻し、何をどう戻したかを報告に書け。計器の実行が生成物（キャッシュ・カバレッジファイル・lock の書き換え等）を作った場合の削除・復旧も同じ扱い。追跡対象ファイルの内容を意図して変える操作は、依頼者の指示なしに行うな。**無変化（または復旧済み）の確認結果は最終報告の必須フィールド**——確認せずに「変更していない」と書くな。git が使えないリポジトリでは、確認手段が無い旨と代替（走査前後のファイル一覧・更新時刻の突合）を報告に書け。

## 段ごとに読むファイル

この本文は段（P0〜P4 の工程）の順と読むファイルだけを持ち、手順の中身は持たない。**段に入るたびに、その段のファイルを読んでから手を動かせ。** 会話が圧縮されて前に読んだ手順が見えなくなったら、今いる段のファイルを読み直せ。

`${CLAUDE_PLUGIN_ROOT}` はこのプラグインのフォルダ（このファイル SKILL.md のフォルダの 2 つ上。`.claude-plugin/plugin.json` を持つフォルダ）を指し、この本文の中ではスキルを読み込んだ時にその絶対パスへ置き換わる。下の `references/` はこのファイルと同じフォルダの中にある。別ファイルのコマンドやパスに書いた `CLAUDE_PLUGIN_ROOT`（`$` と波括弧で囲んだ形）は置き換わらず Bash の環境変数にも無いので、そのフォルダの絶対パスに読み替えて使え。

1. 始める前に 1 度: [references/tools.md](references/tools.md)（役の起動方法と渡し方・計器の扱い・守備範囲の外・漏斗と並走の原理）と [references/tree.md](references/tree.md)（根本の木のノードのフィールド・高さ・展開・刈り込み・手詰まりの手筋・提案の重さの 4 段）
2. P0 範囲と厚みの固定: [references/p0-scope.md](references/p0-scope.md)（厚みの三段〔軽量・標準・重厚。どこまで深く走査するか〕と昇格・降格、面積×レンズ、面積の分割、ドメイン地図、先行議論と死んだ試み、ホットスポット）
3. P1 発見: [references/p1-discovery.md](references/p1-discovery.md)（計器、レンズ別の scout と指示、返答の突合、読解の盲点）
4. P2 検証と刈り込み: [references/p2-verify.md](references/p2-verify.md)（判定の語彙、P2a 事実照合、P2b 敵対検証と `judge`〔覆せない判定を下す上位の役〕の出動条件、増し掛け、回し直しの禁止）
5. P3 木と一撃: [references/p3-tree.md](references/p3-tree.md)（ノードを張る・領域診断の突き合わせ・上への展開・一撃の計算・3 票・構成変更級）
6. P4 ラウンドと飽和: [references/p4-saturation.md](references/p4-saturation.md)（2 ラウンド目以降の規律、飽和の三条件、抜き取り検査、cartographer〔走査に要る観点を別に挙げ、被覆の欠けを突き合わせる役〕、止める条件と暴走ガード）
7. 厚みが重厚のとき（P0 で決める。P1 と並走）: [references/heavy.md](references/heavy.md)（独立再導出と模範照合）
8. 無人で走るとき: [references/unattended.md](references/unattended.md)（人に諮る〔確かめる〕事態の読み替え）
9. 最終報告: [references/report.md](references/report.md)（段ごとの減免〔厚みに応じて省く手順〕は p0-scope.md の厚みの三段の表に従うので読み直す。記録の検証、散文だけの義務、自己検査、cold-reader の報告ゲート、型〔このループの手順〕への還流）
10. 型の由来や限界を確かめたいとき: [references/origins.md](references/origins.md)

1 ラウンド＝P1→P3 の 1 周。P4 の判定で次のラウンドか最終報告へ進む。

## 反パターン（自分の走査に見つけたら、走査のやり方をその場で正せ）

- **変更を適用する**（1 行でも）。→ 提案に差分例を含めるのは可。当てるのは依頼者。
- **平坦化**（標準・重厚のみ。軽量は表の定義どおり一覧でよい）: 木を組まず候補の一覧で報告する。一撃を印象で選ぶ。個別判定（1 候補ずつの棄却など）を理由に、その候補を束ね〔共通の親を見つけて複数の症状を 1 つの根本にまとめること〕の材料から外す。
- **一覧の水増し**: 弱い候補で件数を稼ぐ。検証を通らないものを「参考」として滑り込ませる。
- **権威の数え上げ**: 「有名」「一線級も使っている」を根拠にする。→ メカニズム＋適用条件。
- **系譜の二重計上**: 複数 scout の同一指摘を独立の証拠として数える。
- **決着済みの蒸し返し**（P0-4〔P0 の 4 つ目の手順。先行議論の突合と死んだ試みの探索。[references/p0-scope.md](references/p0-scope.md)〕を飛ばした走査は必ずこれをやる）。
- **さぼり降格**: 走査を減らすために実行者が自分で軽量を選ぶ、または候補の重さ（採用の費用と後戻りの高さの 4 段。[references/tree.md](references/tree.md)）を下げて増し掛け〔重い候補に足す追加の検証〕を回避する。→ 降格は依頼者指定のみ・重さの引き下げは禁止。
- **検証の相乗り**: 費用を下げるために複数のノードを 1 体の checker・refuter に束ねる。→ 隔離が検証の本体。費用を下げる正しい手段は、面積を絞ることと `judge` の例外駆動（高い役の `judge` は既定では立てず、誤りの損害が高い判定にだけ立てる。出動条件は P2b〔[references/p2-verify.md](references/p2-verify.md)〕）だけである。
- **温度の誤用**（温度＝`git log` で見たその場所の変更の多さ。P0-5 のホットスポット信号）: 誰も触らない場所の判断系候補を上位に並べる。逆に、機械的に安全な候補を温度を理由に見送る。
- **被覆の外を語る**: 「見ていない範囲は健全」。