reverse-document

Convert existing code or prototypes into design and architecture documentation.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill reverse-document-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-document
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/reverse-document
Command: npx skills add https://github.com/easonlao/jiazi-game --skill reverse-document-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create missing design or architecture documentation by deriving intent and structure directly from existing implementation, so teams can align faster and reduce tribal knowledge.

Core Features & Use Cases

  • Reverse-engineer GDD sections: Extract mechanics, values, formulas, state interactions, edge cases, and system dependencies from a codebase to produce a design document.
  • Generate ADRs from technical patterns: Identify architecture decisions, patterns, coupling, constraints, and trade-offs from implementation to formalize why things were built a certain way.
  • Create concept docs from prototypes: Convert prototype behavior into a player-facing mechanic/feel description and capture what worked, what didn’t, and feasibility insights.

Quick Start

Ask the Skill to reverse-document an existing system by telling it the doc type and the path to the code you want analyzed.

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 an undocumented codebase?

You can generate design documentation by reverse-engineering the codebase to extract mechanics, formulas, patterns, and dependencies. This process uses interactive intent clarification and template-based drafting to produce traceable design docs that capture implied system behavior.

What is the best way to create architecture decision records from existing code?

The best way to create ADRs from existing code is reverse-engineering technical patterns to identify architecture decisions, coupling, constraints, and trade-offs. This formalizes why things were built a certain way, converting implied implementation choices into traceable records.

How do I convert prototype behavior into a concept doc for planning?

You convert prototype behavior into a concept doc by analyzing the prototype to extract mechanic and feel descriptions, capturing what worked, what failed, and feasibility insights. This clarifies implied intent and transitions prototype analysis into structured planning documentation.

Can I extract game design document sections directly from source code?

Yes, you can extract game design document sections by analyzing source code to derive mechanics, values, state interactions, system dependencies, and edge cases. This reverse-engineering process requires interactive intent clarification to ensure the drafted GDD matches actual mechanics.

Does reverse-documenting an inherited codebase require manual intent clarification?

Yes, reverse-documenting an inherited codebase requires interactive intent clarification to accurately capture implied behavior behind current implementation. The process uses controlled writing with approval to ensure extracted mechanics, formulas, and patterns produce traceable documents that reduce tribal knowledge.