Adding Agents

Agents are markdown files in the agents/ directory with YAML frontmatter.

File Format

Create a new .md file in agents/:

---
name: my-agent
description: >
  When to use this agent. This description drives auto-delegation —
  Claude reads it to decide when to activate the agent.
tools: Read, Glob, Grep, Bash, Write, Edit
model: opus
memory: project
---

System prompt content in markdown...

Frontmatter Fields

Field	Required	Description
name	Yes	Lowercase with hyphens. Used for namespacing.
description	Yes	When to use this agent. Drives auto-delegation.
tools	No	Tool allowlist. Inherits all if omitted.
model	No	sonnet, opus, haiku, or inherit (default: inherit)
memory	No	user, project, or local. Enables persistent cross-session learning.

Best Practices

• Keep the description focused on when to use the agent, not what it does internally
• Restrict tools to the minimum needed (e.g., reviewer should not have Write/Edit)
• Include a ## Reference Documents section pointing to relevant knowledge base files
• One responsibility per agent — if an agent does two distinct things, split it