Документация Pulse
Карта документов — одна во всех главных файлах и на главной wiki GitLab.
| Документ | Что в нём |
|---|---|
| README | что такое Pulse, что умеет сейчас, как запустить |
| Как работать | правила: ветки, MR, модули, журнал, агенты |
| Справочник (вы здесь) | документация пользователя и разработчика (на сайте) |
| Логика продукта | что строим и как всё связано до 1.0 |
| Дорожная карта | версии до 1.0 и критерии |
| Идеи | наисследовано, но не задача: кандидаты в 1.1–1.3 |
| Архитектура | как устроено: схемы C4 — контекст и контейнеры |
| Как рисовать схемы | шаблон C4: уровни, формы, легенда, шаги и страж |
| Модули | модули продукта: версия, стадия, схема, границы, долги |
| Версии всего | версии продукта, облака, сайта, модулей и технологий |
| Технический обзор | всё техническое одной страницей: модули, хранилища, задания CI, сверка |
| Стек | технологии Pulse: версии, где в коде, наши правила и запреты |
| Ссылки | где что живёт: GitLab, Figma, сайт, облако, выпуски, витрины |
| Глоссарий | как Pulse называет вещи: одно понятие — одно слово |
| Решения | почему так: действующие решения |
| Задачи и выпуски | как заводить задачи и планировать версии в GitLab |
| Качество (QA) | как проверяем перед выпуском: кейсы, прогоны, баги, QA-петля |
| Журнал | что делали и почему: запись на файл |
| Правила для агентов | договорённости с владельцем, грабли, выпуск |
Документы устроены по решению 0044: почему — решения (ADR), как устроено — архитектура и схемы в документах модулей (C4; как их рисовать — c4.md), на чём стоит и как этим пользоваться — стек, где что и какие версии — карта выше. У каждого документа справочника — тип по Diátaxis: обучение (с нуля до результата), как сделать (шаги для задачи), справка (точное описание), объяснение (почему так устроено).
Что такое Pulse и что он умеет сейчас — README; куда идём (путь тем десятками, пересобран 12.11.2026; образ 1.0 — самообучающаяся ADE) — дорожная карта.
Справочник описывает main; пометка «с X.Y» в документах — по тегу.
Состояние. Альфа. Версия в main — 0.36.4 (package.json). Последний выпуск по CHANGELOG — 0.36.4 «свёрнутая колонка с проектами, новый проект сразу рабочий, «Терминал здесь», вкладки без лишних заголовков» (16.11.2026). Готовится 0.37.0 «центр управления в окне» — выпуск GitLab.
Что сейчас в ленте обновлений по платформам, этот абзац не знает: он собран по данным выпуска, не живой ленты. Ленту
выкладывает задание CI лента после тега (квитанция — артефакт release-feed/summary.md), живое состояние отдаёт сервер
обновлений: curl -s "https://pulse.avacloude.ru/releases/latest?platform=darwin-arm64&version=0.0.0". Версии модулей, облака, сайта и технологий — Версии всего.
Ещё: совместная работа, измерения проектов.
Справка пользователя
Одна справка — одно состояние (задача 2123): список, названия, типы и «с каким выпуском сверено» берутся из манифеста
src/shared/helpManifest.ts. Из него же сайт строит меню документации, а страж scripts/docs/help-check.mjs в
npm run rules:check не пропускает правку кода под watch страницы без правки самой страницы. Wiki GitLab —
документация разработчика, справку она не копирует.
| Документ | Меню сайта | О чём | Тип | Сверено |
|---|---|---|---|---|
| Как работает Pulse | С чего начать | Общее и проекты, задача → попытка → сессия → ход, два пути, граф, рой, кто решает, расписания — одним рассказом | объяснение | 0.36.0 |
| Установка и обновление | С чего начать | DMG, первый запуск, запросы macOS, мастер, обновления, удаление | обучение | 0.36.0 |
| Быстрый старт | С чего начать | Первые 15 минут: агент → задача → чат и граф → изменения → коммит | обучение | 0.36.0 |
| Задачи и worktree | С чего начать | Доска, «Новая задача», попытки и сессии, чат, изменения, терминал, приёмка, архив | как сделать | 0.36.0 |
| Агенты и модели | Инструкции | Агент по умолчанию и порядок, CLI- и ACP-агенты, локальная модель и GigaChat, варианты агента, окно контекста | как сделать | 0.36.1 |
| Платформы и сборки | Инструкции | Сборки для macOS, Windows и Ubuntu: что работает везде, что только на macOS, песочница, ключи | справка | 0.36.0 |
| Вход, лицензии и кабинет | Инструкции | Вход через сайт, личный кабинет, выдача и отзыв лицензий, что бывает без лицензии | справка | 0.36.0 |
| Лимиты и расход | Инструкции | Виджет лимитов в нижней строке, чип лимита в чате, что съедает лимит, отчёт-передача на другую модель | справка | 0.36.0 |
| Рой агентов | Инструкции | Роли и персоны, состав, запуск на репозиторий, протокол заданий, рой на графе, worktree участников | как сделать | 0.36.0 |
| Совместная работа | Инструкции | Общий проект: подключить коллегу, передать задачу, лента, присутствие, публикация и приёмка | как сделать | 0.36.0 |
| Полный цикл ревью | Инструкции | Контракт задачи с версией требований, замечания, пакет автору, проверки и оценка инспектора, приёмка | объяснение | 0.36.0 |
| Код и приложение в одном окне | Инструкции | Вкладка «Файлы»: worktree задачи или сессии, редактор с контролем версии файла, предпросмотр приложения | как сделать | 0.36.0 |
| Время и стоимость проектов | Инструкции | Дашборд и «Аналитика»: показатели времени и стоимости, откуда берутся, чего продукт не знает | справка | 0.36.0 |
| Контроль | Инструкции | Режим и доверие, карточка разрешения, политики, бюджеты, граница чтения и песочница, аудит | справка | 0.36.1 |
| Инспекторы качества | Инструкции | Кто проверяет работу агентов, шесть осей оценки, порог перед слиянием, сравнение агентов | объяснение | 0.36.0 |
| Память и контекст | Инструкции | Память репозитория, заметки задачи, версии инструкций, сжатие истории под окно модели | объяснение | 0.36.0 |
| Внешние MCP-серверы | Инструкции | Подключение инструментов по Model Context Protocol, перенос из других редакторов, память кода | как сделать | 0.36.0 |
| Команды среды и расписания | Инструкции | Перечень команд для MCP-сервера с квитанциями и журналом; расписания, их история и журнал запусков | справка | 0.36.0 |
| Библиотека | Инструкции | Каталог skills и ролей, установка, свои skills, оценка, сравнение, вариант агента из роли | справка | 0.36.0 |
| Клавиши | Инструкции | Все сочетания по разделам | справка | 0.36.0 |
| Восстановление и рабочий контекст | Инструкции | Реестр запросов и квитанции, причины остановки, «Требует внимания», место после перезапуска | как сделать | 0.36.0 |
| Если что-то пошло не так | Инструкции | Карточка ошибки с кодом, вход, расписание, связка ключей, журнал и отчёт разработчикам | как сделать | 0.36.0 |
| Разработка | Справочники | Стек, команды, тесты, сборка, публикация выпуска, структура кода, хранилища | как сделать | 0.36.0 |
| Агенты изнутри | Справочники | Реестр агентов, встроенный API-агент, рой, память, политики, MCP — как это устроено в коде | объяснение | 0.36.1 |
| GigaChat изнутри | Справочники | Встроенный агент поверх GigaChat API: что известно об API, как устроено, настройки | объяснение | 0.36.0 |
| Коды ошибок | Справочники | Статья на каждый код PULSE-<ОБЛАСТЬ>-<NNN>: что значит, почему, что сделать (решение 0018) |
справка | 0.36.0 |
С чего начать
| Документ | О чём | Тип |
|---|---|---|
| Как работать с задачами в Pulse | Записать, задать свойства клавишами, разбить на подзадачи, связать, начать и довести до приёмки — по мотивам Linear Method и модели 0049 | как сделать |
Инструкции
| Документ | О чём | Тип |
|---|---|---|
| Каталог UI | Готовые блоки интерфейса: превью и правила для человека, инструменты ui_catalog и ui_template для агента |
справка |
| Локальная разработка в Pulse | Как владелец работает в самом Pulse: день, ветки, коммиты, проверки, передача в облако и обратно; режимы работы с исполнителями по датам | как сделать |
| Выпуск: Mac владельца и выкладка в ленту | Кто что делает в выпуске, где что лежит на Mac владельца, проверенный порядок выкладки | как сделать |
| Защита сборки | Что закрыто в сборке (байткод, минификация, фьюзы), чего у Electron не бывает, порядок подписи | объяснение |
| Pulse Mobile | План мобильного приложения для Android и iOS (имя «Pulse Mobile», слово владельца 05.11): подключение к машине по QR, реестр машин. Снято из работы до готового десктопа (слово владельца 21.10.2026); возвращается в 0.50 как в Orca — решение 0056, номер — по дорожной карте | объяснение |
| Pulse Terminal | Терминал уровня Warp внутри ADE: что уже есть, словарь, точки входа, открытые вопросы; план серии — terminal/plan.md | объяснение |
Справочники
| Документ | О чём | Тип |
|---|---|---|
| Логика продукта до 1.0 | Что строим и как всё связано: модель работы, слои модулей, основы качества, путь до 1.0, эталоны каждого модуля | объяснение |
| Реестр идей | Что наисследовано, но не стало задачей: идеи по модулям с источником, размером и меткой 1.1 / 1.2 / 1.3; как идея становится задачей | справка |
| Отзывчивость на больших данных | Замеры по пяти поверхностям окна, исправленные квадраты, что осталось нечинёным и как здесь принято мерить форму роста | объяснение |
| Архитектура интерфейса | Срез до 0.31: целевая архитектура, фазы M0–M8, что сделано; текущее устройство — решение 0049 и план каркаса ux/navigation-2026-10/ |
объяснение |
| Покрытие дизайн-системой | Покрытие продукта Pulse DS по коду и стендам (первичное — 100 %) | справка |
| Карта модулей | Происхождение сгенерированной карты и её проверка | справка |
| CHANGELOG | Версии, что изменилось, «Где остановились» | справка |
| Ссылки | Где что живёт вне кода: GitLab, Figma, сайт, облако, выпуски, витрины claude.ai | справка |
| Глоссарий | Как Pulse называет вещи: понятие → одно слово, запрещённые варианты, где используется по модулям | справка |
| Каталог провайдеров и агентов | Провайдер → агенты → семейства моделей → знак; как Pulse узнаёт агента по способу подключения | справка |
| Интерфейс (UX) | Правила экрана, планы тем и срезы до 0.33: вход раздела | справка |
| Исследования | Срезы по датам: вывод одной строкой и куда он лёг | справка |
Для разработки и происхождение
Не публикуются на сайте (список сайта — манифест справки src/shared/helpManifest.ts). У каждого в шапке тип и кто ведёт.
| Документ | О чём | Тип |
|---|---|---|
| Архив документов | отработанные срезы с историей (ресёрчи, аудиты, планы), перенесённые уборкой docs 05.11.2026 по описи плана пересборки; не правятся | справка |
| Pulse DS для агентов | токены окна в формате DESIGN.md (YAML) — машинный вход для агентов; источник значений — tokens.css |
справка |
| Технический обзор | всё техническое одной страницей: модули с версиями, хранилища, задания CI, с каким выпуском сверен каждый документ; пишет hub.mjs |
справка |
| Как рисовать схемы C4 | уровни C4 и где каждый живёт, шаблон схемы Mermaid с легендой, шаги «изменил устройство → схема тем же MR → страж», пример «до и после» | как сделать |
| Стек | ключевые технологии: версия из lock-файла, где в коде, наши правила, что нельзя и почему, официальная документация; таблицу пишет hub.mjs |
справка |
| Claude Code в репозитории | как работают сессии Claude Code над репозиторием: хуки, скиллы, субагенты, память | справка |
| Карта кода | как встроенный агент узнаёт, где что объявлено, без чтения файлов подряд | объяснение |
| Контекст исходников | локальный индекс рабочей копии и фрагменты кода для встроенного агента | объяснение |
| Перенос настроек | настройки на сервере, чужое изменение — после вопроса | объяснение |
| Приватность | телеметрия и отчёт о падениях: по умолчанию выключено, что собирается и как стирается | справка |
| Протокол телефона | как телефон связывается с машиной; решение, кода нет — снят до готового десктопа (возврат — 0.50), как и Pulse Mobile | справка |
| Пилот на живых агентах | единственный пункт аудита, который не закрыть кодом: долгая задача на настоящем железе | объяснение |
| Границы состояний задач | два потока задач (Pulse и рой 24/7) и чем их состояния не связаны — контракт в документе модуля «Задачи» | справка |
| Подпись для macOS | сборка Intel-приложения и DMG с сертификатом Developer ID, проверка подписи | как сделать |
| Ключ подписи обновлений | где ключ манифестов выпуска и как восстановить его из GitLab | как сделать |
| Хранение установщиков | очистка Package Registry: что удаляется и что никогда | справка |
| Слово владельца | что нравится владельцу и что он отвергает (памятка перед показом работы) и сверка «слово → судьба»: что он предлагал и что с этим стало | справка |
| Журнал до 19.10 | история сессий до 19.10.2026 и разделы, которые правят на месте; новые записи — worklog/ | справка |
Термины
Полный словарь интерфейса — глоссарий (npm run glossary -- find <слово>); модель работы —
решение 0049: задача → попытка → сессия → ход, граф над всем.
- Задача — что нужно сделать. Единица работы; живёт и без кода — завести, обсудить, отложить (решение 0034).
- Попытка — один подход к задаче в своём git-worktree на ветке
pulse/<id>-N; два подхода или два агента — две попытки (в кодеTaskRun). - Сессия — один агент в попытке: в чате Pulse или CLI-агент во вкладке терминала. Их может быть несколько подряд.
- Ход — одно сообщение человека и ответ агента с его действиями: текст, вызовы инструментов, файлы, разрешения.
- Режим и доверие — что делает агент («Спросить / План / Агент») и насколько ему доверяют в «Агенте» («Спрашивать / Правки сами / Полный доступ»; полный — только если разрешён в проекте).
- Агент — программа, которая работает с кодом (Claude Code, Codex, Grok, Kimi Code, OpenCode, любой ACP-агент) либо встроенный агент Pulse поверх модели; список — каталог.
- Модель — то, на чём агент думает: локальный сервер (Ollama, LM Studio, LiteLLM, llama.cpp, vLLM) или GigaChat.
- Инспектор — роль, которая не пишет код, а оценивает чужую работу: сильная модель, оценка по шести осям, находки и корректировка автору.
- Рой — именованный состав ролей (архитектор, аналитик, фронтенд, бэкенд, безопасность, продукт, тестировщик, DevOps), который запускается на репозиторий одной кнопкой.
- Worktree — рабочая копия репозитория на отдельной ветке; у каждой попытки своя.
Справка для пользователя — вход раздела help/: области кодов, правила статей; полный список — ниже.
Справка по кодам ошибок (108): PULSE-AGENT-001 · PULSE-AGENT-002 · PULSE-AGENT-003 · PULSE-AGENT-004 · PULSE-AGENT-005 · PULSE-AGENT-006 · PULSE-AGENT-007 · PULSE-AGENT-008 · PULSE-AGENT-009 · PULSE-AGENT-010 · PULSE-AGENT-011 · PULSE-AGENT-012 · PULSE-AGENT-013 · PULSE-AGENT-014 · PULSE-AGENT-015 · PULSE-AGENT-016 · PULSE-AGENT-017 · PULSE-AGENT-018 · PULSE-AGENT-019 · PULSE-APP-001 · PULSE-APP-002 · PULSE-APP-003 · PULSE-APP-004 · PULSE-AUTH-001 · PULSE-AUTH-002 · PULSE-AUTH-003 · PULSE-AUTH-004 · PULSE-AUTH-005 · PULSE-AUTH-006 · PULSE-CLOUD-001 · PULSE-CLOUD-002 · PULSE-CLOUD-003 · PULSE-CLOUD-004 · PULSE-CLOUD-005 · PULSE-FS-001 · PULSE-FS-002 · PULSE-GIT-001 · PULSE-GIT-002 · PULSE-GIT-003 · PULSE-GIT-004 · PULSE-GIT-005 · PULSE-GIT-006 · PULSE-GIT-007 · PULSE-GIT-008 · PULSE-GIT-009 · PULSE-GIT-010 · PULSE-GIT-011 · PULSE-GIT-012 · PULSE-GIT-013 · PULSE-GIT-014 · PULSE-GIT-015 · PULSE-GIT-016 · PULSE-GIT-017 · PULSE-GIT-018 · PULSE-GIT-019 · PULSE-GIT-020 · PULSE-GIT-021 · PULSE-GIT-022 · PULSE-GIT-023 · PULSE-GIT-024 · PULSE-GIT-025 · PULSE-GIT-026 · PULSE-GIT-027 · PULSE-GIT-028 · PULSE-GIT-029 · PULSE-GIT-030 · PULSE-GIT-031 · PULSE-GIT-032 · PULSE-GIT-033 · PULSE-GIT-034 · PULSE-INSTALL-001 · PULSE-ISSUES-001 · PULSE-ISSUES-002 · PULSE-ISSUES-003 · PULSE-ISSUES-004 · PULSE-ISSUES-005 · PULSE-ISSUES-006 · PULSE-ISSUES-007 · PULSE-MODEL-001 · PULSE-MODEL-002 · PULSE-MODEL-003 · PULSE-MODEL-004 · PULSE-MODEL-005 · PULSE-MODEL-006 · PULSE-NET-001 · PULSE-NET-002 · PULSE-PHONE-001 · PULSE-PHONE-002 · PULSE-PHONE-003 · PULSE-PHONE-004 · PULSE-START-001 · PULSE-START-002 · PULSE-START-003 · PULSE-START-004 · PULSE-START-005 · PULSE-START-006 · PULSE-TERM-001 · PULSE-TERM-002 · PULSE-TERM-003 · PULSE-TERM-004 · PULSE-TERM-005 · PULSE-TERM-006 · PULSE-TERM-007 · PULSE-UNINSTALL-001 · PULSE-UPDATE-001 · PULSE-UPDATE-002 · PULSE-UPDATE-003 · PULSE-UPDATE-004
Задачи: #1207