Firstread Loop

---
description: 書いた文書が、書いていない人に通じるかを、文書を知らない読み役に読ませて確かめる。起動するのは、人が /firstread-loop と打ったときか「工程に回して」と言ったときだけ——AI は自分から起動せず、書いた文書が初見に通じるかを確かめる必要に当たったら人に提案する。集めるのは読み役が詰まった所と文書が答えなかった疑問で、読みやすさの点数は測らない。誤字・表記ゆれの検査は別のツールでやること。
allowed-tools: Bash, Agent, Read, Grep, Glob, Edit, Write
---

# firstread-loop

## このコマンドは何をするか

**文書を書いた本人は、その文書が分かるかどうかを判定できません。**

書いた人の頭の中には、語の意味も、省略した理由も、書かなかったことも全部あります。だから読み返しても引っかかりません。「分かりやすくなった」という感想は、答えを知っている人が問題を見た感想です。

そこでこのコマンドは、**その文書を書いていない読み役**を別に立てて、実際に読ませます。集めるのは「読み役がどこで止まったか」だけです。

あなた（このコマンドを実行する側）の役目は 2 つです。読み役を立てること。集まった詰まりを直すこと。**「もう分かりやすくなった」と判定することはできません。** それができるのは読み役だけです。

流れは 5 つの手順です。

- 手順 1: 用事（読者がその文書を探しに来る理由）を 2〜3 個決め、読み終えた読み役に聞く 4 つの問い（要約・どんな用事で来るか・書いていないこと・前提）への自分の答えを先に書きます。
- 手順 2〜3: 読み役 `reader` を立てて用事だけを渡し、リポジトリの入口から探させて、どこで止まったか・何を推測で埋めたかを報告させます。続けて 4 つの問いを聞き、自分の答えと突き合わせます。
- 手順 4: 集まった詰まりを型（説明が無い・言葉が定義されていない・呼び方が変わる、などのよくある 7 つ）で仕分けて直します。直しは当てる前に `investigator` に叩かせます。当てる前には毎周、導線（用事から正しい文書へ導く入口と置き場の組み立て）の引き金 4 つ（①写しや脇の文書が正本より多く挙がる ②1 つのファイルに役割外の中身が集まりだす ③同じ場所の詰まりを言い換えで塗り直し続けている ④読み役ごとの要約が別の文書群の話になる）を見て、立ったら書き足しを止め、`blind-judge` 2 体に導線そのものを考え直させます。
- 手順 5: 前に読んでいない新しい読み役に読ませ直し、繰り返します。新しい詰まりはゼロにならないので、費用と見合わせてあなたが打ち切ります。

`reader`・`investigator`・`blind-judge` は、このプラグインに同梱の役割エージェントです（Agent ツールの `subagent_type` に `convergence-loops:<名前>` で渡して起動します）。各手順の中身は下の「手順ごとに読むファイル」にあり、最初に読むのは references/collect.md です。

**このコマンドは、その文書の中身を知っている人が回すものです。** 手順 1 で自分の答えを先に書き、読み役の答えと突き合わせるからです。中身を知らないと、ずれているかどうかが分かりません。

## 手順ごとに読むファイル

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

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

1. 始める前に: [references/collect.md](references/collect.md)（読み役から集めるもの 7 つと、集めないもの）
2. 手順 1 準備: [references/prepare.md](references/prepare.md)（用事の決め方、直す範囲の宣言、読み役の設定と前提の線、聞く 4 つと先に書く答え、ファイルの状態の記録）
3. 手順 2〜3 読ませて聞く: [references/read.md](references/read.md)（読み役 `reader` の立て方、塞げる経路と塞げない経路、読み役への指示の文、閉本で聞く 4 つと答えの突き合わせ）
4. 手順 4 前半 仕分け: [references/sort.md](references/sort.md)（報告の吟味、詰まりの 7 つの型、範囲の内と外、足す以外の直し方、読み飛ばしの読み方、回収されなかった疑問）
5. 手順 4 後半 直す: [references/fix.md](references/fix.md)（直す場所の決め方、当てる前に `investigator` に叩かせる検証税）
6. 直しを当てる前に毎周: [references/route.md](references/route.md)（導線の引き金 4 つ、立ったときの `blind-judge` 2 体、渡す判断と当てる直しの線）
7. 手順 5 次の周へ: [references/next-round.md](references/next-round.md)（1 周の決まり、周の記録と `firstread-record.py`、終わりの決め方）
8. 終わるとき: [references/report.md](references/report.md)（最後の報告の 11 項目と、型への還流）

