AIKraft/AI/Войти
AIKraft/Skills/Написание ADR

Написание ADR

Format, numbering, and when-to-write criteria for Architecture Decision Records in docs/adr/. Use when recording an architectural decision, when another skill flags a decision as ADR-worthy, or when the user asks to write or review an ADR.

frankify-app official Документы

Что делает навык

Фиксирует архитектурные решения в формате Architecture Decision Records (ADR) в директории docs/adr/. Skill обеспечивает единый формат, нумерацию и критерии отбора решений, требующих документирования, чтобы зафиксировать контекст и причины выбора.

Когда применять

  • Фиксация архитектурного решения, когда другой skill помечает его как достойное ADR
  • Прямой запрос пользователя на написание или проверку ADR
  • Документирование выбора технологии с высоким уровнем lock-in (базы данных, шлюзы сообщений)
  • Запись решений о границах контекстов и схемах интеграции между ними
  • Фиксация намеренных отклонений от очевидных путей реализации

Как работает

  1. Проверить наличие директории docs/adr/ и создать её лениво, если она отсутствует
  2. Отсканировать существующие файлы в docs/adr/ для определения максимального номера и присвоить следующий по порядку
  3. Оценить решение по критериям: обратимость, неожиданность без контекста и наличие реальных альтернатив
  4. Если решение принято в ходе беседы, но не было проверено через grilling, запросить у пользователя подтверждение записи
  5. Составить заголовок и краткое описание (1–3 предложения) в соответствии с шаблоном
  6. При необходимости добавить опциональные секции (статус, альтернативы, последствия) только если они несут ценность

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

Напиши ADR для решения использовать PostgreSQL вместо MongoDB для хранения пользовательских данных
Проверь существующий ADR-0001-monorepo на соответствие шаблону и критериям
Зафиксируй архитектурное решение о коммуникации между контекстами через доменные события, а не HTTP

Что понадобится

  • Доступ к файловой системе для чтения и записи в docs/adr/
  • Наличие skill writing-prose для проверки текста (если доступно)
  • Наличие файла docs/glossary/grilling-session.md для проверки статуса решения

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «writing-adrs» из репозитория: # https://github.com/frankify-app/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r writing-adrs/ ~/.claude/skills/writing-adrs/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.