plannotator は agent の diff の前に人間のチェックポイントを置く

agent 支援の開発には、物事が良くなるどころか悪くなる瞬間があります。agent がタスクを終え、要約を出し、これで受け入れるかと聞いてきます。あなたはスクロールします。diff は 400 行。ちゃんと読むほうが自分で書くより時間がかかるので、承認します。
plannotator は今週 10,500 スター前後まで伸びているプロジェクトで、その瞬間を直す試みです。コーディング agent に接続し、agent に決めてほしいことがあるときに開く、ローカルのブラウザベースのレビュー面です。計画や文書、diff に書き込みを入れると、そのコメントが agent の次の入力として戻ります。
タグラインは「ループの中にいること」についてです。アーキテクチャが扱っているのはもっと狭くて実用的な話で、人間の注意力を、あってもなくてもいい工程から、正式な工程へ引き上げることです。
どう繋がるのか
あなたの agent を置き換えるものではありません。agent に挿し込まれます。README には Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness、Pi が並んでおり、Inbox は Grok Bot、Muse、Hermes、OpenClaw のような個人アシスタントとも使えます。接続は各 harness のプラグイン、hook、コマンド経由なので、統合の深さはツールによって変わります。
コマンドはおなじみの形です。
/plannotator-review # uncommitted changes
/plannotator-review <github-pr-url> # a pull request
/plannotator-annotate README.md # a file
/plannotator-annotate https://docs.rs # a URL
/plannotator-last # the agent's last message
plannotator inbox # the queue
Codex ではスラッシュコマンドが `!plannotator ...` になるか、パッケージされた skills を使います。計画モードではコマンドは一切不要です。各 harness の hook に配線されているので、agent が計画を書いた時点でレビュー面がひとりでに開きます。この細部は見た目より効きます。呼び出すのを覚えていないといけないチェックポイントは、忙しい日に飛ばされ、その忙しい日こそ必要な日です。
レビューは Git、GitButler、Jujutsu、Perforce、GitHub、GitLab にまたがるので、特定の forge に縛られません。行にコメントし、コードを提案でき、コメントは agent に返り、誰も読まない PR スレッドには残りません。
面白いのは受信箱のほう
単一 agent のレビューは解決済みの問題で、解き方も退屈です。diff を開いてコメントを残す。
Inbox は、多くの人が実際に置かれている状況のためにチームが作ったもので、その状況は複数の agent が同時に走っていることです。ローカルの窓がひとつあって、agent はそこでメッセージ、質問、ファイル、ガイド付きレビューを預け、作業を続けます。質問にはクリックで答え、ファイルに注記し、手が空いたときに送信を押します。その間どの agent セッションも開いたままになりませんし、返信は質問したセッションに戻ります。
この一文が実際のデッドロックを解きます。human-in-the-loop の標準的な形は、agent が止まって待つことです。agent がひとつなら問題ありません。四つになると、あなたがシステムで一番遅いプロセスになり、残り三つはあなたが昼食を終えるあいだコンテキストを燃やします。非同期の受信箱なら、止めておけるのは質問だけで、セッションは動き続けます。
Claude Code、Pi、OpenCode はプラグイン経由で繋がり、返信は次のターンとして届きます。それ以外は MCP 経由で `plannotator inbox mcp` を使います。そして `plannotator inbox --help` は、agent がこのプロトコルを学ぶための文書を兼ねています。小さな設計で効果は大きい。ヘルプ文が統合仕様になっています。
なぜブラウザで、なぜローカルか
ターミナルの diff はコードを読むには十分で、それ以外を読むには向きません。製品仕様、HTML モックアップ、レンダリングされたレポートをページャでレビューするのは目を細める作業で、agent はいまこの三つを日常的に出してきます。ブラウザに描画し、描画結果の上にピンを置いてもらうのが、その種の成果物に正しい面です。

