Paseka documentation
Docs are grouped by immersion depth. Feature specs under specs/ are not published on the site; see Specs index.
Idea & principles
| Document |
Description |
| Principles |
Choreography model, contracts, honey, HITL, colony vs machine |
| Glossary |
Bee-language vocabulary and domain terms |
| Brief (RU) |
Historic product brief (concept, EDA, stack, HITL) |
Using Paseka
| Document |
Description |
| Colony layout |
.paseka/ vs machine-local config, slug, paseka init |
| CLI |
Queen Shell (paseka) command reference |
| Forage Cues |
Named ingress shortcuts (.paseka/cues/), CLI, Console, Telegram |
| Bee config |
Bee role YAML schema, adapters, routing fields |
| Prompt templates |
.paseka/prompts/, text/template, partials |
| Interactive sessions |
HITL bee chat, SessionAdapter, Ghostty |
| Telegram gateway |
Setup and run paseka gate telegram |
| Nuc packs |
Export/import portable bee + prompt packs |
| Homelab deployment |
Server/apiary container, Queen Console, reuse NATS |
Reference
| Document |
Description |
| Bee routing |
subscribes / publishes, Reactor, task vs direct dispatch |
| Insight kinds |
INSIGHT taxonomy and {{.Insights}} projection |
| Task ledger |
traceId → taskId → agentId, task lifecycle |
Architecture
| Document |
Description |
| Overview |
Adapters, run IPC, worktrees, package layout |
Plans
| Document |
Description |
| Changelog |
Shipped features with links to specs and canonical docs |
| Specs index |
Short map of docs/specs/ (bodies stay in the repo only) |
| Backlog |
Deferred work and implementation assumptions |
Russian index: README-RU.md.
Agent index: llms.txt (full corpus: llms-full.txt, generated by scripts/gen-llms-full.sh).