Основные понятия

ThreadCells добавляет структуру вокруг нативных терминалов агентов программирования. Эта страница поочерёдно вводит понятия, а затем показывает, как они связаны.

Агент

Агент — это CLI провайдера, запущенный с запросом, ролью, профилем и контекстом проекта. Он может исследовать файлы, использовать инструменты, писать код при наличии разрешения и возвращать результат.

Агент — это не просто название модели. Два агента могут использовать одну модель, но иметь разные роли, разрешения, настройки рассуждения и worktree.

Терминал

Терминал — это настоящая среда процесса на основе tmux, в которой работает агент. Она сохраняет нативный вывод провайдера и позволяет оператору переподключиться после закрытия браузера.

Терминал может завершиться, тогда как его сохранённый результат остаётся. И наоборот, существующий терминал не доказывает, что полезная работа всё ещё выполняется.

Сессия

Сессия — это сохраняемый в ThreadCells жизненный цикл одной связанной группы запусков агентов: идентичность, состояние, терминалы, провайдеры, профили, проект, использование и связи с результатами. Add Agent добавляет терминал именно в эту сессию, а не выводит принадлежность из повторно использованного отображаемого имени. Сессии позволяют Statistics и рабочим процессам учитывать активные, завершённые, исторические и сохранённые запуски.

Проект

Проект определяет канонические полномочия Git/исходного кода для работы. Он задаёт ThreadCells устойчивую область для сессий, worktree и результатов; зарегистрированный корень исходного кода не является обычным writable cwd нового supervisor и не заменяет Git remote или разрешения репозитория.

Управляемый worktree

Управляемый worktree — это Git worktree, созданный для ограниченного writable-контекста. Каждая новая supervisor-сессия, связанная с Проектом, включая первую, получает такой worktree. Независимые сессии одного Проекта используют разные ветки и checkout; recovery takeover для того же контекста сохраняет существующий worktree.

Worktree уменьшают число конфликтов; они не являются security sandbox. Агент по-прежнему может получить доступ ко всему, к чему имеет доступ его учётная запись операционной системы.

Полномочия на запись

Полномочия на запись отвечают на вопрос, кто может изменять конкретный рабочий контекст. ThreadCells явно хранит это владение, чтобы два независимо активных агента случайно не считались безопасными параллельными авторами в одном worktree.

Проверяющему часто нужен доступ на чтение, но не полномочия на запись. Разработчику, выполняющему реализацию, они нужны.

Провайдер

Провайдер подключает ThreadCells к нативному CLI coding-agent, например Codex или Claude Code. Важны три состояния:

ThreadCells содержит адаптер провайдера.
Соответствующий CLI установлен для runtime user.
Этот CLI работоспособен и достаточно аутентифицирован для запуска.

Наличие адаптера в Settings не означает, что внешний CLI установлен. См. Провайдеры.

Профиль

Профиль — это многократно используемая политика запуска. Он выбирает провайдер/модель и уровень рассуждения, задаёт инструкции и возможности, определяет роль и может ограничивать участие агента в оркестрации.

Встроенные профили предоставляют безопасные известные роли. Пользовательские профили позволяют операторам адаптировать эти роли без изменения кода приложения.

Координатор и исполнитель

Координатор владеет более крупной миссией. Он может разделять её на ограниченные задачи, отправлять их исполнителям, собирать их сохранённые результаты, запрашивать проверку и решать, когда миссия действительно завершена.

Исполнитель или делегированный агент владеет одной из этих ограниченных задач. Исполнитель должен сообщить доказательства родителю; он не принимает молча решение о результате верхнего уровня.

Owner
  ↓
Supervisor
  ├── Developer ── implementation result ──┐
  └── Reviewer  ── acceptance result ──────┤
                                           ↓
                              Supervisor incorporates results
                                           ↓
                                  Top-level completion

Резидентный координатор может оставаться доступным, пока исполнители ходят по очереди. Его резидентность занимает слот координатора, даже когда модель в данный момент не генерирует вывод.

Рабочий процесс

Рабочий процесс — это сохранённая запись координации для миссии или делегированной задачи. Она отслеживает, кому принадлежит работа, какой логический ввод актуален, доставлены ли и включены ли результаты, а также требуется ли завершение или решение владельца.

Завершение хода провайдера/модели не является завершением рабочего процесса. Координатор может закончить один ход, позднее получить результат исполнителя и продолжить ту же открытую миссию.

Сохранённый результат

Сохранённый результат — это структурированное свидетельство завершения, созданное делегированной работой. Он может включать сводку, изменённые файлы, проверки, риски и блокеры. ThreadCells сохраняет и доставляет его, даже если терминал исполнителя позднее выведен из эксплуатации.

Доставка — не то же самое, что включение. Координатор подтверждает результат только после того, как действительно использовал или оценил его.

Ворота владельца

Ворота владельца приостанавливают автономное продолжение, потому что следующее решение требует человека-владельца — например, публикация, новая внешняя граница доверия, необратимое разрушительное действие или решение о продукте, которое ранее не было авторизовано.

Обычное завершение хода модели или трудный шаг реализации не являются воротами владельца.

Четыре вида ёмкости

ThreadCells разделяет четыре ограничения ёмкости, потому что они ограничивают разные части машины.

Резидентный координатор

Координатор верхнего уровня или владелец остаётся доступным для получения обратных вызовов и продолжения своего рабочего процесса. Резидентность отличается от активного выполнения модели и делегированной ёмкости рабочих контекстов.

Выполнение провайдером

Модель активно формирует ход. Квоты провайдера, ограничения процессов и сетевая активность ограничивают эту категорию.

Рабочий контекст

Делегированный coding context в данный момент владеет работой. Он может удерживать worktree и полномочия на запись даже в ожидании команды или обратного вызова.

Тяжёлое выполнение

Сборка, запуск Chromium, крупный набор тестов или сходная дорогостоящая задача хоста занимают тяжёлый слот. Эту категорию ограничивает нагрузка на CPU, память и I/O.

Один резидентный координатор может ждать, не занимая слот провайдера, а один делегированный агент может удерживать рабочий контекст, не используя провайдер или тяжёлый слот. Поэтому одновременное увеличение всех ограничений может перегрузить хост, не ускорив рабочий процесс. См. Модель ёмкости и ресурсов.

Полный пример

Владелец запускает координатора для репозитория. Координатор назначает разработчику управляемый worktree и полномочия на запись. Разработчик использует выполнение провайдером для генерации кода, затем тяжёлый слот для production build. Его сохранённый результат возвращается координатору. Проверяющий читает worktree и сообщает о блокирующей регрессии. Координатор начинает другой ход, просит разработчика исправить её, включает оба результата и явно завершает рабочий процесс.

Терминал, сессия, worktree, рабочий процесс и результат разделены, потому что у каждого свой жизненный цикл и собственное сохраняемое состояние.

Далее: Рабочие процессы и сохранённые результаты превращает этот словарь в операционное руководство.

Создано и поддерживается Субаевым Русланом при участии сообщества ThreadCells. Открыть репозиторий