How to write a great agents.md

The Core Concept: A Team of Specialists

Instead of relying on one general "helpful assistant," the article recommends creating multiple, highly specialized agents. Each agent has a distinct persona, specific commands it can run, and strict boundaries.

1. How to Create Multiple Agents

You define each agent in a separate Markdown file located in your repository at .github/agents/.

Recommended Agent "Roster"

To improve your workflow, the article suggests building these specific agents:

@docs-agent (.github/agents/docs-agent.md)
- Role: Expert technical writer.
- Job: Reads code in src/ and updates documentation in docs/.

How to write a great agents.md

The Core Concept: A Team of Specialists

1. How to Create Multiple Agents

Recommended Agent "Roster"

2. How to Structure an Agent for Success

A. The Header (Frontmatter)

B. The Persona

C. Project Knowledge (Context)

D. Executable Commands (The "Hands")

E. Code Style Examples

F. Boundaries (The Safety Rails)

3. Starter Template

Summary of Workflow Improvements