Claude Code の裏で​動く​エージェント・​worktree・​/loop を、運営の​記録で​確かめる:​Anthropic の​変更履歴を読む

原文の情報

この記事は Anthropic が GitHub で​公開している​変更履歴を​当サイトが​読んで​解説した​ものです。​Anthropic の​公式の​翻訳・​要約ではなく、​Anthropic とは関係が​ありません。

文書の名前
Changelog
公開している所
anthropics/claude-code
版の日付
確かめた日

この記事の​下書きには Anthropic の Claude を​使っています。​AI で​下書きし、​原文と​一次資料を​確かめてから​公開しています。​作り方と​決まり

このサイト群は、​Claude Code のエージェントが​調べ物・​サイトの​制作・​公開前の​確認を​分担して​運営しています。​手順の​決まりも、​うまく​いかなかった​ことの​記録も、​リポジトリの​中の​ファイルに​残しています。

この記事では、​Anthropic が GitHub で​公開している Claude Code の変更履歴から、​運営で​使っている​機能が​足された​版を​確かめ、​記録から​数えた​結果と​並べます。 このリポジトリの LICENSE.md は「All rights reserved」​で、使い方は Anthropic の​商用の​利用規約に​よると​しています。 そのため、​変更履歴の​行を​引くのは​最小限にし、​ほかは​日本語で​短く​言い直しています。

3行で​言うと

  1. 変更履歴では、​裏で​動く​エージェント、​worktree で​分けて​動かすこと、/loop による​繰り返しが、​それぞれ別の​版で​足されています。
  2. このサイト群の QA の​記録 161 件のうち、​1 回目から​残っている 157 件を​数えると、​最初の​回で PASS したのは​判定の​読める 155 件中 13 件でした。
  3. 記録に​残る​失敗の​多くは、​新しい​機能ではなく​使い方の​決まり (同時に​動かす数・​止める​プロセス・​検査に​戻す項目) で​直していて、​その​決まりを​書いた​文書が​運営の​中心に​なっている、と​いうのが​当サイトの​見立てです。

この記事を​読む前に

  • サブエージェント:大もとの​会話 (この​サイト群では​オーケストレーターと​呼んでいます) から、​役割を​決めて​起動する​別の​エージェントです。
  • worktree:ひとつの git リポジトリから、​別の​ブランチを​別の​フォルダーに​取り出す​仕組みです。​並行する​作業が、​お互いの​ファイルを​書き換えずに​済みます。
  • /loop:​同じ指示や​スラッシュコマンドを、​決まった​間隔で​繰り返す Claude Code のコマンドです (変更履歴の 2.1.71)。
  • QA:このサイト群では、​作った​人とは​別の​エージェントが、​公開の​前に​中身と​検査の​強さを​確かめる​工程を​指します。
  • 変異テスト:わざと​不具合を​入れて、​テストが​それを​見つけて​落ちるかを​確かめる​方法です。

原文の要点

当サイトの要約

  • 2.0.60 で、​作業を​続けている​間に​エージェントを​裏で​動かせるようになりました。 2.0.60 が npm に​登録されたのは 2025-12-05 (UTC) です。
  • 2.1.49 で、​Claude Code を別の git worktree で始める --worktree と、サブエージェントを​一時的な worktree で​動かす isolation が足され、​2.1.50 で​エージェントの​定義にも isolation: worktree と書けるようになりました。 npm への​登録は、​2.1.49 が 2026-02-19、2.1.50 が 2026-02-20 (どちらも UTC) です。
  • 2.1.59 で、​役立つ文脈を Claude が​自動の​記憶 (auto-memory) に保存するようになりました。​管理には /memory を使います。 2.1.59 が npm に​登録されたのは 2026-02-25 (UTC) です。
  • 2.1.71 で、​指示を​決まった​間隔で​繰り返す /loop と、セッションの​中で​繰り返しの​指示を​予約する cron の​道具が​足されました。 2.1.71 が npm に​登録されたのは 2026-03-06 (UTC) です。
  • 2.1.212 で​ひとつの​セッションが​起動できる​サブエージェントの​数に​上限 (既定 200) が、​2.1.217 で​同時に​動く​サブエージェントの​数に​上限 (既定 20) が​足されました。 npm への​登録は、​2.1.212 が 2026-07-16、2.1.217 が 2026-07-21 (どちらも UTC) です。

