One-click install
npx skills add https://github.com/johnatas-henrique/overdrive --skill reverse-document-johnatas-henrique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-document
Source: https://github.com/johnatas-henrique/overdrive/tree/main/.opencode/skills/reverse-document
Command: npx skills add https://github.com/johnatas-henrique/overdrive --skill reverse-document-johnatas-henrique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the hassle of creating documentation for existing code, prototypes, or implemented features that were built without upfront planning docs, saving teams hours of manual documentation work.

Core Features & Use Cases

  • Game Design Doc Generation: Analyze gameplay code to create formal GDD sections capturing mechanics, formulas, rules, and state systems.
  • Architecture Decision Record Creation: Extract technical patterns, tradeoffs, and decisions from core system code to generate structured ADRs.
  • Prototype Concept Documentation: Convert prototype implementations into concept docs that capture core mechanics, emergent gameplay, and technical feasibility insights.
  • Use Case: If your team built a new magic system for your 90s F1-style racing game without writing a design doc first, use this Skill to automatically generate a complete GDD section for the magic system by analyzing the existing source code.

Quick Start

Use the reverse-document skill to generate a design document for the combat system by analyzing the implementation in the src/gameplay/combat directory.

Frequently Asked Questions about reverse-document

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate design documentation from existing game code?

To generate design documentation from existing game code, use a reverse-documentation approach to analyze implemented source systems and capture mechanics, formulas, and state systems into formal GDD sections.

Can I create architecture decision records for an inherited codebase without prior documentation?

You can create architecture decision records for an inherited codebase by reverse-engineering core system code to extract technical patterns, tradeoffs, and structural decisions into structured ADRs.

What is the best way to document emergent gameplay mechanics from a prototype?

Documenting emergent gameplay mechanics from a prototype requires converting prototype implementations into concept docs that capture core mechanics, technical feasibility insights, and design intent.

Does reverse-documentation work for undocumented gameplay systems in game development?

Reverse-documentation works for undocumented gameplay systems in game development by analyzing the implemented source code to clarify design intent and formalize captured mechanics through collaborative user input.

How do I capture technical decisions and patterns from a codebase lacking upfront planning docs?

To capture technical decisions from a codebase lacking upfront planning docs, extract implemented patterns and emergent technical tradeoffs directly from the source code to synthesize structured architecture documentation.

When should I avoid using AI to reverse-engineer code into design docs?

You should avoid reverse-engineering code into design docs when the source implementation is heavily obfuscated or when the collaborative user input required to clarify design intent is unavailable.