Agent guides¶
One page per topic, read on demand. CLAUDE.md stays small and points here, so a session loads only the guide it needs.
- The CLI design: reef, Nereid, Mandate, the commands, legacy commands mapped.
- How the owner works: voice, pt-BR, spoken summaries, the visual companion, the terminal format.
- Rules: the durable rules and the pillars.
- The queue: the board and how issues are registered.
- Layout: where things live in the repository.
- Worktrees: one git worktree per agent run, its name and its cleanup.
- How we work: good enough first, open source first, the languages.
- Issues: GitHub Issues are the backlog.
- Raw data: where the recordings and dumps of the sessions live.
- ADRs: how to write a decision.
- API groups: every new idea starts as an API group (proposed rule).
- Decks: the rules for a deck or an HTML page, from the deck engine, and for screens used from a phone.
- Beach: Glaucus, the messenger between the voice session and the local agent.
- Peers: the other sessions on this repository, and the resources they share (the protocol and the
roomskill live in the owner'slinuxrepository). - Saving tokens: the token practices, their hooks and how to tell whether they worked.
- AI and teams: the AI accelerates, people set the direction and decide (Paulo Caroli).
- The session prompt: rewritten with
/next savebefore every/clear, loaded after it, STALE when not rewritten. - The status bar: each piece of the bar under the prompt, and what the forecast asks of the session.
- Publishing on ghcr.io:
make promote, and the click that makes a new package public.