クライアントとエージェントを共有するとは、エージェント、コード、認証情報を自分のマシンに残したまま、外部の特定の人にルームを提供し、プロジェクトのエージェントへの質問、作業状況の確認、成果物の受け取りを行えるようにすることを意味します。適切に行えば、デフォルトで読み取り専用、期間限定、ワンクリックで取り消し可能になります。不適切に行えば、ログイン情報の共有になってしまいます。
これは、代理店、フリーランサー、そして週1回のミーティング以上の頻度で「進捗を確認したい」とクライアントから求められているすべての人に推奨するセットアップです。
全体構成
1クライアント、1ルーム、1エージェント、1ディレクトリ。
- 1つのディレクトリ。
~/clients/acmeにはそのクライアントのプロジェクトのみを配置します。ここに固定されたエージェントは、~/clients/betaや自社のフォルダー、秘密鍵を見ることはできません。 - 1つのエージェント。 誰が見ても間違えないよう、クライアントの名前（例:
acme）を付けます。 - 1つのルーム。 クライアントとあなただけが参加します。あなたの他のルームはクライアントからは見えません。
- エージェントのPlan mode。 質問には回答しつつ、あなたが明示的に決定しない限りディスク上のファイルを一切変更しないようにします。
クライアントにはルームが見え、ルームからは1つのディレクトリが見え、マシン上のそれ以外のすべてには手が届きません。
クライアントができること
- 質問をする：「今週は何が変わったか」「エクスポートに1分かかる理由は何か」「現在のデザイントークンを見せて」。
- タイムラインでエージェントの作業を見守る：どのファイルを読み込んだか、どのコマンドを実行したか、出力の末尾。
- 成果物を受け取る：サマリー、図、エクスポートされたファイル、プレビュー画像。
- ファイルを添付する：バグのスクリーンショット、文言修正のスプレッドシート。
クライアントができないこと
- コードの変更（plan modeの場合）。特定のフェーズでエージェントを
acceptEditsに切り替えたとしても、あなたの承認なしにプッシュ、削除、課金発生、認証情報へのアクセスを行うことはできません。 - ファイルを直接閲覧すること。daemonがアップロードするのはタイムラインのイベントであり、ワーキングツリーではありません。daemonがアップロードするものを参照してください。
- 他のルーム、他のクライアント、またはあなた自身のエージェントを見ること。
- 自身のリスクを伴う操作を承認すること。それらはすべてあなたにルーティングされます。
期間の限定
プロジェクトの期間に合わせてクライアントに常時権限を付与し、終了日にリマインダーを設定します。権限の取り消し（Revoke）、ルームからの削除、またはdaemonの停止は、いずれも即座に反映されます。キューに入っているクライアントからのリクエストはキャンセルされ、実行中のものは完了して履歴に残ります。Inviteリンク自体にも有効期限と最大使用回数を設定できます。
成果物と承認
クライアントがエージェントに「修正をプッシュして」と依頼すると、共有ブランチへのプッシュの段階で停止し、あなたの判断を待ちます。これこそが正しい挙動です。成果物をいつリリースするかを決めるのはあなたです。Approveするか、拒否するか、「読み取り専用で続行」と答えて後で自分で出荷するかを選択します。添付したメモも記録の一部として残ります。
これが置き換えるもの
チェックリスト
~/clients/<name>を作成し、そこにプロジェクトをチェックアウトする。- そのディレクトリに固定したエージェントを
planモードで作成し、クライアントの名前を付ける。 - ルームを作成し、エージェントを追加して、有効期限付きのリンクでクライアントをInviteする。
- 最初のリクエストをApproveする。都度待たせたくない場合は、プロジェクトの期間中は「Allow always」を付与する。
- 席を外している間もルームが機能するよう、daemonをサービスとしてインストールする。
- プロジェクト終了時：権限をRevokeし、メンバーを削除する。履歴はあなた向けに残ります。
よくある質問
クライアント側でアカウント作成は必要ですか？ メールコードまたはGoogleでサインインして招待を承認します。インストールの必要はありません。
2つのクライアントで1つのエージェントを共有できますか？ やめておくべきです。クライアントごとに1つのディレクトリを分けることで、単なる論理的な境界だけでなく物理的な境界を維持できます。
費用はどのくらいかかりますか？ リクエストはあなたのサブスクリプションで実行されます。ユーザーごとの使用量が記録されるため、クライアントの質問にかかったコストを確認し、必要に応じて請求に含めることができます。
エージェントに対する私のプロンプトはクライアントに見えますか？ そのクライアントのルームで行われた内容のみが見えます。同じコードベースに対するあなた自身の作業は、別のルームで別のエージェントを使って行うべきです。
プロジェクト用のルームを用意して、クライアント自身に質問してもらいましょう。ここから始める。
公開日