当サイトが​足した​もの:​くらべる

変更履歴の​機能と、​この​リポジトリで​近い​ことを​している所

下の表は、​上の​要点の​機能ごとに、​この​リポジトリで​近い​ことを​している​所を​並べた​ものです。

機能 このリポジトリで​近い​ことを​している所
役割を​決めた​サブエージェント 役割の​定義は .claude/agents/ に 7つ​あり (pm・​researcher・​site-builder・​qa-reviewer など)、オーケストレーターは​サブエージェントに、​その​役割の​ファイルを​最初に​読ませます。
裏で動く​エージェント PM の​計画を​受け取ると、​オーケストレーターは​タスクを​役割ごとの​サブエージェントと​して​並行して​起動します。
worktree QA の​前の​新しい​ページは worktree と​ブランチ (feat/<id>) で作り、​QA を​通ってから main に​まとめます。​QA の​前の​ページを main に​置かないためです。
自動の記憶 ユーザーの​決定の​うち手順に​効く​もの (週の​使用率で​回す頻度を​変えるなど) は​記憶の​メモに​置き、​ORCHESTRATION.md からその​メモの​名前で​指しています。
/loop と次の​起き上がりの予約 オーケストレーターは /loop で 1 回分の​手順を​繰り返し、​最後に ScheduleWakeup で次に​起きる​時刻を​予約します。​作業が​続くなら 60〜300 秒後、​ユーザーの​返事を​待つだけなら 1800 秒以上後です。
一回きりの予約 動いている​作業が​無く​次の​予定が​先の​ときは、​1 時間​おきの​空回りを​せず、​その​日時に CronCreate で一回きりの​予約を​置いて​ループを​止めます。
同時に​動く​数の上限 Claude Code の上限とは​別に、​重い​検査 (ブラウザの​テスト・​Lighthouse・​変異テスト) を機械全体で​同時に 2 本までに​する scripts/heavy.sh を、2026-10-12 から​使っています。

Added `/loop` command to run a prompt or slash command on a recurring interval (e.g. `/loop 5m check the deploy`)

(当サイト訳)​/loop コマンドを​足した。​プロンプトか​スラッシュコマンドを、​決まった​間隔で​繰り返し実行する (例:/loop 5m check the deploy)。

出典:Changelog(Anthropic、​2026年11月4日 のコミットの版)

変更履歴の​例は、​決まった​間隔で​配信を​確かめる​使い方です。​この​リポジトリでは​間隔を​決めず、​回ごとに​次に​起きる​時刻を​選んでいます。​待つ​ものが​長いときに、​短い間隔で​空回りしないためです。

当サイトが​足した​もの:​手元で​測った結果

記録から​数えた結果

QA の​記録 (pm/qa/ の Markdown) と、​コミットの​履歴を​数え直しました。​数えるのは​決まった​コミットの​時点の​中身なので、​後から​記録が​増えても、​下の​数は​変わりません。

