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

Короткая карта сущностей продукта. Полные определения — в Глоссарии. Разделы с пометкой «для проектов разработки» в пространстве без кода не встречаются.

Организация и участники

Организация — изолированное пространство команды. У неё есть владелец и участники; данные и трафик одной организации недоступны другой. Организацию можно создать и переключаться между ними.

Проект разработки и репозиторий

• Репозиторий — импортированное зеркало вашего внешнего git-репозитория (upstream).
• Проект разработки — проект, который собирает один или несколько репозиториев как источники (repo@branch) и в котором ведётся разработка.
• Коннектор — агент, который вы запускаете в своей сети: подключает git, недоступный из интернета (self-hosted за фаерволом), или избавляет от передачи нам токенов доступа, а ещё запускает у вас интеграции с трекерами и источниками знаний. Подробнее — в разделе Коннектор.

Пространство и источники знаний

• Пространство — рабочее место без кода: вопросы, глубокие исследования и база знаний по документам отдела. Для поддержки, продаж, юристов, HR, финансов, маркетинга, руководителей, продактов и аналитиков; в проект разработки не превращается. Область прав и записей — как проект. См. Пространство без кода и дорожку Buff без репозитория.
• Источник знаний — подключение, через которое ИИ-агент читает документы там, где они лежат: Notion, Confluence, Google Диск, файлы на сервере и сетевые папки, Figma, при желании — интернет. Ничего не копируется заранее: читается только то, что понадобилось для ответа, и только в области подключения: в отмеченных разделах, а если ничего не отмечено — в том, что открыто учётной записи (у интернета пустые списки — весь публичный интернет, см. Интернет). См. Источники знаний.
• Вопрос («Спросить») и исследование — единицы работы в пространстве: ответ в диалоге со ссылками на документы или выверенный документ, где второй агент сверил каждое утверждение с источниками. См. Вопрос или исследование?.
• ИИ-агент только читает документы; пишет он ответ, документ исследования и записи в базу знаний. Систему, которой нет в каталоге подключений, компания подключает своим инструментом.

Интеграция и подключение

Коннектор — ещё и хост интеграций, и здесь важны два разных слова:

• Интеграция (плагин) — это код: подписанный комплект из каталога, который коннектор скачивает и запускает у себя. Одна интеграция на систему: трекеры — Jira (Data Center, Server и Cloud), GitLab, GitHub, Gitea и Forgejo, Bitbucket (Data Center и Cloud — обращения в pull request), Redmine; источники знаний — Confluence, Notion, Google Диск, Figma, файлы на диске и сетевые папки; интернет. Помимо каталога коннектор запускает и свои MCP-серверы.
• Подключение — это связь с конкретной системой: адрес, учётные данные, список репозиториев или проектов и проект разработки (или пространство), куда попадает работа. Две Jira — это два подключения одной интеграции, с разными секретами и разными правами.

У подключения есть слаг — короткое имя, выведенное из названия. Он попадает в имена инструментов, которые видит модель, поэтому jira_prod и jira_sandbox читаются лучше, чем два jira.

Задача и её жизнь (для проектов разработки)

Задача проходит путь: постановка → проработка/формулировка → декомпозиция на атомы (подзадачи) → разработка по волнам → ревью → публикация. На ключевых точках работу продолжает человек: согласует план перед стартом и одобряет результат.

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

Атомы и волны (для проектов разработки)

При декомпозиции задача разбивается на атомы — наименьшие независимо собираемые единицы. Атомы выполняются волнами в порядке зависимостей; это видно на Схеме выполнения.

База знаний

То, что организация знает о себе, отдельно от кода и от отдельной задачи: правила работы, факты о проекте и ловушки окружения. Записи ведёт человек, а модель их читает на всех этапах и пополняет сама по итогам законченной работы. Это то, что переживает конец задачи: без неё каждая следующая задача начинается с чистого листа. См. База знаний.

Ревью и замечания (для проектов разработки)

Готовые изменения проходят ревью: диффы, обсуждение и замечания (от модели и от вас) с решением «одобрить» или «на доработку». После одобрения открывается pull request в исходном репозитории.