週次データ収集ルーチン

今回の実行

• 今日: !date '+%Y-%m-%d（%a） 曜日番号=%u'
• 実行するスキル: $skill（引数で渡されていなければ、下の対応表の該当行を使う）
• 同時実行数の上限: !echo "${CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS:-（未設定）}"（超えた起動は失敗する。孫エージェントは settings.json で禁止）
• サブエージェントのモデル: !echo "${CLAUDE_CODE_SUBAGENT_MODEL:-（親と同じ）}"（環境変数が Agent ツールの model 引数より優先される。自分で指定しない）
• 起動時の予算: !python3 tools/budget.py --report 2>&1 | head -3

上の「起動時の予算」で、トークン（文脈再送）は「未計測」と出るのが正常である。 この行はセッション開始の最初期に
実行されるので、自分の記録がまだディスクに無く、budget.py は自分のセッションを同定できないときは何も答えない
（2026-09-04 20:50 の実行では、当時のフォールバックが同じリポジトリで動いていた別の対話セッションの 44.8M を
拾い、「撤退の手順に入ってください」を文脈の先頭に載せた。モデルはそれに従ってサブエージェントを1体も起動せず、
検索0回・取得0回で9分で終えている。docs/routine-postmortems.md）。
起動時の表示だけを根拠に撤退しないこと。 撤退の判断に使うのは、調査を始めたあとに自分で叩いた
python3 tools/budget.py --report の値である。

日付と曜日を自分の暗算で決めない。 上の行はシェルの date が出したもので、この文章が届いた時点で既に確定している。
（2026-08-29 の無人実行は、モデルが当日を「金曜日」と暗算し間違え、本来 other 行が適用されるべき土曜日に
kanto-live-collector を実行してしまい、会期を残したフェスを ended として消す事故につながった。
docs/routine-postmortems.md）

曜日 → スキル・モデル・同時実行数の対応表

# 曜日(date +%u: 1=月 2=火 3=水 4=木 5=金 6=土 7=日) スキル 親モデル 同時実行数 子モデル
3      kanto-event-collector sonnet 3 sonnet
4      kanto-movie-collector sonnet 2 inherit
5      kanto-live-collector  sonnet 3 inherit
other  kanto-event-collector sonnet 3 sonnet

この表が唯一の正本である。 claude-routine.sh はこのブロックをそのまま読んで ROUTINE_SKILL・--model・
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS・CLAUDE_CODE_SUBAGENT_MODEL を決めており、独自の対応表は持たない。
曜日を増やす・組み合わせを変えるときは、この表の行を編集するだけでよい（シェルスクリプト側の変更は不要）。

親と子でモデルを分ける。 5列目が子（サブエージェント）のモデルで、inherit は親と同じという意味である。
親の仕事は「棚卸し・分割・起動・追記・検証」——規則を落とさずに指示を組み立てることが成果を決めるので、
ここを弱いモデルにすると被害が全工程に及ぶ。2026-09-02 の events は親も子も Haiku で走り、親が
skill_brief.py の抜粋を貼らずに自作の1〜2KBの指示に要約した結果、価格の列が指示から丸ごと落ちて
新規90件の price_official が0件になった（docs/routine-postmortems.md）。子の仕事は
「渡された名簿のURLを開いて行を書く」で範囲が狭く、抜粋という手順書も付くので、Haiku で足りる
（この判断自体は変えていない）。

2026-09-22時点、events の子は一時的に Sonnet にしている。 movies・lives の子は既に Sonnet で
毎週動いており、実コストが$1.64〜$7.93の幅で同じサブスクリプションの範囲内に収まっている実績がある
ため、events も同程度に収まると判断したための変更である（詳細は docs/DESIGN.md 第9.3.8節）。
費用面の懸念が無いと分かれば、上の表の sonnet（子のモデル列）を haiku に戻す想定でいる。

無人実行では、この表からスクリプトが決めた値が既に --model と環境変数で渡されている。自分で選び直さない。
特定のスキルを試したいときは、weekly-collect.yml を workflow_dispatch で手動起動し、routine_skill 入力に指定する
（表より優先する。表に無いスキル名を渡すと起動時にエラーで止まる）。

対話セッションで手動実行するときは --model も ROUTINE_SKILL も渡らないので、実行するスキルは対話の指示に従い、
指示が無ければ上の表の該当行（無ければ other 行）を使う。other 行は対話セッション専用の既定である。
claude-routine.sh（定期実行・手動の workflow_dispatch）は、定期実行の曜日以外に routine_skill を選ばずに起動された回を、
other 行に落とさずに起動時に止める（2026-09-26・27 の手動起動が「(自動選択)」のまま events に落ちたため）。判断には冒頭に注入された曜日番号を使う。

前提 —— git はスクリプトの責任

git の書き込みは行わない（.claude/routines/invariants.md の規則。PreToolUse フックが実際に拒否する）。

• 実行前: スクリプトが git fetch と fast-forward マージで最新を取り込んでから、あなたを起動している
• 実行後: スクリプトが validate_data.py と diff_data.py を回し、どちらも終了コード0のときだけ コミットして push する
• 検証に通らなかった回は、生成物を .claude/logs/failed/ に退避したうえで data/ と docs/ を実行前の状態に戻す。
  つまり途中で終えた週は、その週の収集がまるごと失われる

