decision-doc-sync — скилл для Claude Code: синхронизация доков
Держит README, DESIGN, AGENTS и ADR в согласии с кодом после архитектурных и UX-изменений. Пригодится, когда правка ломает документацию.
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a claude-codeЧто делает decision-doc-sync
Скилл включается, когда изменение вводит структурное решение: архитектуру, стандарт UI/UX, скрипты и quality gates или сквозную конвенцию. Дальше он смотрит, какие документы вообще есть в проекте, и трогает только их. Новый файл создаётся лишь тогда, когда этого требует таблица решений.
Куда что писать, задано жёстко: архитектура и структура папок идут в README.md, визуальные стандарты и токены — в DESIGN.md, рабочие процессы агента и команды — в AGENTS.md, а долговечное решение с альтернативами и последствиями — отдельной записью в docs/adr/. Одно изменение может задеть несколько строк сразу. Каждый факт живёт в одном документе, остальные на него ссылаются, а не копируют.
В конце скилл перечитывает правленые разделы рядом с кодом и выдаёт список: что обновлено, что создано, что сознательно пропущено — по строке причины на каждый пункт. Формат и нумерацию ADR он берёт из уже существующих записей в docs/adr/, так что заводить их с нуля под него не нужно. Документ, который противоречит коду после изменения, остаться не должен.
Какие задачи решает
- обновить README после переезда папок
- зафиксировать новый UI-стандарт в DESIGN.md
- описать команды агента в AGENTS.md
- завести ADR с альтернативами и последствиями
- убрать расхождение между доками и кодом
Примеры запросов агенту
- Мы переехали на новую структуру папок — синхронизируй документацию
- Добавили quality gate в CI, обнови то, что об этом должно знать
- Запиши решение по выбору стейт-менеджера как ADR
Как установить decision-doc-sync
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a claude-code2Вручную: положить файлы
~/.claude/skills/decision-doc-sync/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/decision-doc-sync/
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a codex2Вручную: положить файлы
.agents/skills/decision-doc-sync/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a cursor2Вручную: положить файлы
.cursor/skills/decision-doc-sync/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install C3SC0-V4113/Scaffold decision-doc-sync2Вручную: положить файлы
.github/skills/decision-doc-sync/SKILL.md1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a gemini-cli2Командой платформы
gemini skills install https://github.com/C3SC0-V4113/Scaffold --path skills/decision-doc-syncВручную: положить файлы
.devin/skills/decision-doc-sync/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о decision-doc-sync
Как установить decision-doc-sync в Claude?
Выполните npx skills add C3SC0-V4113/Scaffold --skill decision-doc-sync -a claude-code. Скилл окажется в ~/.claude/skills/decision-doc-sync/SKILL.md.
Что делает decision-doc-sync?
Следит, чтобы README, DESIGN, AGENTS и записи в docs/adr не противоречили коду после структурного изменения. Обновляет только существующие документы и отчитывается о пропущенных.
Какие документы он трогает?
README.md — для архитектуры и скриптов, DESIGN.md — для визуальных и UX-стандартов, AGENTS.md — для рабочих процессов агента, docs/adr/ — для решений с альтернативами. Один факт хранится в одном месте, остальные ссылаются на него.
Исходный текст
SKILL.md · Apache-2.0
--- name: decision-doc-sync description: "Trigger: architecture change, new convention, UI/UX standard, quality gate change, ADR. Keep existing project docs in sync with structural decisions." license: Apache-2.0 metadata: author: purrfold version: "1.0" --- # Decision Documentation Sync ## Activation Contract Load this skill when a change introduces or changes a structural decision: architecture, UI/UX standards, scripts or quality gates, or a cross-cutting convention. ## Hard Rules 1. Check which documents exist before editing; update only documents that exist, and create one only when a rule below requires it. 2. Keep each fact in one document and link to it from others instead of duplicating it. 3. Record the decision itself, not the change history. 4. Never leave a document contradicting the code after the change. ## Decision Gates | Change type | Document | | --- | --- | | Architecture, folder structure, scripts | `README.md` | | Visual or UX standard, tokens, component usage | `DESIGN.md` | | Agent workflow, commands, operational guidance | `AGENTS.md` | | Durable decision with alternatives and consequences | new record in `docs/adr/` | ## Execution Steps 1. Check which of `README.md`, `DESIGN.md`, `AGENTS.md`, and `docs/adr/` exist. 2. Classify the change with the table above; one change may hit several rows. 3. Update each affected document that exists. 4. For an ADR, follow the existing numbering and format in `docs/adr/`; see [references/doc-map.md](references/doc-map.md). 5. Reread the edited sections against the code. ## Output Contract List every document updated, created, or deliberately skipped, with a one-line reason each. ## References - [references/doc-map.md](references/doc-map.md) — ADR format and edge cases.
© purrfold · Apache-2.0 · C3SC0-V4113/Scaffold