## やってはいけないこと

**この一覧は本文の言い直しです。重複していることを理由に削らないでください。** 本文は読む場所、
ここは**やる直前に見る場所**で、役割が違います。手順 4 の「読み飛ばされた場所をどう読むか」が
「もう本文で読んだから飛ばした（まとめ・禁止事項・限界の宣言）→ 正常です。そのまま」と
決めているのは、この一覧のことです。

- **自分で採点する** ── あなたが読み返して「分かりやすくなった」と結論する。このコマンドが潰そうとしているのは、この 1 点です
- **先に説明してから読ませる** ── 「これは○○の説明です」と前置きする。それ自体が前提を与えています
- **点数で代用する** ── 詰まりが取れなかったので、文字数や単語数を成果物にする
- **読み役のせいにする** ── 「この読み役は理解力が足りない」で詰まりを消す
- **読み役に直させる** ── 改善案を書かせて、それを採用する。読み役は詰まる役です
- **一覧を渡す** ── 対象ファイルを並べて渡す。辿り着けるかの確認が消えます
- **同じ読み役をもう一度使う** ── 直した文書を、前に読んだ読み役に読ませる
- **詰まらなかった読み役に問い直す** ── 「本当に詰まらなかったのか」と聞き返す。読み役は読み終えた記憶から詰まりを組み立て直します。**出てくるのは詰まった事実ではなく、聞かれたから捻り出した申告です**
- **設計の穴を、文章で埋めたことにする** ── 答えが無い疑問に、それらしい説明を書いて片づける。**穴は残ったまま、見えなくなるだけです**
- **足すだけで周を終える** ── 詰まりを全部「説明が足りない」と読んで、書き足して次へ行く。**周を重ねるほど文書が膨らみ、膨らみ自体が次の詰まりになります**
- **行き先を書かずに「範囲外」と書く** ── 直さない判断そのものは正しくても、次に誰が拾うかを書かなければ、**そのまま消えます**
- **詰まりを見てから範囲を狭める** ── 直したくないものが出たので、範囲の方を動かす。範囲は読ませる前に書くものです
- **動線を配置の根拠にする** ── 読み役が流れ着いた場所に書き足す。動線（読み役が実際に辿った道。文書の側が用意する導線とは別）は評価対象の構造の出力で、壊れた構造ほど読み役を集めます。学べるのは入口の事実までです
- **検証税を自分の判断で省く** ── 「今回の直しは自明だから」。直しを書いたあなた（検査される側）が検査水準を決めることになります。省けるのは依頼者が指定したときだけです
- **構造の判断を自分で実行する** ── 改名・移動・入口の付け替えを、このループの中で当てる。**その判断が外れていても、読み役の読みでは見つかりません。** 渡す先は依頼者（このコマンドを頼んだ人）です（例外は [references/route.md](references/route.md) の 3 条件——①リポジトリの明文の規約がその変更を一意に求める ②外したら赤くなる機械検査が在る ③1 コミットで戻せて他の作業へ波及しない——が全部揃うときだけ。「自明に見える」は条件ではありません）

## このコマンドで分からないこと

- **1 人が詰まらなくても、別の人は詰まります。** 読み役を替えて繰り返すのはそのためですが、全員に通じることは保証しません
- **書いてある内容が正しいかは見ません。** 嘘がすらすら書いてあれば、このコマンドは通します
- **誤字・表記ゆれ・言葉づかいの統一は対象外です。** それは別のツールの仕事で、このコマンドの結論を置き換えるものではありません
- **前提知識そのものは埋められません。** 「この技術の入門が必要だ」と分かるところまでが成果で、入門を書くのは別の仕事です