# ADR Generator

Субагент оформляет архитектурные решения в формате ADR и сохраняет их в репозиторий. Он проверяет входящие данные, нумерует документы и фиксирует альтернативы с последствиями.

- субагент · `type=agent` · GitHub Copilot · ★ 40418
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/adr-generator.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/adr-generator

## Что делает

Субагент автоматизирует составление архитектурных записей (Architectural Decision Records). Сначала он запрашивает контекст задачи, выбранное решение, отклонённые варианты и участников обсуждения. Если данных не хватает, помощник не начинает генерацию, а задаёт уточняющие вопросы.

После сбора деталей агент проверяет каталог `/docs/adr/`, вычисляет следующий четырёхзначный номер и создаёт файл формата `adr-NNNN-[название].md`. Документ содержит метаданные YAML, статус и блоки обоснования. Для преимуществ, рисков и альтернатив субагент формирует кодовые метки вроде `POS-001`, `NEG-001` и `ALT-001`.

Без структуры папок `/docs/adr/` агент автоматически начнёт нумерацию с `0001`. Новые решения сразу получают статус Proposed.

## Установка

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

**Вручную: положить файлы**
- Файл: `.github/agents/adr-generator.agent.md`

### Claude Code

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/agents/adr-generator.agent.md

## Когда брать
- зафиксировать выбор архитектуры или базы данных
- оформить отклонённые технические альтернативы с причинами отказа
- сохранить единую сквозную нумерацию файлов в `/docs/adr/`
- расписать положительные и отрицательные последствия внедрения

## Примеры запросов агенту
- Задокументируй переход с REST API на gRPC в виде нового ADR
- Создай черновик архитектурного решения по выбору PostgreSQL вместо MongoDB
- Оформи ADR для внедрения Redis в качестве кэширующего слоя

## Похожие
- [prompt-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-prompt-engineer.md) — субагент · 16078 установок
- [context-manager](https://affpapa.org/nevibecode/agents/context-manager.md) — субагент · 10638 установок
- [code-explorer](https://affpapa.org/nevibecode/agents/code-explorer.md) — субагент · 1172 установки
- [search-specialist](https://affpapa.org/nevibecode/agents/search-specialist.md) — субагент · 6886 установок
- [api-documenter](https://affpapa.org/nevibecode/agents/api-documenter.md) — субагент · 6451 установка
- [technical-writer](https://affpapa.org/nevibecode/agents/technical-writer.md) — субагент · 4345 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 732 карточки

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

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