Expertise File Design

Guide for designing YAML expertise files that serve as mental models for agent experts.

MANDATORY: Act-Learn-Reuse Context

Expertise files are mental models, NOT sources of truth. They:

• Accelerate agent execution by pre-loading domain knowledge
• Are maintained by self-improve prompts, not humans
• Validate against the actual codebase (source of truth)
• Have enforced line limits to protect context windows

When to Use