agent-developmentlisted

# Agent Development Guide How to author a Claude Code subagent that loads, auto-delegates, and runs with the right tools. Ground every new agent against the 33 real agents in this plugin (`agents/*.md`) — copy a close match and adapt, don't start from a blank file. ## Where agents live - **Plugin agents** (shipped): `plugins/nxtg-forge/agents/<name>.md`. - **Project-local agents** (a user's repo): `.claude/agents/<name>.md`. - **Personal agents** (all your projects): `~/.claude/agents/<name>.md`. An agent is a single markdown file: YAML frontmatter (config) + body (the system prompt). ## Frontmatter — valid fields only ```yaml --- name: builder # REQUIRED. lowercase + digits + hyphens, ≤64 chars. No uppercase, no underscores. description: | # REQUIRED. When Claude should delegate here. Add <example> blocks. Use this agent when ... This includes: ... <example> Context: ... user: "..." assistant: "I'll use the Task tool to launch the builder agent to ..." <commentary>Why builder is the right pick.</commentary> </example> model: sonnet # optional. sonnet | opus | haiku. Omit to inherit the main thread's model. color: green # optional. EXACTLY one of: purple cyan green orange blue red tools: Glob, Grep, Read, Write, Edit, Bash, TodoWrite # optional allowlist. Omit Task for leaf workers. isolation: worktree # optional. Own git worktree for conflict-free parallel file edits. memory: p