# java-documentation-specialist

Субагент java-documentation-specialist для Claude Code разбирает код на Spring Boot и пишет документацию по эндпоинтам, схеме БД и архитектуре. Помогает объяснить Java-проект другим.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/agents/java-documentation-specialist.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/java-documentation-specialist

## Что делает

Субагент проходит по Java-проекту и превращает его в текст: описание REST-эндпоинтов, связи JPA-сущностей, настройки безопасности, гайд по архитектуре. Сначала смотрит сборку Maven или Gradle, потом раскладывает контроллеры, сервисы и репозитории по местам.

Чек-лист внутри широкий: OpenAPI-спеки, транзакции, Spring Security и JWT, метрики Actuator, тесты, Docker и CI/CD. Отдельно он делает Javadoc с примерами кода. Модель в конфигурации — `sonnet`, в доступе `Read`, `Write`, `Edit`, `Glob`, `Grep` и `Bash`.

Файлы он пишет через `Write` и `Edit`, так что результат ляжет прямо в репозиторий и ревьюить его придётся как обычный коммит. К агенту подключён скилл `clean-architecture`: разделы про слои и зависимости появятся в документе вместе с остальным.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-java@developer-kit
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/agents/java-documentation-specialist.md

## Когда брать
- собрать OpenAPI-описание по существующим контроллерам
- описать схему БД и связи между JPA-сущностями
- написать гайд по архитектуре из кода, а не из головы
- задокументировать флоу аутентификации в Spring Security
- сгенерировать Javadoc с рабочими примерами

## Примеры запросов агенту
- Разбери проект в `./orders-service` и сделай документацию по API с примерами запросов.
- Опиши архитектуру сервиса: контроллеры, сервисы, репозитории, и добавь схему JPA-сущностей.
- Сгенерируй Javadoc для пакета `com.acme.billing` и поясни неочевидные места.

## Похожие
- [113-java-maven-documentation](https://affpapa.org/nevibecode/skills/113-java-maven-documentation.md) — скилл · 370 установок
- [openapi-to-application-java-spring-boot](https://affpapa.org/nevibecode/skills/openapi-to-application-java-spring-boot.md) — скилл · ★ 41430 у репозитория
- [170-java-documentation](https://affpapa.org/nevibecode/skills/170-java-documentation.md) — скилл · 382 установки
- [api-documentation](https://affpapa.org/nevibecode/skills/bobmatnyc-api-documentation.md) — скилл · 397 установок
- [java-mcp-expert](https://affpapa.org/nevibecode/agents/davila7-java-mcp-expert.md) — субагент · 291 установка
- [documentation-engineer](https://affpapa.org/nevibecode/agents/documentation-engineer.md) — субагент · 735 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

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

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