К основному содержанию
субагент CX Codex

java-architect · voltagent/awesome-codex-subagents — субагент Codex для архитектуры Java-приложений

java-architect — субагент для архитектурных задач Java-приложений. Анализирует структуру кодовых баз, поведение JVM и границы фреймворков, выявляет корневые причины и предлагает минимальные безопасные изменения.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/java-architect.toml
Открыть на GitHub

Что делает java-architect

java-architect работает с Java-задачами как с production-кодом, а не как с упражнениями. Сначала строит карту границ исполнения (точка входа, путь данных, внешние зависимости), потом находит причину проблемы или разрыв в дизайне, затем предлагает минимальное, связное изменение, которое сохраняет существующее поведение за пределами области изменений.

Фокусируется на границах сервисов и направлении зависимостей, поведении потоков и асинхронности, иерархии исключений через слои, контрактах интерфейсов и DTO, консистентности транзакций в flow-ах сервисов. Всегда проверяет сквозной путь через границу слоёв, обработку ошибок, предположения о параллелизме и совместимость контрактов.

Возвращает точный модуль и границу, которые анализировались, конкретную проблему и почему она возникает, самое маленькое безопасное исправление и его компромиссы, что проверено напрямую и что ещё требует валидации в окружении, остаточные риски и дальнейшие шаги.

Какие задачи решает

  • спроектировать архитектуру многоуровневого Java-приложения
  • найти утечку ресурсов или deadlock в коде с потоками
  • разобраться с flow исключений между слоями сервиса
  • обновить контракт DTO без нарушения совместимости
  • проверить консистентность транзакций в сложном flow-е

Примеры запросов агенту

  • Проанализируй архитектуру этого микросервиса и предложи, как разделить на модули.
  • Что не так с моей обработкой исключений в REST-контроллере? Как связать её с логикой в service-слое?
  • У нас утечка памяти в потоке ExecutorService. Где искать и как её диагностировать?

Как установить java-architect

Вручную: положить файлы

.codex/agents/java-architect.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о java-architect

Как установить java-architect в Codex?

Скопируй файл агента в .codex/agents/java-architect.toml. После этого агент будет доступен в Codex как специализированный помощник по архитектуре Java.

Что делает java-architect?

Анализирует архитектуру Java-приложений, помогает спроектировать структуру больших кодовых баз, разбирается с поведением JVM, находит корневые причины проблем и предлагает минимальные, безопасные изменения, которые не нарушают существующее поведение.

Чем java-architect отличается от обычного помощника?

Работает как production-кодер, а не как учитель: сначала строит карту границ исполнения и находит корень проблемы, потом предлагает конкретное исправление. Проверяет контракты интерфейсов, поведение потоков, обработку ошибок и не выходит за пределы области изменений без явного запроса.

Исходный текст

java-architect.toml · MIT
# java-architect

Use when a task needs Java application or service architecture help across framework boundaries, JVM behavior, or large codebase structure.

Own Java tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- clear service/module boundaries and dependency direction
- threading, async execution, and resource lifecycle behavior
- exception taxonomy and propagation across architectural layers
- JVM/runtime considerations relevant to changed path
- contract stability of interfaces, DTOs, and serialization surfaces
- transactional consistency and side effects in service flows
- cohesive changes that preserve established framework conventions

Quality checks:
- verify one end-to-end flow crossing at least one layer boundary
- confirm error mapping remains explicit and actionable
- check concurrency or pooling assumptions around changed components
- ensure contract or schema changes are backward-compatible or called out
- flag deployment/config checks needed to validate runtime behavior

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not widen scope into repository-wide refactors or architecture overhauls unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — java-architect от других авторов.

java-architect VoltAgent Community Субагент java-architect проектирует архитектуру enterprise-приложений на Java 17+ и настраивает микросервисы на Spring Boot 3.x. Помогает при миграциях, разделении монолита и настройке реактивного стека. CX Codex 558установок java-pro Seth Hobson Субагент java-pro для Claude Code помогает разрабатывать на Java и проектировать микросервисы. Подключается к задачам по Java и настройке производительности JVM. CX Codex ★ 42 780звёзд репо authoring-java-sdk-tasks astronomer Скилл authoring-java-sdk-tasks для Claude Code, Codex, Cursor и других агентов, который учит писать логику задач Airflow на Java, Kotlin и любом JVM-языке через Airflow Java SDK. CX Codex +1 199установок java-expert PCL Team Скилл java-expert настраивает агента на разработку корпоративных сервисов на Java 21+ и Spring Boot. Помогает писать чистый код с внедрением зависимостей через конструктор и сборкой в Maven или Gradle. CX Codex +1 307установок java-docker pluginagentmarketplace Скилл java-docker помогает упаковывать Java-приложения в контейнеры Docker с настройкой параметров JVM, послойной сборкой и правилами безопасности. CX Codex +1 267установок spring-boot-engineer VoltAgent Community Субагент spring-boot-engineer для Claude Code помогает проектировать и разрабатывать приложения на Spring Boot 3+, включая микросервисы и реактивные сервисы. Помогает с облачным развёртыванием и интеграциями. CX Codex 336установок java-diagnostics официальный github Скилл java-diagnostics помогает расследовать проблемы JVM по симптомам: утечки памяти, зависания потоков, высокий CPU и долгие паузы GC. Он подбирает утилиты JDK с учётом их нагрузки на процесс. CX Codex +1 ★ 41 430звёзд репо

Из того же набора176

Весь набор →
nextjs-developer Субагент nextjs-developer разбирает и меняет поведение Next.js в маршрутах, рендеринге и работе с данными. Вызывайте его для точечной правки, где важны серверная и клиентская границы. CX Codex ★ 6 505звёзд репо laravel-specialist Субагент laravel-specialist для задач по маршрутизации, Eloquent, очередям, валидации и архитектуре Laravel. Ищет корень проблемы в граничных точках, предлагает минимальные безопасные правки и проверяет атомарность данных. CX Codex ★ 6 505звёзд репо kotlin-specialist Субагент kotlin-specialist для задач на Kotlin в JVM-сервисах и Android. Исправляет ошибки в корутинах, типах и контрактах без переписывания архитектуры. CX Codex ★ 6 505звёзд репо javascript-pro Субагент javascript-pro разбирает JavaScript для браузера и Node.js: ищет причины ошибок, меняет код и проверяет затронутые пути выполнения. CX Codex ★ 6 505звёзд репо golang-pro Субагент golang-pro для Codex помогает находить гонки данных и настраивать каналы и контексты без лишней перестройки архитектуры. CX Codex ★ 6 505звёзд репо flutter-expert Субагент flutter-expert разбирает Flutter-задачи: поведение виджетов, состояние, рендеринг и мобильную реализацию. Подключайте его к точечным изменениям в существующем проекте. CX Codex ★ 6 505звёзд репо fastapi-developer Субагент fastapi-developer для Codex, который берёт на себя разработку FastAPI приложений: асинхронные операции, типизированные контракты Pydantic v2, внедрение зависимостей и развёртывание на ASGI. CX Codex ★ 6 505звёзд репо expo-react-native-expert Субагент expo-react-native-expert помогает вести мобильную разработку на Expo и React Native, настраивать навигацию в Expo Router, сборки EAS и оптимизировать рендеринг. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой