基本概念
ThreadCells は、ネイティブのコーディングエージェント端末の周囲に構造を追加します。このページでは一度に一つの考え方を導入し、その後で各要素がどう結び付くかを示します。
エージェント
エージェントは、プロンプト、ロール、プロファイル、プロジェクトコンテキストとともに実行されるプロバイダー CLI です。ファイルを調べ、ツールを使い、許可されていればコードを書き、結果を返せます。
エージェントは単なるモデル名ではありません。同じモデルを使う二つのエージェントでも、ロール、権限、推論設定、worktree が異なる場合があります。
端末
端末は、エージェントが実行される実際の tmux ベースのプロセス環境です。ネイティブプロバイダーの出力を保持し、ブラウザーを閉じた後にもオペレーターが再接続できます。
端末は永続的な結果を残して終了する場合があります。逆に、端末がまだ存在することは、有用な作業が進行中である証明にはなりません。
セッション
セッションは、関連する一群のエージェント実行についての ThreadCells の永続的なライフタイムです。識別情報、ライフサイクル、端末、プロバイダー、プロファイル、プロジェクト、使用量、結果の関係を含みます。Add Agent は、再利用された表示名から所属を推測するのではなく、その正確なセッションライフタイムに端末を追加します。セッションにより、Statistics とワークフローは、アクティブ、完了、履歴、保持中の実行を扱えます。
プロジェクト
プロジェクトは、作業に対する正規の Git／ソース権限を識別します。セッション、worktree、結果に対して ThreadCells の安定したスコープを提供しますが、登録済みのソースルートは新しい supervisor の通常の書き込み可能 cwd ではなく、Git リモートやリポジトリ権限を置き換えるものでもありません。
管理済み worktree
管理済み worktreeは、限定された書き込み可能コンテキスト用に作成された Git worktree です。プロジェクトに関連付けられた新しい supervisor セッションは、最初のセッションを含めて一つずつ受け取ります。同じプロジェクトの独立したセッションは異なるブランチとチェックアウトを使用し、同じコンテキストの recovery takeover は既存の worktree を保持します。
worktree は衝突を減らしますが、セキュリティサンドボックスではありません。エージェントは、OS アカウントが到達できるものすべてに到達できる可能性があります。
書き込み権限
書き込み権限は、特定の作業コンテキストを誰が変更できるかを定めます。ThreadCells はこの所有権を明示的に保つことで、独立してアクティブな二つのエージェントが同じ worktree へ安全に同時書き込みできると誤って扱われることを防ぎます。
レビュアーには読み取りアクセスが必要でも、書き込み権限は不要なことが多くあります。実装を行う開発者には必要です。
プロバイダー
プロバイダーは、ThreadCells を Codex や Claude Code などのネイティブコーディングエージェント CLI に接続します。重要な状態は三つあります。
- ThreadCells にプロバイダーアダプターが含まれている。
- 対応する CLI がランタイムユーザー向けにインストールされている。
- その CLI が起動できるほど健全かつ認証済みである。
Settings にアダプターが表示されることは、外部 CLI がインストールされていることを意味しません。Providersを参照してください。
プロファイル
プロファイルは、再利用可能な起動ポリシーです。プロバイダー／モデルと推論レベルを選択し、指示と能力を提供し、ロールを定義し、エージェントがオーケストレーションに参加する方法を制約できます。
組み込みプロファイルは安全で既知のロールを提供します。カスタムプロファイルは、オペレーターがアプリケーションコードを変更せずにそれらのロールを適応させるためのものです。
スーパーバイザーとワーカー
スーパーバイザーはより大きなミッションを担当します。ミッションを限定されたタスクに分割し、ワーカーに送り、永続的な結果を収集し、レビューを依頼し、いつミッションが本当に完了したかを判断できます。
ワーカーまたは委任されたエージェントは、その限定されたタスクの一つを担当します。ワーカーは親に証跡を報告すべきであり、最上位の結果を暗黙に決定しません。
Owner
↓
Supervisor
├── Developer ── implementation result ──┐
└── Reviewer ── acceptance result ──────┤
↓
Supervisor incorporates results
↓
Top-level completion常駐スーパーバイザーは、ワーカーがターンを実行している間も利用可能なままにできます。モデルが現在出力していないときも、その常駐はスーパーバイザースロットを消費します。
ワークフロー
ワークフローは、ミッションまたは委任タスクのための永続的な協調記録です。誰が作業を所有するか、どの論理入力が現在か、結果が配信・取り込み済みか、完了またはオーナー判断が必要かを追跡します。
プロバイダー／モデルターンの完了はワークフローの完了ではありません。スーパーバイザーは一つのターンを終え、後でワーカーの結果を受け取り、同じオープンミッションを続けることがあります。
永続的な結果
永続的な結果は、委任作業によって生成される構造化された完了証跡です。概要、変更ファイル、チェック、リスク、ブロッカーを含められます。ThreadCells は、ワーカー端末が後で退役してもこれを保存・配信します。
配信と取り込みは同じではありません。スーパーバイザーは、実際に結果を使用または評価した後でのみ認識します。
オーナーゲート
オーナーゲートは、次の判断に人間のオーナーが必要なため自律的な継続を停止します。たとえば、公開、新しい外部信頼境界、取り消せない破壊的操作、以前に許可されていない製品判断です。
通常のモデルターンの終了や難しい実装手順は、オーナーゲートではありません。
四種類の容量
ThreadCells は、マシンの異なる部分を制約するため、四つの容量制限を分けています。
常駐スーパーバイザー
最上位スーパーバイザーまたはオーナーは、コールバックを受け取りワークフローを継続できるように利用可能なままです。常駐はアクティブなモデル実行や委任された Work 容量とは別です。
プロバイダー実行
モデルがターンを能動的に生成しています。プロバイダーのクォータ、プロセス制限、ネットワーク活動がこのカテゴリを制約します。
Work コンテキスト
委任されたコーディングコンテキストが現在作業を所有しています。コマンドまたはコールバックを待機していても、worktree と書き込み権限を保持する場合があります。
高負荷実行
ビルド、Chromium 実行、大規模テストスイート、または同様に高負荷なホストタスクが、高負荷スロットを占有します。CPU、メモリ、I/O 負荷がこのカテゴリを制約します。
一人の常駐スーパーバイザーはプロバイダースロットを使わずに待機でき、一人の委任エージェントはプロバイダーまたは高負荷スロットを使わずに Work コンテキストを保持できます。したがって、すべての制限を同時に上げても、ワークフローを速くせずにホストを過負荷にする可能性があります。容量とリソースモデルを参照してください。
完全な例
オーナーがリポジトリ向けにスーパーバイザーを起動します。スーパーバイザーは開発者に管理済み worktree と書き込み権限を割り当てます。開発者はコード生成中にプロバイダー実行を使い、その後プロダクションビルドに高負荷スロットを使います。永続的な結果はスーパーバイザーに戻ります。レビュアーは worktree を読み、ブロッキングな回帰を報告します。スーパーバイザーは別のターンを開始し、開発者に修正を依頼し、両方の結果を取り込み、ワークフローを明示的に完了します。
端末、セッション、worktree、ワークフロー、結果はそれぞれ保持すべきライフタイムと事実が異なるため、別々になっています。
次へ: ワークフローと永続的な結果で、この語彙を運用チュートリアルに展開します。