---
<!-- Claude Code agent definition
     Fill in all FILL IN: placeholders. Remove or uncomment optional fields as needed.
     Delete template comments before shipping. -->

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: Use when <trigger>. <One capability clause.> Not <thing> -> <name>.
<!-- Required. The primary signal for autonomous delegation, and preloaded into every
     session whether or not this agent is ever used. Three parts, nothing else:
     a trigger clause opening "Use when", at most one capability clause, and a
     boundary clause naming a real sibling skill or agent.
     250 characters is the target, 400 the hard ceiling (ADR-0020).
     Do not open with an action verb ("Reviews...", "Analyzes...") — that rule was
     deleted.
     "Use proactively" is valid HERE and only here: it steers the Claude Code runtime
     to offer this agent unprompted. Add it only if that is what you want. If you add
     it, leave it OUT of the Copilot half of the pair — the phrase does nothing there
     and agent-audit's KyberforgeCopilot.ProactivePhrase grades it a hard FAIL. The
     pair must describe the same job; it does not have to be byte-identical.
     Example: "Use when a diff needs checking for injected credentials before it
     merges. Not prose or style linting -> `lint-runner`." -->

<!-- tools: Read, Bash, Grep
     Optional. Allowlist of tool names: a comma-separated string or a YAML list.
     Restrict it to what the agent actually needs. Omit only when it needs them
     all — omitting inherits every tool from the 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, WaitForMcpServers
     Listing any of them is a finding: agent-audit enforces the flat rule. -->

<!-- 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. -->

<!-- disallowedTools: Edit, Write, NotebookEdit
     Optional. Denylist, applied before the tools allowlist and taking precedence over it.
     Accepts a YAML list or a delimited string; use the comma-separated string form for
     consistency with the plugin-scope agents in this repo.
     Supports mcp__* glob patterns (e.g. mcp__filesystem__* to block all filesystem tools).
     Denies only the tools it names — it does not deny Bash, so an agent that inherits
     Bash can still write via a shell redirect. State read-only intent in the body too. -->

<!-- skills:
       - skill-name
     Optional. Skill names preloaded into this agent's context at startup.
     Different from the source_keys metadata field (which is provenance-only). -->

<!-- initialPrompt: "Start by reading the README."
     Optional. Auto-submitted as the first turn when this agent activates as the main session thread.
     Only set when this agent is intended for main-thread (not subagent) activation. -->

<!-- source_keys:
       - slug-name
     Development-only. Add when research sources informed this agent (slugs must match sources.md at the plugin root).
     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.

<!-- Delegate, don't restate. If an installed skill already owns a procedure this agent
     needs, name it ("invoke `git-commits`") instead of transcribing it — a body that
     restates a procedure an invocable skill owns is an agent-audit FAIL. One job per
     agent. Delete this comment before shipping. -->

## 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.

## Errors

FILL IN: What does the agent do on malformed, missing or contradictory input?
State whether it stops and reports, or degrades to a named fallback — and what it
tells the caller either way. An agent with no error handling invents a recovery,
and an invented recovery is invisible until the output is wrong.