Agent Frontmatter Standard

Standard for all .claude/agents/*.md definitions in the federation.

Required frontmatter fields

Field	Required	Convention
`name`	Yes	Character name, title case. Matches federation registry.
`description`	Yes	Format: `{rank} ({pillar}) {process}: {domain keywords}`
`model`	Yes	`sonnet` for all subagents. Never omit.

{rank} ({pillar})   {process}: {domain keywords}

rank: One of the 4 federation ranks — Commander, Captain, Colonel, General
pillar: FORGE, FOUNDATION, FLOW, FIRE, SYNTHESIS. Captains omit pillar.
process: Primary action verb — execute, search, route, audit, assess, plan, revert
domain keywords: Comma-separated domain scope

Examples:

Process	Meaning	Assigned to
`execute`	Performs domain work directly	Most commanders, Jimmy Neutron
`search`	Research, investigation, appraisal	L, Ging, Zepile
`route`	Classifies and routes items	Canary
`audit`	Pipeline health, data quality, scouting	Orochimaru
`assess`	Evaluation, scoring, maturity review	Meruem
`plan`	Architecture, strategy planning	(available for future agents)
`revert`	Rollback, undo operations	(available for future agents)

Field	Convention
`tools`	Commanders: `Read, Write, Edit, Grep, Glob`. Captains: add `Bash, Agent`. WebSearch: ging, zuko, trunks, l-research only.
`permissionMode`	`acceptEdits` for all (inherits from parent).
`maxTurns`	Commanders: 20. Captains: 30.
`memory`	`project` for all (builds institutional knowledge per `.claude/agent-memory/[name]/`).
`color`	By pillar: FORGE=blue, FOUNDATION=green, FIRE=red, SYNTHESIS=purple, Captains=orange.
`hooks`	Per-agent lifecycle hooks (SubagentStop auto-converted from Stop).
`skills`	Preloaded skills for the agent.

Rank	Count	Agent files?	Role
General	1 (Hinata)	No	Orchestrator, sole write authority
Colonel	5 (pillar heads)	No	Pillar-level synthesis, colonel context files only
Captain	4	Yes	Cross-cutting system agents
Commander	~19	Yes	Domain-specific execution