Создание Architecture Decision Records

documentation

adr-writer — это скилл для Claude Code, который создаёт Architecture Decision Records: документирует контекст решения, оцененные альтернативы, выбранное направление и последствия, не порождая продуктовых обязательств. Скилл работает с инструментами Read, Write, Edit, Bash, Glob, Grep и TodoWrite; для навигации по репозиторию ADR использует команды govctl adr show и govctl search. Процесс строго упорядочен: сначала описывается проблема и ограничения, затем добавляются реальные альтернативы с плюсами и минусами, после чего фиксируется выбор с обоснованием и перечисляются последствия — включая издержки и способы их смягчения. Скилл не принимает, не отклоняет и не замещает ADR — эти операции делегируются смежным хелперам spec и gov. Подходит командам, которым нужно системно документировать архитектурные решения, восстанавливать историческую аргументацию или готовить ADR к ревью перед передачей в adr-reviewer.