# decision-doc-sync

Держит README, DESIGN, AGENTS и ADR в согласии с кодом после архитектурных и UX-изменений. Пригодится, когда правка ломает документацию.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3000 установок · ★ 3
- Автор: purrfold
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/C3SC0-V4113/Scaffold/tree/HEAD/skills/decision-doc-sync/SKILL.md
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/skills/decision-doc-sync

## Что делает

Скилл включается, когда изменение вводит структурное решение: архитектуру, стандарт UI/UX, скрипты и quality gates или сквозную конвенцию. Дальше он смотрит, какие документы вообще есть в проекте, и трогает только их. Новый файл создаётся лишь тогда, когда этого требует таблица решений.

Куда что писать, задано жёстко: архитектура и структура папок идут в `README.md`, визуальные стандарты и токены — в `DESIGN.md`, рабочие процессы агента и команды — в `AGENTS.md`, а долговечное решение с альтернативами и последствиями — отдельной записью в `docs/adr/`. Одно изменение может задеть несколько строк сразу. Каждый факт живёт в одном документе, остальные на него ссылаются, а не копируют.

В конце скилл перечитывает правленые разделы рядом с кодом и выдаёт список: что обновлено, что создано, что сознательно пропущено — по строке причины на каждый пункт. Формат и нумерацию ADR он берёт из уже существующих записей в `docs/adr/`, так что заводить их с нуля под него не нужно. Документ, который противоречит коду после изменения, остаться не должен.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install C3SC0-V4113/Scaffold decision-doc-sync
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a opencode
```

### Claude.ai

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

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

## Когда брать
- обновить README после переезда папок
- зафиксировать новый UI-стандарт в DESIGN.md
- описать команды агента в AGENTS.md
- завести ADR с альтернативами и последствиями
- убрать расхождение между доками и кодом

## Примеры запросов агенту
- Мы переехали на новую структуру папок — синхронизируй документацию
- Добавили quality gate в CI, обнови то, что об этом должно знать
- Запиши решение по выбору стейт-менеджера как ADR

## Похожие
- [decision-records](https://affpapa.org/nevibecode/skills/decision-records.md) — скилл · 6800 установок
- [sync](https://affpapa.org/nevibecode/skills/sync.md) — скилл · 4300 установок
- [architecture-decision-records](https://affpapa.org/nevibecode/skills/affaan-m-architecture-decision-records.md) — скилл · 4900 установок
- [create-architectural-decision-record](https://affpapa.org/nevibecode/skills/create-architectural-decision-record.md) — скилл · 10176 установок
- [claude-migrate-memory-to-doc](https://affpapa.org/nevibecode/skills/claude-migrate-memory-to-doc.md) — скилл · 325 установок
- [recording-decisions](https://affpapa.org/nevibecode/skills/recording-decisions.md) — скилл · 18000 установок

Из того же набора: [c3sc0-v4113/scaffold](https://affpapa.org/nevibecode/by/c3sc0-v4113/scaffold.md) — 2 карточки

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

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