agent structure reference Shipped
What this lens looks for
Agents are .md files in .claude/agents/ with YAML frontmatter; body is the system prompt; frontmatter fields (name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation); tool access via allowlist (tools) or denylist (disallowedTools), mutually exclusive
What its verifier checks
Agent file in .claude/agents/; only recognized frontmatter fields; tools and disallowedTools not both set; permissionMode matches use case; system prompt is focused and unambiguous