04
抜け漏れ
ほとんど集まっているので、完成したように見える。
実際に起きたこと4件
- 比較サイト
知っている商品が、1つだけ抜けていた
商品の情報を自動で集めて一覧にする作業での話です。一覧はほぼ埋まっていました。
ただ、自分が知っている商品が1つ入っていない。9割方うまくいっていたので、あとで見返すまで気づきませんでした。
自分が詳しい分野だったから気づけました。知らない分野だったら、そのまま「完成」として扱っていたはずです。
- 比較サイト
集めたつもりが、半分も拾えていなかった
レビューを自動で集めていました。集まった数だけ見ていると、うまくいっているように見えます。
でも実際には、まだ半分も拾えていませんでした。取れているものだけを眺めていると、取れていないものの存在に気づけません。
- 比較サイト
「だいたい集まった」と「網羅した」は違う
あとで見返して「今売られているものは全部載っているか」と数えたときに、初めてこの差に気づきました。
だいたい集まった状態から、抜けをゼロにするまでの距離は、想像よりずっと長い。そして抜けは、抜けている側からは見えません。
- データ収集
メニューの文字を本文と間違えて、0件になった
ページの中から必要な部分だけを取り出す処理で、ページ上部のメニューの文字を、本文の始まりだと誤って判断していました。
結果、対象が全部0件になりました。これは0件だったので気づけました。もし中途半端に半分だけ取れていたら、気づけなかったと思います。
見つけにくい理由
9割が正しく集まっていると、残りの1割に目が行きません。しかも「何が抜けているか」は、抜けている側からは絶対に分かりません。
そもそもの原因
集める元のページの作りが、全部同じとは限らないからです。1つでも違う形のページがあると、そこだけ静かに落ちます。
自分で再現してみる
読んで納得するより、1回自分で起こしてみるほうが早いです。これは、こちらが実際にやった手順です。
全12件が載った一覧から、意図的に1件だけ形式の違う行(例:区切り文字が全角)を混ぜたものを渡し、「全部抜き出して表にして」と頼む。出てきた件数が12かどうかを数える。件数を先に言わないこと。
この型を防ぐには
やることは3つです。渡す相手が、それぞれ違います。
① 覚えておくこと
自動で集めたら、自分が確実に知っている10件が入っているかを確認する。全体の正しさは測れないが、抜けは測れる。
② CLAUDE.md に書き足すこと
いつ貼るか
Claude Code の会話に貼る。ファイルは自分で開かなくて構いません
貼るとAIが CLAUDE.md を書き換えます。1回書けば、次の会話からも効きます。
次の決まりを、いま作業しているフォルダの CLAUDE.md に書き足してください。 ファイルが無ければ作ってください。 集めた結果について、次を報告してください。 1. 集めようとした総数と、実際に取れた数、その差 2. 取れなかったものの一覧と、取れなかった理由の内訳 3. 途中でエラーになったが、処理を続けた箇所があればその一覧 これから私が知っている項目をいくつか挙げるので、それが結果に入っているかを1件ずつ確認してください。 守ってほしいこと ・文はそのまま書いてください。言い換えないでください ・すでにある決まりは消さないでください ・似た決まりが既にあれば、書く前に教えてください ・書いたあと、CLAUDE.md 全体をそのまま表示してください
この貼り方が動くか、数えました
上の文をそのまま4種類のAIに3回ずつ渡して、 できあがったファイルを機械で読みました(2026-08-16)。
① 正しいファイルに書いた 12回中 12回
② 前からあった決まりが残った 12回中 12回
③ 文がそのまま入った 12回中 12回
④ 書いたあと、中身を見せた 12回中 11回
落ちた1回は、書けてはいました。「完了しました」とだけ返して、ファイルを見せませんでした(Haiku 4.5)。これがこのサイトの型⑦です。見せてこないときは、「CLAUDE.md を全部見せて」ともう一度言ってください。
Haiku 4.5・Sonnet 5・Opus 5・Fable 5/ 書き方は少し変わります(2文が1行にまとまる回がありました)。 文そのものは12回とも変わっていません。
どのフォルダで作業しても守ってほしいときは、貼る前に、1行目の「いま作業しているフォルダの」を ~/.claude/ に書き換えてください。その場合、作業フォルダの外に書くので、Claude Code が許可を聞いてきます(聞かれたら「はい」を選びます)。※ 書き換えたほうの形は、まだ数えていません。上の12回は、書き換えない状態のものです。
最後の1文が効きます。全体の正しさは確かめようがありませんが、自分が知っている数件が入っているかは確かめられます。
長くなってきたら
型は14個ありますが、まず入れるのは自分が実際に踏んだ型だけで足ります。それでも増えてきたら、.claude/rules/ に置いて「どのファイルを触ったときに読むか」を指定すると、ふだんの分量が減ります。
※ @ で別のファイルに分けても、読み込まれる量は減りません(公式の説明)。分けるのは、自分が直しやすくするためです。
③ 自分で確かめること — いま動いているものが、この型になっていないか
自動で作った一覧を開いて、自分が知っている項目を5つ探してみてください。