Документация 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