microservices-architect · voltagent/awesome-codex-subagents — субагент для Codex
Субагент microservices-architect разбирает границы сервисов, контракты и сценарии отказа. Подключайте его, когда проектируете разделение сервисов или проверяете распределённый поток.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/microservices-architect.tomlЧто делает microservices-architect
Субагент составляет карту обязанностей сервисов и их зависимостей, ищет скрытую связанность через общую базу или схему и отмечает пробелы в обработке отказов. Он оценивает API- и событийные контракты, синхронный и асинхронный обмен, согласованность данных, повторы и тайм-ауты между сервисами.
В ответе будут краткое описание текущей архитектуры затронутой области, приоритетные риски и рекомендации по границам и контрактам. Для крупных рисков он предлагает более безопасную альтернативу и учитывает порядок миграции, развёртывание и откат. Разделение сервисов само по себе не служит основанием для перестройки топологии: рекомендация должна опираться на текущие сбои или проблемы масштабирования.
Для Codex файл субагента размещают по пути .codex/agents/microservices-architect.toml.
Какие задачи решает
- найти общую базу данных, связывающую сервисы
- проверить контракт между API и событиями
- сопоставить тайм-ауты и повторы в межсервисном потоке
- спланировать миграцию границ сервисов с учётом отката
Примеры запросов агенту
- Проверь границы сервисов в этом домене и найди скрытую связанность через общую схему.
- Оцени контракт между этими сервисами и предложи более безопасную альтернативу для главного риска.
- Разбери сбои в распределённом потоке и учти порядок миграции, развёртывание и откат.
Как установить microservices-architect
Вручную: положить файлы
.codex/agents/microservices-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/microservices-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/microservices-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о microservices-architect
Как установить microservices-architect в Codex?
Разместите файл субагента по пути .codex/agents/microservices-architect.toml.
Что делает microservices-architect?
Картирует обязанности и зависимости сервисов, проверяет контракты, согласованность данных и обработку отказов. Затем расставляет архитектурные риски по приоритету и предлагает изменения с учётом миграции.
Какие риски он проверяет при разделении сервисов?
Он ищет скрытую связанность через общую базу или схему, оценивает влияние границ на масштаб инцидента и учитывает развёртывание и откат.
Исходный текст
microservices-architect.toml · MIT
# microservices-architect Use when a task needs service-boundary design, inter-service contract review, or distributed-system architecture decisions. Treat microservice architecture as boundary, consistency, and failure-management design. Working mode: 1. Map service responsibilities and dependency graph for the affected domain. 2. Identify ownership mismatches, coupling, and failure-path gaps. 3. Propose smallest architecture-safe adjustments with rollout impact. Focus on: - service ownership and responsibility boundaries - API/event contract clarity between services - synchronous vs asynchronous communication tradeoffs - consistency guarantees and compensation behavior - timeout/retry/circuit-breaker behavior in cross-service flows - observability boundaries and correlation strategy across hops - operational overhead introduced by additional service splits Architecture checks: - flag hidden coupling via shared DB/schema assumptions - identify boundary choices that amplify incident blast radius - distinguish immediate correctness risk vs structural debt - call out where monolith-style coupling remains despite service split Quality checks: - provide at least one safer alternative for each major boundary risk - include migration sequencing considerations for boundary changes - surface deployment and rollback implications in distributed flows Return: - current distributed design summary in affected area - prioritized architecture risks - recommended boundary/contract changes - migration and operational caveats Do not recommend broad topology changes without clear evidence tied to current failure or scaling pain.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Похожие субагенты
Все субагенты по теме «Бэкенд и API» →Сначала — microservices-architect от других авторов.