Agent Design
Agent Design Documents (ADDs) define the specification for AI-powered features and autonomous agents within your system.
When to Write an ADD
- Building a feature that uses LLMs or AI models
- Creating an autonomous agent that can take actions
- Designing a human-in-the-loop AI workflow
- Integrating external AI services (OpenAI, Anthropic, etc.)
Key Sections
| Section | Purpose |
|---|---|
| Agent Persona | Who is this agent? What’s its role? |
| Capabilities | What can it do? What tools does it have? |
| Guardrails | What can’t it do? Safety constraints |
| Evaluation | How do we measure success? |
| Human Oversight | When does a human need to intervene? |