backend-architect — субагент для Claude Code: архитектура бэкенда
Субагент для проектирования бэкенда: границы сервисов, выбор API-парадигмы, схемы БД и наблюдаемость. Полезен, когда решение нужно принять до первой строки кода.
npx claude-code-templates@latest --agent development-team/backend-architectЧто делает backend-architect
backend-architect — это субагент Claude, который занимается проектными решениями, а не реализацией. Он разбирает доменные контексты и владение данными, выбирает парадигму API под конкретный случай, описывает контракты и схемы. Для написания кода по готовому проекту автор советует брать другого агента — backend-developer.
Внутри прописан порядок работы: сначала уточнить bounded contexts, потом проектировать API contract-first, затем считать требования к консистентности данных по каждому агрегату. Отдельный блок про наблюдаемость — структурные логи с trace ID, распределённая трассировка через OpenTelemetry, метрики по методу RED, эндпоинты /health, /ready и /metrics. На выходе — схема сервисов в Mermaid или ASCII, спецификация OpenAPI 3.1 либо Protobuf IDL, схема БД с индексами и шардированием, список узких мест и режимов отказа.
Агент умеет читать и править файлы, запускать команды и искать по репозиторию. Секреты он советует держать в переменных окружения или Vault, а не в исходниках. Если вам нужен код сервисов, а не их границы, этот агент не закроет задачу — он останавливается на уровне решений.
Какие задачи решает
- разложить монолит на сервисы без простоя
- выбрать между REST, gRPC и GraphQL под конкретный сценарий
- описать контракты API до начала разработки
- спроектировать схему БД с индексами и шардированием
- заложить трассировку и метрики в архитектуру сразу
Примеры запросов агенту
- Разбей наш Rails-монолит на сервисы: покажи границы, контракты и порядок миграции
- Спроектируй бэкенд для сервиса поездок: жизненный цикл, матчинг, оплата, схема PostgreSQL
- Выбери парадигму API для внутреннего обмена между сервисами и обоснуй выбор
Как установить backend-architect
1Через claude-code-templates
npx claude-code-templates@latest --agent development-team/backend-architect2Вручную: положить файлы
.claude/agents/backend-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/backend-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/backend-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Из того же набора205
Весь набор →Похожие
Рядом в теме «Бэкенд и API»
Все субагенты по теме «Бэкенд и API» →Вопросы о backend-architect
Как установить backend-architect в Claude?
Через шаблоны: npx claude-code-templates@latest --agent development-team/backend-architect. Файл агента появится по пути .claude/agents/backend-architect.md.
Что делает backend-architect?
Проектирует архитектуру бэкенда: границы сервисов, парадигму API, схемы БД, событийные схемы и наблюдаемость. Код по этим решениям пишет другой агент.
Чем он отличается от backend-developer?
backend-architect принимает проектные решения и выдаёт спецификации, а backend-developer реализует по ним сервисы.