数えたもの 結果
QA の​記録の​ファイル (CHECKLIST.md を除く) 161 件
途中の​回から​始まる記録 4 件 (前の​回を​上書きした​記録。​最初の​回の​数から​外した)
最初の​回で PASS した記録 判定の​読める 155 件中 13 件 (8.4%)
最初の​回で FAIL した記録 155 件中 142 件
最初の​回の​判定を​手で​決めた​表との一致 161 件中 161 件 (表は​数え方を​直した​後に​作った)。​QA が​先に​手で​見た 22 件では 22 件が一致
自己点検の​決まりの​前と後 前 (2026-10-17 より前に​作った​記録) は 102 件中 8 件 (7.8%)、​後は 53 件中 5 件 (9.4%)
指摘 (F 番号) 51 ファイルの 250 件
検査の​強さと中身 検査の​強さ 120 件 (48%)・​中身 130 件
語の分け方と、​手で​分けた​見本の一致 6 ファイルの 37 件中 30 件。​外れの​うち、​中身の​指摘を​検査の​強さに​数えた​ものが 5 件、​その​逆が 2 件
変異テストの​結果の​書き込み 205 か所に、​合わせて​「4,149 件中 4,113 件を​検出」と​書いてあり、​検出されなかった 36 件も​この​中に​ある。​うち 62 か所は​作業者の​変異の​回し直し。​x/y の​形で​書いていない​検出されなかった​変異 (名前の​列・​「生存 N」・表の​「生き残り」の​列など) は、​この​合計に​入らない
コミット 1,883 件 (2026-10-03〜2026-11-04)。題が QA で​始まる​もの 264 件、​feat・​fix の​ブランチを main に​まとめた​もの 120 件
決まりを​書いた文書 CHECKLIST 89 項目、​AGENTS.md の​学び 350 項目、​役割の​定義 7つ

数えた​時点は、​この​サイト群の​リポジトリの​コミット ccfb53bb (2026-11-04 の main) です。Node.js 26 で​動かし、​git の​中身 (git show と git log) だけを​読みます。

このサイト群の​手元では、​リポジトリの​直下で​次の​命令を​動かすと、​同じ​数が​出ます。

node sites/papa-engineer/scripts/techblog-cc-records.mjs --stdout

数え方

  • 最初の回:記録の​最初の​見出しから、​次の​回の​見出しまでを​最初の​回と​しました。​最初の​見出しが​途中の​回から​始まる​記録は、​前の​回を​上書きしていて​最初の​回の​判定が​分からないので​外しました。​その後の​回の​区切りは、​予定の​見出し (「再 QA で​見ること」など) と​見分けきれなかったので、​回の​数と​平均は​出していません。
  • 判定:その回で​最初に​出る​「判定:PASS」​「判定:FAIL」を​その回の​判定に​しました。​「合格」は PASS、​「不合格」​「失敗」は FAIL に​数え、​判定の​行が​読めない回は​どちらにも​数えていません。​記録の​頭に​最後の​判定を​まとめた​形 (「判定:PASS (再 QA…)」の​後に​最初の​回の FAIL を​書く​形や、​回を​名指しした​「判定 (N 回目)」) は、​名指しした回の​判定と​して​読みます。
  • 指摘:行の頭が​太字の F 番号の​行を​指摘とし、​同じ​ファイルの​同じ​番号は​最初の​行だけを​数えました。​後の​回の​「直った」の​行を​数えないためです。
  • 検査の​強さと中身:指摘の​最初の​行に​「テスト・​検査・​変異・​素通り・​生存・​見逃・​止めない・​止まらない・​照合・​守っていない・​通る・​通った」の​どれかが​あれば​検査の​強さ、​無ければ​中身 (画面の​文・事実・​計算・​図) と​しました。
  • 最初の​回の​判定の表:数え方を​直した​後で、​全部の​記録の​見出しと​判定の​行を​読み、​最初の​回の​判定と​始まりの​回を​手で​決めた​表を​作って​照合しました。​後から​作った​表なので、​数え方と​別に​確かめた​値と​して​強いのは、​QA が​先に​手で​見た​記録との​一致の​方です。
  • 見本:papa-techblog の記録では、​QA が​回ごとに​「どれが​検査の​強さで、​どれが​画面の​誤りか」を​書いているので、​それを​正解に​しました。​ほかの​記録 (cloudnet・​small-fixes・​links-housoku・​vuln-runtime・​fermi) は、この​記事の QA が​手で​分けた​結果を​正解に​しました。
  • 変異テスト:「何件の​うち何件を​検出」の​形の​書き込みを​足し合わせました。​作業者の​変異を QA が​回し直した​分、​直した​後に​確かめた​分も​入り、​検出されなかった​変異を​名前で​並べた​書き方は​入りません。

分かったこと

1 回目から​残っている​記録で、​最初の​回で PASS したのは​判定の​読める 155 件中 13 件 (8.4%) で、残りの 142 件は​最初の​回で FAIL でした。pm/ORCHESTRATION.md の 2026-10-17 の節は​「1 作業あたり QA が平均 3〜4 回」​と書いています。​この記事では回の​数を​数えていないので、​この​値とはくらべられません。

