reverse-document

Generate GDD or ADR documentation from existing code implementations.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LordKuper/agentic-game-studio --skill reverse-document-lordkuper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-document
Source: https://github.com/LordKuper/agentic-game-studio/tree/main/.claude/skills/reverse-document
Command: npx skills add https://github.com/LordKuper/agentic-game-studio --skill reverse-document-lordkuper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze existing implementation to generate missing planning documents, bridging the gap between code and design by deriving rationale, structure, and decisions.

Core Features & Use Cases

  • Automated extraction of mechanics, architecture decisions, and rationale from code.
  • Generates Game Design Documents (GDD) or Architecture Decision Records (ADR) for easier onboarding and maintenance.
  • Applicable to gameplay subsystems or core systems to document "why" behind existing code.

Quick Start

Run /reverse-document design src/gameplay/magic-system to generate a GDD section from existing implementation.

Frequently Asked Questions about reverse-document

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

FAQPage Schema
How do I generate architecture documentation from existing code?

To generate architecture documentation from existing code, analyze the implementation to extract decisions and rationale, producing an Architecture Decision Record that captures the 'why' behind the codebase structure and intent.

Can I automatically create a Game Design Document from gameplay source code?

Yes, you can automatically create a Game Design Document from gameplay source code by analyzing existing mechanics and implementation details to derive the original design rationale and structured intent.

What is the best way to document the 'why' behind an undocumented codebase?

The best way to document the 'why' behind an undocumented codebase is reverse-engineering the implementation to extract architecture decisions and mechanics, generating structured ADRs or GDDs for onboarding and maintenance.

How do I write an Architecture Decision Record for a core system that already exists?

Write an Architecture Decision Record for an existing core system by analyzing the implementation to identify architectural choices, then structuring the extracted rationale and design intent into a clear, documented record.

Does reverse-document work with both core systems and gameplay layers?

Yes, reverse-document works with both core systems and gameplay layers, applying code analysis across architecture layers to extract mechanics and decisions, generating either a Game Design Document or an Architecture Decision Record.