# decision-records

Ведёт реестр решений в стиле ADR: черновики, принятые записи, архивирование и замена. Плюс сам генерирует INDEX.md и перекрёстные ссылки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 6800 установок · ★ 1
- Автор: skymavis
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/skymavis/skills/tree/HEAD/skills/decision-records/SKILL.md
- Обновлён: 2026-09-11
- HTML: https://affpapa.org/nevibecode/skills/decision-records

## Что делает

Скилл ставит в репозиторий инструмент `scripts/decisions.py` и раскладывает всё по `docs/decisions/`: `drafts/` для черновиков, `accepted/` для принятых записей, `archived/` для отозванных. Черновик получает ID из 4 заглавных букв, принятая запись — сквозной номер вроде `0001`. Тип записи (`architecture`, `product`, `security`, `policy`, `legal`) задаётся во front-matter, так что каталоги остаются плоскими, а INDEX группирует записи по типу.

Работа идёт через подкоманды: `build` пересобирает INDEX.md и чинит ссылки, `check` проверяет формат и уникальность ID, `promote` превращает черновик в принятую запись, `rename-draft-id` меняет ID черновика, `migrate-layout` разворачивает старую раскладку `accepted/<type>/` в плоскую. `install` заводит симлинк и pre-commit-проверку. Ссылки руками писать не нужно: голый ID в обратных кавычках, а пути расставит `build --relink`.

Продвижение черновика требует явного подтверждения от человека — это полунеобратимое действие. `check` предупреждает, если ID пересекается с записью в `origin/main` или если живой документ ссылается на уже заменённую запись, но прогон не роняет: упоминание может быть намеренно историческим. Запускать инструмент можно из любой точки репозитория, `docs/` он ищет сам, поднимаясь от текущего каталога.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skymavis/skills --skill decision-records -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skymavis/skills --skill decision-records -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skymavis/skills --skill decision-records -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install skymavis/skills decision-records
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add skymavis/skills --skill decision-records -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/skymavis/skills --path skills/decision-records
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add skymavis/skills --skill decision-records -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/skymavis/skills/tree/HEAD/skills/decision-records/SKILL.md

## Когда брать
- завести запись о решении и не потерять её среди прочих документов
- собрать INDEX.md по всем принятым и архивным записям
- проверить формат и уникальность ID перед коммитом
- заменить устаревшее решение новым и сослаться на предшественника
- переехать со старой раскладки accepted/<type>/ на плоскую

## Примеры запросов агенту
- создай черновик решения про выбор очереди сообщений
- продвинь черновик CONF в accepted
- пересобери INDEX.md и обнови ссылки

## Похожие
- [architecture-decision-records](https://affpapa.org/nevibecode/skills/affaan-m-architecture-decision-records.md) — скилл · 4900 установок
- [decision-doc-sync](https://affpapa.org/nevibecode/skills/decision-doc-sync.md) — скилл · 3000 установок
- [create-architectural-decision-record](https://affpapa.org/nevibecode/skills/create-architectural-decision-record.md) — скилл · 10176 установок
- [recording-decisions](https://affpapa.org/nevibecode/skills/recording-decisions.md) — скилл · 18000 установок
- [writing-adrs](https://affpapa.org/nevibecode/skills/writing-adrs.md) — скилл · 1700 установок
- [technical-specification](https://affpapa.org/nevibecode/skills/technical-specification.md) — скилл · 804 установки

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

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