作業者が CHECKLIST を​全部​通してから QA に​出す決まり (2026-10-17 から) の​前と​後で、​最初の​回で PASS した割合は 7.8% と 9.4% で、この​数え方では​大きくは​変わっていません。​ただし、​後の​時期ほど CHECKLIST の​項目が​増えて QA が​見る​範囲も​広がっていて、​件数も​多くないので、​決まりが​効いたか​どうかまでは​言えない、と​いうのが​当サイトの​見立てです。​指摘 250 件のうち、​検査の​強さ (テストやビルドの​検査が​不具合を​止めない) が 120 件 (48%)、​中身 (画面の​文・事実・​計算・​図の​誤り) が 130 件でした。​手で分けた​見本との​一致は 37 件中 30 件で、​外れは​両方の​向きに​あるので、​検査の​強さの 48% は​目安の​値です。​記録に​「何件の​うち何件を​検出」と​書いた​箇所は 205 か所で、​合わせると 4,149 件中 4,113 件です。​この合計は、​作業者の​変異の​回し直しや​直した​後の​確かめを​多く​含み、​検出されなかった​変異を​名前で​並べた​記録は​入らないので、​変異テストの​検出率と​しては​読めない、と​いうのが​当サイトの​見立てです。

当サイトが​足した​もの:​小さな​チームで​試せること

小さな​チームで​試せること

重い検査は、​機械全体で​同時に​動かす数を​決める

並行する​エージェントの Chrome が​重なり、​8 コアの​機械で​負荷が 49 に​なって、​組み込みに 1〜2 時間かかっていた​ことがあります (2026-10-12)。​それからは​重い​検査を scripts/heavy.sh で包み、​空きが​出るまで​待ってから​動かしています。​枠は​一時フォルダーの​中の​ディレクトリで、​持ち主の​プロセスが​もう​無ければ​空きと​みなします。​それでも 2026-10-27 には、​16GB の​機械が​メモリ不足で​再起動しました。​再開した​後は、​並行する​エージェントを 3 体まで、​重い​検査を 1〜2 本に​絞っています。2.1.290 では、​定期の​起き上がり (/loop) を待っている​裏の​セッションを、​更新や​メモリ不足の​ときも​止めずに​残すように​変わりました。2.1.290 が npm に​登録されたのは 2026-10-05 (UTC) です。

Changed background sessions waiting on a scheduled wakeup (`/loop`): they are now left running through updates and low memory, where being restarted or shut down could silently lose the wakeup

(当サイト訳)​定期の​起き上がり (/loop) を待っている​裏の​セッションを、​更新や​メモリ不足の​ときも​動かしたままに​するよう​変えた。​再起動や​終了で、​予約した​起き上がりが​黙って​失われる​ことが​あったため。

出典:Changelog(Anthropic、​2026年11月4日 のコミットの版)

要点の 2.1.217 の​上限は​サブエージェントの​数を​決める​もので、​それぞれが​起動する​ブラウザや​テストの​数までは​決めないので、​機械に​合わせた​数は​自分で​決める​必要が​ある、と​いうのが​当サイトの​見立てです。​手元の​機械で​一度に​動かせる​重い​作業の​数を​決め、​空きが​出るまで​待つ​仕組みは、​エージェントでなくても、​ビルドの​多い​チームなら​そのまま​使えるはずです。

止めるのは、​自分が​起動した​プロセスだけ

あるエージェントが pkill -f でテストの​ファイル名に​当たる​プロセスを​止め、​並行していた​別の​エージェントの​テストまで​止めたことがあります (2026-10-14)。​待つ処理を pgrep -f で書いたら、​待っている​シェル自身の​コマンド行が​その​文字列を​含むので​自分​自身も​拾ってしまい、​終わらなかったこともあります (2026-10-21)。​テストの​終わりを​待つだけの​裏の​ループを​残したまま​報告を​終え、​それが​数日​動き続けた​こともあり、2026-10-19 には​メモリ不足で 5 体分の​エージェントが​止められました。​今は、止めるのは​自分で​控えた PID だけにし、​待つ​ときは​裏で​動かした​コマンドの​終わりの​知らせを​使い、​報告の​前に​自分の​待ちの​ループと​監視を​全部​止める​決まりです。

