コーディングエージェントに見える協調が必要な理由
- 公開日
- 更新日
Claude Code が機能を実装し、Codex がレビューするときは、共有しているファイル、入力を待っているエージェント、実装による変更を把握する必要があります。Paneflow は、端末とコードレビュー用のツールをまとめた、コーディングエージェント向けのネイティブ端末マルチプレクサです。作業が進んでいる間に内容を確認し、必要に応じて介入できます。
見える協調とは、次の判断に必要な状況を把握できることです。エージェントに回答するのか、テストを待つのか、ファイルを修正するのか、タスクを止めるのか。活動表示は、確認が必要な端末を見つける手がかりになります。その端末の出力とコードを読むことで、何に対応すべきかがわかります。
端末ごとのタスクを把握する
プロジェクトのタブには、エージェント、テスト、開発サーバーを別々のペインで配置できます。複数のエージェントでタブを共有することもできます。テストの失敗とエージェントの説明を並べて読み、必要なら端末の操作を引き継げます。活動の追跡は各エージェントで利用できる連携機能に依存します。端末に動きがないだけでは、タスクが成功したとは判断できません。
ペインと同じくらい重要なのが作業ディレクトリです。同じ checkout にある二つの端末は、同じファイルを編集します。実装するエージェントと、書き込まずにレビューするエージェントなら、この共有が適する場合があります。独立した編集には、別のブランチと Git worktree を使うと、タスクごとに作業ディレクトリを分けられます。それでも、統合時にはブランチを合わせた結果のレビューが必要です。
報告の根拠となる変更を読む
エージェントの完了メッセージは、自分が何をしたと判断しているかを伝えるものです。Changes は、アクティブな checkout のステージ済み・未ステージの変更と未追跡ファイルを HEAD と比較して表示します。diff を確認してから Files でファイルを開けば、端末の隣でコードの文脈を読んだり修正したりできます。
このビューが表示するのはローカルの変更です。コミット後に貢献全体をレビューするには、Changes のガイドで説明するように、ブランチ全体の diff を使います。レビューには、プロジェクトで求められる検証や、複数のブランチを合わせた結果の確認も含まれます。エージェントが動いていないこと、完了報告があること、コードが正しいことは、それぞれ別です。
明示的な権限で出力を共有する
レビュー担当のエージェントが、実装担当のテスト結果を読む必要がある場合があります。そのために、読み取り専用 MCP ブリッジは list_panes、read_pane、search_pane を提供します。エージェントは会話間でテキストをコピーせずに、ペインを探して出力を確認できます。ブリッジは文字入力、プロンプト送信、ほかのペインの操作はできません。端末の出力に指示のような文章が含まれていても、確認対象のデータとして扱います。
CLI は、別途許可された場合にテキストを送れます。paneflow send は事前入力にも scripting 権限か AI free access が必要です。CLI から Enter を押して送信するには、さらに --submit が必要です。ほかの端末の操作権限を与えずに、その出力へのアクセスだけをエージェントに与えられます。
続いている作業に戻る
UI を閉じても、タスクを終了する必要はありません。終了時に Keep sessions running を選ぶと、端末とそのプロセスは別のローカルホストプロセス内で動き続けます。そのホストとマシンが稼働している間は、Paneflow を開き直すと再接続できます。
終了済みの端末を再起動すると、新しい shell が起動します。エージェントの会話を再開するときは、そのエージェントが保存した履歴を使います。どちらも、マシンの再起動やホストのクラッシュ後にプロセスを復元する操作ではありません。セッションの永続化に関するドキュメントは、それぞれの操作が何を保持するかを説明しています。進行中の作業に戻るのか、やり直すのかを判断できます。
ローカルで動く範囲
Paneflow は端末をローカルで実行します。各エージェントは自身のモデル提供元に接続するため、端末がローカルでも、すべてのモデルリクエストがマシン内に留まるとは限りません。デスクトップのテレメトリはオプトインで、端末内容、パス、プロンプトを含みません。PANEFLOW_NO_TELEMETRY=1 は設定にかかわらずテレメトリを無効にします。
Paneflow は GPL-3.0-or-later の自由ソフトウェアです。作業を観察し、操作する手段を提供します。変更がタスクを満たすか、検証が十分か、どの変更を統合するかを判断することは、引き続きレビューの一部です。