Субагенты: Explore, Plan, General + кастомные

Проблема которую решают субагенты

Ты просишь Claude прогнать полный набор тестов. Вывод — сотни строк pass/fail. Или ты просишь проанализировать как работает большой модуль — Claude читает 40 файлов, вывод раздувается.

Результат: основной контекст засорён. Claude начинает путаться, ссылается на шум вместо сути.

Решение: субагенты работают изолированно. Делают грязную работу, сжимают результат, возвращают чистое резюме.

Встроенные субагенты

Пример: Explore для разведки

use the Explore subagent to understand how authentication works in this codebase

Что произойдёт:

1. Explore (Haiku) читает файлы, grep-ает связанные функции, строит карту auth-системы
2. Сжимает вывод (сотни строк → короткое резюме)
3. Возвращает основному агенту: "auth использует JWT + refresh tokens, middleware в src/auth/, сессии в Redis"
4. Основной контекст получает сжатую картину, не 40 файлов сырого вывода

Пример: Plan для принуждения к размышлению

use the Plan subagent to think through migrating from REST to GraphQL before we start coding

Plan выдаёт план — без изменений. Ты проверяешь. Одобряешь. Потом реализация.

Кастомные агенты — свой специализированный

.claude/agents/security-reviewer.md:

---
name: security-reviewer
description: Expert code reviewer for security vulnerabilities.
  Use PROACTIVELY when reviewing PRs or before deployments.
model: sonnet
tools: Read, Grep, Glob
---
 
You are a senior security engineer. When reviewing code:
- Flag bugs, not just style issues
- Check for SQL injection and XSS risks
- Look for exposed credentials or secrets
- Check authentication and authorization gaps
- Note performance concerns only when they matter at scale

Ключевые решения дизайна

1. tools: ограничены — аудитору безопасности нужны только Read, Grep, Glob. Не должен писать.
2. model: sonnet — для задач требующих глубины. Для чтения хватает Haiku.
3. description в PROACTIVE-формате — Claude смотрит description и сам решает когда вызывать ("use PROACTIVELY when reviewing PRs").
4. Системный промпт — четкие указания что флагать, а что пропускать.

Вызов

Автоматически: ты говоришь "review this PR for security" → Claude распознаёт контекст, вызывает агента.

Явно: /security-reviewer.

Где хранятся

Готовые паттерны кастомных агентов

Read-only auditor

name: code-auditor
description: Non-invasive codebase audit. Never writes, never modifies.
tools: Read, Grep, Glob
model: haiku

Для обзоров, поиска технического долга.

Test generator

name: test-writer
description: Generates comprehensive test suites for a given module.
tools: Read, Grep, Write, Edit, Bash
model: sonnet

Запускается когда просишь "write tests for X module".

Doc updater

name: doc-updater
description: Keeps README and inline docs in sync with code changes.
tools: Read, Edit, Glob
model: haiku

После крупного рефакторинга — обновляет документацию.

Антипаттерны

❌ Один "универсальный" агент с Read, Write, Edit, Bash, MCP-всем. Не имеет смысла — это просто Claude. Specialized agents работают потому что ограничены.

❌ Opus для чтения — дорого, медленно, без пользы. Haiku читает так же хорошо.

❌ Субагент для быстрой правки — overhead делегирования съест весь выигрыш.

Практика (20 минут)

Задача 1. Explore

В проекте где ты работаешь:

use the Explore subagent to map out the database schema and return a structured summary of all tables and relationships

Посмотри какое сжатое резюме возвращается вместо тебе сырых файлов.

Задача 2. Кастомный агент

Создай .claude/agents/pr-reviewer.md:

---
name: pr-reviewer
description: Reviews PR diff for correctness, edge cases, and test coverage.
  Use PROACTIVELY when user mentions "review PR" or "code review".
model: sonnet
tools: Read, Grep, Glob, Bash
---
 
Review the current diff. Focus on:
- Logic correctness, especially edge cases
- Missing test coverage
- Inconsistency with existing conventions
- Security implications
 
Output format:
## Blockers (must fix)
## Suggestions (nice to have)
## Questions (need clarification)

Сделай какое-то изменение, вызови /pr-reviewer.

Что дальше

Следующий урок: хуки. Способ сделать часть инструкций детерминированными — не "рекомендация которую Claude обычно выполняет", а "обязательное действие которое всегда запускается".