agent-development

Create autonomous agents by writing markdown files with YAML frontmatter. Define required fields (name, description) and optional fields (model, color, tools), then write a second-person system prompt that specifies behavior, output format, and boundaries for your plugin integration.

Agent files use markdown with YAML frontmatter at the top containing metadata, followed by the system prompt in the body. Frontmatter must include name and description; optional fields include model, color, and tools. The system prompt uses second-person language and defines processing logic.

Write system prompts in second person that clearly define the agent's task, expected input formats, output structure, and quality standards. Structure the prompt as a logical sequence of instructions, apply least-privilege principles, and test triggers to verify the agent behaves consistently during plugin deployment.

Enforce least-privilege access, maintain consistent color schemes, define clear operational boundaries, and establish testing triggers before deployment. Document prerequisites and constraints so plugin consumers understand scope limitations and expected agent behavior.

Yes, the optional model field in YAML frontmatter lets you specify the Claude model version. Include this in your frontmatter along with other optional fields like color and tools to customize agent behavior and appearance for plugin integration.

Tools and colors are optional fields in frontmatter. Define tools if your agent needs access to external functions, and specify color for visual consistency in the Claude Code plugin interface. Both are configuration best practices for complete agent setup.