Skip to content

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 room skill live in the owner's linux repository).
  • 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 save before 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.