--- # Claude Code agent definition # Fill in all FILL IN: placeholders. Remove or uncomment optional fields as needed. name: AGENT_NAME # Required. Lowercase letters and hyphens only. Must be unique within the scope. # Duplicate names are silently discarded — no warning is emitted. description: FILL IN: Action-first description of what this agent does and when to invoke it. # Required. The primary signal for autonomous delegation. # Start with a verb: "Reviews...", "Analyzes...", "Generates..." # Include "Use proactively" to trigger automatic invocation. # Be specific about the triggering condition and domain. # Example: "Reviews pull request diffs for security issues. Use proactively after code changes." # tools: Read Bash Grep # Optional. Space-separated allowlist. Omit to inherit all tools from parent. # Use Agent(type1,type2) to restrict which subagent types this agent can spawn. # Omit Agent entirely to prevent this agent from spawning subagents. # Never available to subagents regardless of tools field: # AskUserQuestion, EnterPlanMode, ExitPlanMode, ScheduleWakeup # model: sonnet # Optional. Aliases: sonnet, opus, haiku, fable. Or full model ID. # Omit to inherit from the main session. # Resolution order: CLAUDE_CODE_SUBAGENT_MODEL env var → per-invocation param → this field → session model. # effort: medium # Optional. low / medium / high / xhigh / max. Overrides session effort level for this agent. # maxTurns: 20 # Optional. Integer cap on agentic turns. Prevents runaway on bounded tasks. # memory: project # Optional. user / project / local. Enables cross-session MEMORY.md (first 200 lines loaded at startup). # Auto-enables Read/Write/Edit tools. # isolation: worktree # Optional. Set to "worktree" to run in an isolated temporary git worktree. # Auto-cleaned if no changes are made. # color: blue # Optional. UI color: red, blue, green, yellow, purple, orange, pink, cyan. # background: false # Optional. Set true to force background execution. # source_keys: # - slug-name # Development-only. Add when research sources informed this agent (slugs must match agents/sources.md). # Omit when no research was used. Not a runtime field — silently ignored by Claude Code. # NOTE: hooks, mcpServers, and permissionMode are silently ignored for plugin agents. # Those fields only work in .claude/agents/ or ~/.claude/agents/. --- FILL IN: System prompt body. Write as a direct role instruction. You are a FILL IN: role description. When invoked, FILL IN: primary action. ## Inputs FILL IN: What inputs does this agent expect? (files, context, parameters) ## Process FILL IN: Steps the agent takes. Be specific about ordering if it matters. ## Output FILL IN: What does the agent produce? Format, location, structure.