Документация Paseka¶
Документы сгруппированы по глубине погружения. Спеки фич (specs/) не публикуются на сайте; см. индекс спек.
Если вы здесь впервые¶
Кратчайший путь от идеи к работающей колонии:
- Principles — модель хореографии и идентичность Flight Trail.
- Colony layout — конфигурация проекта и машины.
- Bee config и prompt templates — настройка ролей.
- Первый запуск CLI — NATS, диагностика и запуск работы.
Идея и принципы¶
| Документ | Описание |
|---|---|
| Principles | Хореография, контракты, honey, HITL, colony vs machine |
| Glossary | Bee-глоссарий и доменный словарь |
| Brief (RU) | Исторический продуктовый бриф |
| Self-improving colonies | Idea-заметка: чему колония может учиться на своих trail'ах и где проходит граница между возможностями платформы и методологией, которая их использует |
Использование¶
| Документ | Описание |
|---|---|
| Начать здесь — Colony layout | .paseka/, machine-local конфиг, локальный NATS и paseka init |
| Bee config | YAML роли пчелы, адаптеры, routing |
| Prompt templates | .paseka/prompts/, text/template, partials |
| CLI | Справочник Queen Shell (paseka) и диагностика проблем |
| Interactive sessions | HITL bee chat, SessionAdapter, Ghostty |
| Queen Console | Операторский обзор локального UI, review, sessions, System и Git |
| Forage Cues | Именованные точки входа (.paseka/cues/); опциональная Standing Trail; CLI, Console, Telegram; таймеры/webhook вызывают cue run |
| Telegram gateway | Настройка и запуск paseka gate telegram |
| Nuc packs | Переносимые пакеты bees + prompts |
| Homelab deployment | Сервер/apiary в контейнере, Queen Console, внешний NATS |
| Pull-request delivery | Изолированные trails как PR на origin (defaults.delivery, forge-скрипт, reconcile) |
Справочник¶
| Документ | Описание |
|---|---|
| Bee routing | subscribes / publishes, Reactor, task vs direct |
| Event contracts | Виды SIGNAL, INSIGHT, MUTATION, VERIFICATION и правила авторинга |
| Insight kinds | Таксономия INSIGHT и {{.Insights}} |
| Task ledger | traceId → taskId → agentId, жизненный цикл |
| Adapter launch resolution | Пчела → OS-процесс: слои конфига, params, command, env |
Архитектура¶
| Документ | Описание |
|---|---|
| Overview | Адаптеры, run IPC, worktrees, раскладка пакетов |
| Queen Console design system | UI-контракт для Svelte-консоли: темы, инвентарь компонентов, цвета статусов, hard rules |
| Hive Runtime map | Интерактивная Archify-диаграмма (собирается в docs CI) |
Планы¶
| Документ | Описание |
|---|---|
| Changelog | Сделанное: ссылки на specs и канонические docs |
| Specs index | Краткая карта docs/specs/ (тела только в репо) |
| Backlog | Отложенная работа и допущения реализации |
| UI migration backlog | Отложенные решения по редизайну консоли: битые ссылки, непереходы, неготовые разделы |
Английский индекс: README.md.
Индекс для агентов: llms.txt (полный корпус: llms-full.txt, генерируется scripts/gen-llms-full.sh).
Для контрибьюторов и coding agents: AGENTS.md.