What problem does it solve?
This Skill helps you recover missing planning and design documentation by generating it from the existing implementation, so you can understand what’s really happening and codify the intended architecture or gameplay design.
Core Features & Use Cases
- Reverse-engineered design documentation: Produces a game design document (GDD) by extracting mechanics, rules, values, state behavior, edge-case handling, and system dependencies from code or prototypes.
- Architecture decision records (ADRs): Generates architecture docs by identifying patterns, technical decisions, coupling/dependencies, performance characteristics, and trade-offs from core system code.
- Prototype-to-concept writeups: Converts prototype behavior into concept documentation by extracting the core mechanic, emergent gameplay patterns, what worked/failed, and feasibility insights.
- Intent-first collaboration: Asks clarifying questions about “why” before writing the rationale portion of the document to avoid guessing design intent.
Quick Start
Use the reverse-document skill to generate a design doc for your existing gameplay system at src/gameplay/magic-system so you can formalize mechanics and document the intended pacing and scaling.