agent-patterns

Agent frontmatter is YAML metadata in .claude/agents/*.md files that enables dynamic agent discovery. The system scans these files to read frontmatter schemas and dispatch agents across projects based on policy rules.

To create a new agent, add a .claude/agents/*.md file containing valid YAML frontmatter and a body describing its behavior. The frontmatter must satisfy the schema, discovery rules, and tool configuration requirements.

Yes, agent frontmatter patterns document the metadata spec for creating project-specific agents. You configure agent metadata by writing YAML frontmatter that defines discovery rules and tool configurations for your workflows.

The canonical frontmatter schema and discovery workflow provided by this approach helps teams generate and validate agents efficiently. You ensure validation by satisfying frontmatter schema, discovery rules, and tool configuration requirements.

Agent discovery fails when .claude/agents/*.md files lack proper YAML frontmatter or do not satisfy discovery rules and tool configuration requirements. Configuring frontmatter metadata according to the schema enables policy-driven dynamic dispatch.

No specific dependencies are required to support generator workflows with agent frontmatter. Documenting the frontmatter metadata spec and patterns dynamically enables agent creation, configuration, and dispatch across projects.