Skip to content

Agents

Persistent agents live as flat files under src/apothem/agents/ with the <name>.md suffix. Each agent is a research, audit, quality, or orchestration role with its own tool restrictions and system prompt.

Agent File Pattern Model Policy
Codebase Explorer src/apothem/agents/codebase-explorer.md Research host-selected
Convention Auditor src/apothem/agents/convention-auditor.md Audit host-selected
Quality Gate src/apothem/agents/quality-gate.md Quality host-selected
Memory Auditor src/apothem/agents/memory-auditor.md Audit host-selected

Frontmatter contract

---
name: <agent name>
description: <one-line role>
type: agent
allowedTools: <whitelist>
maxTurns: <integer>
version: <semver>
---

Orchestration

Agent deployment, parallel-launch protocol, return-contract enforcement, and isolation discipline live at src/apothem/rules/agent-orchestration.md. The per-subagent dispatch tree lives at src/apothem/rules/agent-orchestration-patterns.md §Decision Tree.