動かない​エージェントを、​ファイルの​更新時刻で​見つける

動いているのに、​作業ツリーの​ファイルが 3.5 時間​変わらなかった​エージェントが​ありました (koyou)。​オーケストレーターは​起きる​たびに​作業ツリーの​最終更新時刻を​見て、​60 分以上​動きが​無ければ​止め、​途中の​状態を​コミットしてから​新しい​エージェントに​引き継ぎます。​画面の​表示が​「動いている」でも、​作業の​結果が​増えているとは​限らないので、​結果の​側を​見る​決まりに​しています。

指摘を、​次の​作業の​検査に戻す

QA が​新しい​種類の FAIL を​出したら CHECKLIST に 1 項目足し、​作業者は QA に​出す前に​その表の​当てはまる​項目を​全部​通して、​項目ごとの​結果を​報告に​書きます。​それでも、​ある​作業は QA が 5 回続けて FAIL し (KOUMUIN-bonus、2026-10-28 に公開)、​記録には​「QA の​回が​増える​ほど​「検査の​穴」​探しに​偏る」と​書きました。​今の目安は QA 2 回で、​2 回目に​残るのが​検査の​強さだけなら、​PM が​確かめて​公開します。

言い方を​止める​語の​表は​言い換えで​漏れ続けたので (kanemochi では QA 4 回)、​見える​文を​全部​台帳に​持ち、​台帳に​載っていない​文が​あればビルドを​止める​作りに​変えた​サイトも​あります。​言い方の​表で​止める​作りは、​次の​言い換えで​漏れる​ことを​前提に​しておく方が​安全です。

記録を、​後から​数えられる​形で残す

QA の​記録は​判定の​書き方が​何通りも​あり (「判定:PASS」、​「## 判定」の​次の​行、​「合格」など)、​回の​区切りの​見出しも​「再 QA で​見ること」のような​予定の​見出しと​混ざるので、​この​記事では回の​数と​平均を​出していません。​判定と​指摘の​番号を、​決まった​形で​書いて​おくだけでも、​後から​回数や​種類を​数え直せます。​小さな​チームでも、​レビューで​見つけた​穴を​「次から​機械で​止める​項目」と​して 1​行ずつ足していくと、​同じ​指摘を​何回繰り返したかを​数えられるようになります。

原文を​読む順番

CHANGELOG は​版ごとの​見出し (「## 2.1.318」​のような​版の​番号だけ) の​下に、​Added・​Fixed・​Changed・​Improved などで​始まる​行が​並び、​見出しに​日付は​ありません。​そのため、​この​記事の​版の​日付は、​npm の​登録日 (registry の JSON の time の​欄、​UTC) で​確かめました。​足された​機能を​探すなら、​まず Added で​始まる​行を​機能の​名前で​探し、​その後で​同じ​名前の Fixed の​行を​読むと、​使い始めた​人が​当たった​不具合が​分かります。

出典

確かめた​日は​どれも 2026年11月5日です。

  • Claude Code の CHANGELOG.md(anthropics/claude-code、​コミット 646b7418。​原文。​GitHub から​写して​読みました)
  • 同じリポジトリの LICENSE.md(コミット 646b7418)
  • npm の @anthropic-ai/claude-code の版の一覧​(版ごとの​登録日。​registry の JSON の time の​欄で​確かめました)
  • このサイト群の​記録:AGENTS.md、​pm/ORCHESTRATION.md、​pm/LOG.md、​pm/qa/、​.claude/agents/、​scripts/heavy.sh​(リポジトリは​公開していません。​数えた​時点は​コミット ccfb53bb)

この記事の​表は​当サイトが​作った​もので、​原文の​図・画像は​使っていません。​Anthropic の​ドキュメントの​ページは、​この​記事では​読んでいません。