# java-architect

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

- субагент · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 у репозитория
- Автор: VoltAgent
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/java-architect.toml
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/voltagent-java-architect

## Что делает

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

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

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

## Установка

### Codex (родная платформа)

**Вручную: положить файлы**
- Файл: `.codex/agents/java-architect.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/java-architect.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/java-architect.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/java-architect.toml

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

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

## Похожие
- [java-pro](https://affpapa.org/nevibecode/agents/java-pro.md) — субагент · ★ 42780 у репозитория
- [authoring-java-sdk-tasks](https://affpapa.org/nevibecode/skills/authoring-java-sdk-tasks.md) — скилл · 199 установок
- [java-expert](https://affpapa.org/nevibecode/skills/java-expert.md) — скилл · 307 установок
- [java-docker](https://affpapa.org/nevibecode/skills/java-docker.md) — скилл · 267 установок
- [spring-boot-engineer](https://affpapa.org/nevibecode/agents/spring-boot-engineer.md) — субагент · 336 установок
- [java-diagnostics](https://affpapa.org/nevibecode/skills/java-diagnostics.md) — скилл · ★ 41430 у репозитория

## Другие версии с тем же именем
- [java-architect · voltagent](https://affpapa.org/nevibecode/agents/java-architect.md) — 558 установок

Из того же набора: [voltagent/awesome-codex-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