したがってあなたの仕事は、「検証を通る状態のCSVを作り、終了工程まで通し切ること」 に尽きる。

手順

1. 手順書を読む

temp/brief-parent-<events|lives|movies>.md を Read する（claude-routine.sh が起動前に作っている）。
これは .claude/skills/<スキル名>/SKILL.md から行の書き方（列の表・キーの一覧・深掘りの手順）だけを外した抜粋で、
親の工程（終了工程・撤退の手順・初期化・波の分け方・品質チェック・実行手順まとめ）は丸ごと入っている。
全文はまるごと親の毎ターン再送される固定費になる（サイズは
python3 tools/skill_brief.py <ds> --for parent --out /dev/null 実行時にstderrへ出る。
本文の版で動くのでここには固定しない）。親は行を書かないので、子の材料まで運ぶ
必要が無い（抜粋で概ね4〜5割減る）。

• 抜粋に無い規則（列の書き方・キーの一覧など）が要るときは、全文の該当節だけを Read の offset 指定で読む。全文を読み直さない
  （offset / limit の無い全文の Read は PreToolUse フックが拒否する。節の位置は grep -n '^#' <path> で引ける）
• 抜粋が無い（対話的な実行など）ときだけ、python3 tools/skill_brief.py <ds> --for parent --out temp/brief-parent-<ds>.md で作る。それも失敗するなら .claude/skills/<スキル名>/SKILL.md を Read する
• 正本はリポジトリ内の .claude/skills/<スキル名>/SKILL.md 1箇所だけである（抜粋はそこから毎回生成される派生物）

2. 「実行手順まとめ」の最後の項目まで実行する

• 調査（探索・深掘り）は、予算切れ・コンテキスト逼迫・情報源への到達失敗などを理由に打ち切ってよい
• ただし「完走条件」にある終了工程は、どんな理由で打ち切っても必ず全部通す
• 打ち切る場合は「撤退の手順」に従う。前回行は着手直後（ステップ0の --carry-rest --apply）に書き戻してあるので、持ち越しのための作業は要らない——子が報告した中止の行（temp/dispose-<ds>-*.jsonl）と、表記が変わった組を片付けてから終了工程に入る

残りは python3 tools/budget.py --report で見る。ただし時間で判断しない。
枠は6時間あるが、実行を止めているのは一度も時間ではなく、アカウントの利用上限（トークン）だった。
見るのは**[利用率] の行**（サブスクリプションの実際の5時間枠・7日枠。claude-routine.sh が数分おきに測る）で、2段階の線がある。

• 5時間枠80%・または7日枠が「後の回の分を残す線」「新しい波を投げないでください」→ 動いている波を受け取って書き切り、終了工程へ
• 5時間枠92%・または7日枠96%「撤退の手順に入ってください」→ 新しい調査はやめ、終了工程だけを通す

利用率が読めないときだけ、代わりに文脈再送の線（45Mで新しい波を止め、60Mで撤退）を使う。

波を投げる前に必ず見ること。 投げてしまうと、動いている子に割り込む手段が無い。
新しい波の線を越えた状態で Agent を起動しようとすると、agent-guard.sh が拒否する。
波の途中でも、撤退の線を越えた取得は fetch-budget-guard.sh がその場で止める。
逆に線に届いていないうちは、時間が余っているかどうかに関わらず畳まないこと。

打ち切ってよいのは「調べ始めたあと」だけである。 一度も外を見ないまま終えた回は、
tools/run_gate.py が検証工程で落とす（検索0回・取得0回、または append_rows.py <ds> --init を
通っていない回）。落ちるとコミットされず、その週の生成物は .claude/logs/failed/ に退避される。
temp/ に前回の回のJSONLが残っていても、それは今回の収集ではない——回収して追記するだけで
終えないこと（2026-09-04 20:50 の実行がそれをやり、先週の87行と中途半端な77行が
「週次データ更新」としてコミットされた。docs/routine-postmortems.md）。

3. 波の分け方

サブエージェントの起動規則そのもの（前景起動・書き切り・親は取得しない）は
.claude/routines/invariants.md にある。ここではその上で、1回に背負わせる範囲を決める。

• 1回の呼び出しに、調査軸1つの全体を背負わせない。 名簿の一部・対象期間の一部などに区切り、
  波（同時に起動して同時に受け取る1組）に分けて呼ぶ

• 子に SKILL.md を読ませない。抜粋をファイルで渡す。 波を投げる前に1回だけ実行する。

  python3 tools/skill_brief.py <events|lives|movies> --out temp/brief-<events|lives|movies>.md

  指示に貼らない。「まず temp/brief-<ds>.md を Read し、そこの規則に従うこと」という1文だけを書く。
  貼る形は親に「抜粋ぶんの出力トークン × 体数」を払わせ、払えないと判断した親は自作の要約に逃げる
  ——2026-09-02 の events はそれで価格の列が指示から丸ごと落ちた。
  抜粋のパスへの参照が無い波は agent-guard.sh が拒否する。

