# create-adr

Скилл create-adr для Claude Code — фиксирует принятые архитектурные решения в формате ADR, сохраняя контекст для будущих разработчиков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 7191 у репозитория
- Автор: Tech Leads Club - github.com/tech-leads-club
- Лицензия: CC-BY-4.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(creation)/create-adr/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/create-adr

## Что делает

Скилл создаёт архитектурные записи (Architecture Decision Records) прямо в репозитории проекта. Ассистент запрашивает суть решения, контекст, статус и последствия. Поддерживаются три формата: MADR с разбором альтернатив, минималистичный Nygard и сжатый Y-Statement. По умолчанию генератор использует MADR.

Инструмент проверяет папки `docs/adr/`, `docs/decisions/` или `.adr/`, определяет максимальный порядковый номер и присваивает следующий индекс. Документ формируется на языке пользователя с сохранением английских технических терминов. Готовый файл предлагается сохранить по пути `docs/adr/{NNN}-{kebab-case-title}.md`.

Скилл рассчитан строго на зафиксированные решения. Если выбор ещё не сделан и требуется обсуждение вариантов, автор предписывает использовать процесс RFC.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill create-adr -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/create-adr/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/create-adr/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill create-adr -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/create-adr/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill create-adr -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(creation)/create-adr'
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/create-adr/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill create-adr -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(creation)/create-adr'
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/create-adr/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(creation)/create-adr/SKILL.md

## Когда брать
- зафиксировать выбор технологии или архитектурного подхода
- сохранить аргументы и отклонённые варианты в формате MADR
- присвоить следующий порядковый номер новой записи в каталоге ADR
- структурировать последствия принятого инженерного решения

## Примеры запросов агенту
- Зафиксируй через ADR наше решение перейти на PostgreSQL для основного хранилища
- Создай ADR по выбору Redis для сессий, используй формат Nygard
- Добавь архитектурную запись о разделении монолита на сервисы

## Похожие
- [adr-create](https://affpapa.org/nevibecode/skills/adr-create.md) — скилл · 743 установки
- [adr-drafting](https://affpapa.org/nevibecode/skills/adr-drafting.md) — скилл · 3700 установок
- [ADR Generator](https://affpapa.org/nevibecode/agents/adr-generator.md) — субагент · ★ 41430 у репозитория
- [adr](https://affpapa.org/nevibecode/skills/adr.md) — скилл · 146 установок
- [adr-writing](https://affpapa.org/nevibecode/skills/adr-writing.md) — скилл · 254 установки
- [adr-decision-extraction](https://affpapa.org/nevibecode/skills/adr-decision-extraction.md) — скилл · 144 установки

Из того же набора: [tech-leads-club/agent-skills](https://affpapa.org/nevibecode/by/tech-leads-club/agent-skills.md) — 130 карточек

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

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