# Paseka

> Decentralized event-driven AI agent swarm for solo developers. Configure bees via YAML, prompt templates, and bus event contracts (SIGNAL, INSIGHT, MUTATION, VERIFICATION).

Colony work lives in a git repo under `.paseka/`. Machine secrets stay in `~/.config/paseka/<slug>/`. Use the guides below (or the full corpus) to configure roles without reading Go source.

## Agent configuration (start here)

- [Bee role YAML](https://russ-p.github.io/paseka/guide/bee-config/): schema for `.paseka/bees/<role>.yaml` — adapter, prompt_template, command, post_exec, routing, completion
- [Prompt templates](https://russ-p.github.io/paseka/guide/prompt-templates/): `.paseka/prompts/`, text/template context, emit partials
- [Bee event routing](https://russ-p.github.io/paseka/reference/bee-routing/): subscribes / publishes, Reactor, task vs direct dispatch
- [INSIGHT kinds](https://russ-p.github.io/paseka/reference/insight-kinds/): insight taxonomy and `{{.Insights}}` projection
- [Colony layout](https://russ-p.github.io/paseka/guide/colony-layout/): `.paseka/` layout, init, config tiers
- [Architecture overview](https://russ-p.github.io/paseka/architecture/overview/): adapters, worktrees, run IPC

## Full corpus

- [llms-full.txt](https://russ-p.github.io/paseka/llms-full.txt): concatenated agent-config docs for single-fetch context

## Optional

- [Principles](https://russ-p.github.io/paseka/idea/principles/): choreography model overview
- [Glossary](https://russ-p.github.io/paseka/idea/glossary/): bee-language vocabulary
- [CLI](https://russ-p.github.io/paseka/guide/cli/): `paseka bee run` / `bee chat`, event emit
- [Task ledger](https://russ-p.github.io/paseka/reference/task-ledger/): traceId / taskId / agentId
- [Interactive sessions](https://russ-p.github.io/paseka/guide/interactive-sessions/): HITL `bee chat`, SessionAdapter, Ghostty attach
- [Telegram gateway](https://russ-p.github.io/paseka/guide/telegram-gateway/): setup and run `paseka gate telegram`
- [Nuc packs](https://russ-p.github.io/paseka/guide/nuc/): export/import bees and prompts
- [Homelab deployment](https://russ-p.github.io/paseka/guide/homelab-deployment/): server/apiary container, Queen Console, PASEKA_NATS_URL