• 波は subagent_type: "kanto-collector-worker" で起動する。 事前定義したエージェント
  （.claude/agents/kanto-collector-worker.md）で、maxTurns: 60 が入っている。
  general-purpose で投げると——subagent_type を書かないと既定でそうなる——この上限は効かない。
  指定の無い波は agent-guard.sh が拒否する。
  モデルは定義に書いていないので、これまでどおり CLAUDE_CODE_SUBAGENT_MODEL が決める

• 1体が回るターン数は60でハーネスが打ち切る。 1つの文脈でN回呼ぶと入力はNの2乗で増えるので、
  担当範囲を小さく割るだけでトークンが減る（実測の係留点 167ターン＝33.6M を3体に割ると 15.8M）。
  波を受け取ると PostToolUse フックが budget.py --report（「最長の子◯ターン」を含む）を
  その場で差し込むので、次の波の分け方はその数字で決める。
  打ち切りは範囲の途中でも起きるが、子には「1件書けるたびに temp/rows-*.jsonl へ追記する」と
  指示してあるので、そこまでの成果は残る。残りは次の波に回す（前回行はステップ0で既に書き戻してあるので、調べ残しても消えない）

• 1体に渡す範囲の大きさは、スキルの抜粋に具体的な上限がある。 maxTurns は上から止めるだけで、
  入る大きさに割る仕事は親が先にやる。上限はスキルごとに違う——実測の単価が1桁違うためである

  スキル	1波の1体に渡す上限	実測の単価	推定ターン数
  events	20〜25施設	1.0〜1.5 ターン/施設	30〜38
  movies	前回 tier A/B 15件	2.78 ターン/行	42

  どちらも60ターンに対して18〜30ターンの余裕を残してある。余裕は無駄ではない
  ——会場の通信障害（DNS不通・SSL証明書不一致・タイムアウト）の連鎖だけで、
  2026-09-04 の lives は1体が141ターンまで膨らんでいる

• worktree 隔離は使わない（書き込まないので隔離する対象が無く、名簿の更新まで破棄される）

前景で起動していても、1回の呼び出しが長時間に及ぶ設計なら同じように全損する
（docs/routine-postmortems.md の 2026-08-20、docs/COLLECTION-PROTOCOL.md 第11.3節）。
区切るのは起動の形だけでなく、1回に背負う範囲でもある。

4. CSVが更新されたことを確認する

wc -l data/<events|lives|movies>.csv          # ヘッダー1行だけなら、まだ何も書けていない

ヘッダーだけの状態（--init した直後の状態）で終わらせない。

CSVを Read で開かないこと。 data/events.csv は406行しかないので Read の行数上限に一度も触れず、
18万文字が丸ごと文脈に入って以後のターン数だけ再送される。確認に要るのは行数だけで、
中身が要るときは python3 tools/prev_rows.py <ds> --worklist か --uid <uid> で引く。
PreToolUse フックが実際に拒否する。

5. 検証を通す

先に、子が書いた temp/dispose-<ds>-*.jsonl（今回の波のぶん）を python3 tools/prev_rows.py <ds> --dispose に通す——前回行はステップ0で全部書き戻してあるので、子が中止を確かめた行も、これを通さない限り公開され続ける。

そのうえで python3 tools/diff_data.py と python3 tools/validate_data.py を実行し、どちらも終了コード0であることを確認する。
落ちた場合はその原因を解消してから終える。ここが通らないと、今回の成果は保存されない。

diff_data.py の出力を head/tail/grep で切らない（PreToolUse フックが拒否する）。[表記が変わった可能性] は [新規] の一覧の直後に出る。
該当ペアがあれば、次の形で renamed として処理する（ステップ0で前回行を全部書き戻しているので、放っておくと旧行と新行の両方が公開される）
（--status / --to という個別フラグは無い。JSONL を標準入力で渡す）。

python3 tools/prev_rows.py events --dispose <<'EOF'
{"uid": "<旧uid>", "status": "renamed", "to": "<新uid>", "note": "表記が変わった"}
EOF

なお --worklist の一覧に出るタイトル・会場名は表示用に切り詰めてあり（末尾が …）、そのまま新しい行として
書き戻すと append_rows.py が拒否する。正しい表記は tools/prev_rows.py <ds> --uid <uid> で引き直すこと。

• 説明のない消滅があると落ちる → tools/prev_rows.py <events|lives|movies> --dispose で理由を記録する
• 収穫が0件（新規・変更・消滅がすべて0）でも落ちる → 調査結果を append_rows.py で書き切っていないか、
  前回のCSVをそのまま復元して終えようとしている

6. 報告して終える

python3 tools/report_stats.py で充足率と分布を出したうえで、SKILL.md が求める報告を出力する。次の3つは必ず含める。

• python3 tools/report_stats.py の出力（件数・中核列の充足率と前回比）
• python3 tools/budget.py --report --verbose の出力（工程別の消費・残り時間）
• 打ち切った工程がある場合は、どの工程をどの理由で打ち切ったか