What is an Agent?
An agent is a specialized AI worker defined by a simple markdown file. Each agent has:- Purpose — What the agent does
- Inputs — What it needs to work
- Outputs — What it produces
- Instructions — The prompt and steps
Agent Definition
Agents are defined in.agents/squads/<squad>/<agent>.md:
Why Markdown?
No microservices. No complex infrastructure. Just prompts.- Version controlled — Track changes with git
- Human readable — Anyone can understand and modify
- Portable — Move agents between projects easily
- Testable — Run and validate locally