Agent Decision Records — плагин
Стандарт AgDR: агент пишет короткую запись о выбранной библиотеке или архитектуре в момент решения и коммитит ее рядом с кодом.
- 53 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Плагин добавляет команду и шаблон, а агент пишет Markdown-файлы в `docs/agdr/`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/agent-decision-recordsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Плагин добавляет команду и шаблон, а агент пишет Markdown-файлы в `docs/agdr/`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agent Decision Record, или AgDR, фиксирует причины технических решений агента. Это небольшой структурированный Markdown-файл: контекст, рассмотренные варианты, решение и принятый компромисс. Агент пишет его в момент выбора, например библиотеки, паттерна или миграции, и коммитит вместе с кодом. Запись несет метаданные для аудита: модель, триггер и время. Идея похожа на Architecture Decision Record, но автор записи сам агент. Это открытый стандарт с представлением в Markdown и JSON, схемами для обоих и валидаторами для CI. Плагин для Claude Code добавляет команду `/agent-decision-record:decide`, для Codex есть `$agdr-decide`, а любой другой ассистент получает правило через системный промпт. Файлы лежат в `docs/agdr/AgDR-NNNN-*.md`.
Для кого. Командам, где агенты принимают технические решения, и тем, кому через месяц нужно понять причины архитектуры.
Подходит, если
- Агент выбирает между двумя библиотеками, и причину фиксируют до коммита.
- Новый сотрудник спрашивает, почему принята такая архитектура.
- В CI хотят отклонять записи решений с неверной структурой.
- Аудит требует знать модель и момент принятия решения.
Не подходит, если
- Нужна обычная запись архитектурных решений людьми без агентов.
- Проект не хранит документацию в репозитории.
- Требуется подробная документация процесса, а не отдельных решений.
Пример запроса к агенту
`/agent-decision-record:decide` какой фреймворк тестирования выбрать для сервиса на TypeScript.Ограничения
Стандарт ничего не навязывает: можно взять только шаблон `agdr-template.md`, схему `schema/agdr.schema.json` и скрипт `scripts/validate-agdr.js`. Качество записи зависит от агента: он может описать причины неполно, поэтому записи стоит просматривать при ревью, как код. Проверка в CI отклоняет только неверную форму, содержание она не оценивает. Плагин рассчитан на Claude Code, для других ассистентов решения подключают через команды Codex или системный промпт.
Как отключить. Удалите плагин через `/plugin`, файл `.claude/commands/decide.md` и при желании каталог `docs/agdr/` с записями.
Частые вопросы
Как поставить плагин?
Командами `/plugin marketplace add me2resh/agent-decision-record` и `/plugin install agent-decision-record@agent-decision-record`.
Как вызвать запись решения?
В Claude Code командой `/agent-decision-record:decide` с темой, в Codex через `$agdr-decide`. Файл появится в `docs/agdr/`.
Нужен ли плагин вообще?
Нет, достаточно шаблона, схемы и скрипта проверки. Можно также добавить правило в системный промпт любого ассистента.
Чем AgDR отличается от ADR?
Это те же записи решений, но автор агент, а метаданные включают модель, триггер и время. Формат Markdown с JSON-схемой.
Что проверяет CI?
Скрипт `validate-agdr.js` или рабочий процесс `validate-agdr.yml` отклоняют записи с неверной структурой по схеме.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныArchgate превращает архитектурные решения в исполняемые правила и блокирует нарушения в CI, хуках и работе ИИ-агентов
Плагин Claude Code ведет архитектуру проекта: ADR, ревью разными ролями, перенос выводов в план и прагматичный режим.
CLI разбирает репозиторий шестифазным конвейером моделей и пишет AGENTS.md или CLAUDE.md; ведет планы ExecPlan с вехами.
Два скилла для Codex и Claude Code: prd ведет живой документ с чеклистом внедрения, review смотрит на решения глазами пользователя
Git-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
Детерминированная проверка AGENTS.md и CLAUDE.md: сравнивает правку с базой и блокирует регрессии в CI без модели.
Коротко о README
README объясняет проблему потерянного контекста решений агента, показывает пример записи и три пути внедрения: плагин, ручная копия команды и системный промпт. Нормативное описание лежит в `SPEC.md`.