README のプライバシーの節は、この規模のツールにしては異例なほど具体的で、要約で済ませず、中身を引く価値があります。テレメトリはありません。計画、diff、注記、下書き、履歴は既定でローカルに留まります。各画面は読み込み時に GitHub に最新リリースを問い合わせ、この確認は切れません。ローカル Git レビューは、既定ブランチと古いベースラインを検出するために、設定された origin に対して `git ls-remote` を実行することがあり、この問い合わせはレビューを開いたとき、diff を読み込んだとき、base を切り替えたとき、fetch を押したときに走ります。暇なレビューページはネットワークを呼びません。これは多くのツールが出すより強い約束です。
コンテンツがマシンの外に出るのは、ネットワーク機能が必要とするときだけです。URL 注記はページを取得し、GitHub レビューは認証済みの CLI を使い、Ask AI は選んだ質問とコンテキストを設定したプロバイダに送り、共有は暗号文を paste サービスにアップロードします。
ソースコードの上に座るツールとしては、この開示の水準が正しい感覚です。agent ツールの典型的な壊れ方は、親切そうな助手が黙ってリポジトリをサーバに送ることで、ユーザーの唯一の防御は、聞かれる前に境界を書いておくメンテナです。
居心地の悪い含意
このプロジェクトの全部が、agent の仕事の制約はモデルの能力より人間のレビュー帯域にあるという賭けです。
その賭けは正しいと思います。複数の agent を走らせている知人は、一日の大半を読むことに使っています。計画、diff、テスト出力、agent が自分でやったと思っていることの要約。生成の部分は速く、どんどん速くなっています。検証の部分は、人が読んで決める速さで上限が決まります。
二次的な効果にも名前を付けておく価値があります。判断を記録するレビュー面は、判断の記録を残します。plannotator には保存された計画の判断を読み取り専用で見る archive コマンドがあり、注記はデータディレクトリに残るので、ターミナルのレビューとアプリのレビューが一か所に積み上がります。コメント付きの承認済み計画が数百件になると、どの単一セッションにも入っていないものを持ちます。あなたのチームがどう決めるかの記述です。
資産はそこにあります。diff ビューアは誰でも作れます。溜まるのは推論の跡のほうです。
まだ痛いところ
二つあり、どちらも構造的です。
一つ目は、レビューツールが良くするのはレビューであって、レビューと正しさは別だということです。悪いアーキテクチャに対する注記の丁寧な承認は、やはり悪いアーキテクチャの承認ですし、整ったレビュー面は承認を勤勉のように感じさせます。Inbox はとくにキューを空にしやすくし、キューを空にするのと理解するのは別の行動です。
二つ目は、このツールがターミナルだけだったワークフローに、ブラウザ、ローカルサーバ、hook 層を足すことです。壊れるものが三つ増え、hook が壊れるときの失敗は静かです。agent はチェックポイントを通らずに進み、あなたは後で気づきます。
どちらも、買っているものに対しては許容できるコストです。買っているのは人間が立つ場所です。もう一つのやり方は多くのチームが今日やっていることで、チャットのログを読んで、大事な部分がそこに入っていることを願う。
一つだけ試すなら
次に未コミットの変更があるときに `/plannotator-review` を走らせ、三行にコメントしてみてください。言うことがなくても構いません。コメント自体はおまけです。分かるのは、面がレビューのために設計されているときに実際のレビューがどれだけかかるかで、その数字が新しいスループットの上限になります。ほとんどのチームはそれを測ったことがありません。
関連記事
中国製 Android のシステム UI に載った広告を切る、コミュニティ管理のタップ表
システムには触らず、アンロックも書き込みもしない。ベンダーがもともと用意したスイッチを一つずつ倒すだけだ。代償は、この一覧を書き続ける人が要ることにある。
GPT Image 2.6 はトークン単価を据え置き、請求額を上げた
GPT Image 2.6 は 2.5 のトークン単価をすべて引き継ぎながら、1 枚あたりの費用は上がった。仕事の多くが出力トークン側に移ったからだ。11 日目の価格構造は、ランキングより多くを語る。
外から IDM を作り直した人が、触れなかった部分を書き残した
Mister Download Manager は Internet Download Manager の流れを Rust で作り直し、5 倍の速度と 86 言語を掲げる。より興味深いのは、何もコピーせずにどう作ったのかを説明した段落のほうだ。
Rune はエージェントが自分の仕事を検証できるように作られた Rust UI フレームワーク
Rune はヘッドレスで描画し、要素ツリーを出力し、スクリプト化された入力を受け付ける。スクリーンショットでは決して得られない、diff できる信号をコーディングエージェントに渡せる。フレームワークはプレリリースで、プルリクエストは受け付けない。