agents-subagents

# Claude Code Agents Create and maintain Claude Code agents/subagents with predictable behavior, least-privilege tools, and explicit delegation contracts. ## Quick Start 1. Create an agent file at `.claude/agents/<agent-name>.md` (kebab-case filename). 2. Add YAML frontmatter (required: `name`, `description`; optional: `tools`, `model`, `permissionMode`, `skills`, `hooks`). 3. Write the agent prompt: responsibilities, workflow, and an output contract. 4. Minimize tools: start read-only, then add only what the agent truly needs. 5. Test on a real task and iterate. Minimal template: ```markdown --- name: sql-optimizer description: Optimize SQL queries, explain tradeoffs, and propose safe indexes tools: Read, Grep, Glob model: sonnet --- # SQL Optimizer ## Responsibilities - Diagnose bottlenecks using query shape and plans when available - Propose optimizations with risks and expected impact ## Workflow 1. Identify the slow path and data volume assumptions 2. Propose changes (query rewrite, indexes, stats) with rationale 3. Provide a verification plan ## Output Contract - Summary (1–3 bullets) - Recommendations (ordered) - Verification (commands/tests to run) ``` ## Workflow (2026) 1. Define the agent’s scope and success criteria. 2. Choose a model based on risk, latency, and cost (default to `sonnet` for most work). 3. Choose tools via least privilege; avoid granting `Edit`/`Write` unless required. 4. If delegating with `Task`, define a handoff contract (inputs, cons...