# reverse-document

Разбирает уже написанный код или прототип и собирает по нему дизайн-док или ADR. Пригодится, когда фича есть, а описания к ней нет.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 461 установка · ★ 27473
- Автор: Donchitos
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Donchitos/Claude-Code-Game-Studios/tree/HEAD/.claude/skills/reverse-document/SKILL.md
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/skills/reverse-document

## Что делает

Скилл вызывается как `/reverse-document <type> <path>`. Тип задаёт, что получится на выходе: `design` — раздел геймдизайн-документа, `architecture` — Architecture Decision Record, `concept` — документ по прототипу. Путь указывает на папку или файл: `src/gameplay/combat/` для Godot, `Assets/Scripts/Core/EventSystem.cs` для Unity, `Source/MyGame/Private/AI/` для Unreal.

Дальше скилл читает код и вытаскивает механики, формулы и значения, а потом задаёт вопросы про замысел. Это важная часть: он не пересказывает код, а спрашивает, зачем система истощает ресурс — для темпа или ради стратегической глубины, и центральная ли это механика или вспомогательная. Перед черновиком он показывает найденное отдельным списком, чтобы вы поправили его до того, как он что-то напишет.

Объём документа зависит от тира workflow, который скилл берёт из конфигурации проекта, а не выбирает сам. На `full` это GDD из 8 разделов, на `minimal` — одна страница. Есть и стоп-условие: если в указанном пути меньше примерно 20 строк неслужебного кода и ни одной механики, формулы или настраиваемого значения, скилл останавливается и предлагает `/design-system` — тот спрашивает, а не додумывает. Это честнее, чем получить документ с выдуманным содержимым в аккуратном формате.

## Требования
- Работает с: Unity, Unreal Engine, Godot

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill reverse-document -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill reverse-document -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill reverse-document -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Donchitos/Claude-Code-Game-Studios reverse-document
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill reverse-document -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Donchitos/Claude-Code-Game-Studios --path .claude/skills/reverse-document
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Donchitos/Claude-Code-Game-Studios --skill reverse-document -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Donchitos/Claude-Code-Game-Studios/tree/HEAD/.claude/skills/reverse-document/SKILL.md

## Когда брать
- восстановить дизайн-док по уже написанной механике
- описать чужой код, который достался без документации
- оформить прототип механики в concept-документ
- зафиксировать причины технических решений в ADR
- найти формулы и настраиваемые значения, разбросанные по коду

## Примеры запросов агенту
- /reverse-document design src/gameplay/magic-system
- /reverse-document architecture Source/MyGame/Private/EntityComponent
- /reverse-document concept prototypes/vehicle-combat

## Похожие
- [performance-optimization](https://affpapa.org/nevibecode/skills/gamedev-skills-performance-optimization.md) — скилл · 7400 установок
- [router](https://affpapa.org/nevibecode/skills/router.md) — скилл · 6600 установок
- [iphone-duo-games](https://affpapa.org/nevibecode/skills/iphone-duo-games.md) — скилл · 427 установок
- [game-development](https://affpapa.org/nevibecode/skills/miles990-game-development.md) — скилл · 410 установок
- [make-game](https://affpapa.org/nevibecode/skills/make-game.md) — скилл · 1100 установок
- [mashup-mods](https://affpapa.org/nevibecode/skills/mashup-mods.md) — скилл · 1500 установок

Из того же набора: [donchitos/claude-code-game-studios](https://affpapa.org/nevibecode/by/donchitos/claude-code-game-studios.md) — 72 карточки

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

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