reverse-document

Generate design or architecture documentation from existing code or prototypes.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/dnkrow/skill --skill reverse-document-dnkrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-document
Source: https://github.com/dnkrow/skill/tree/main/claude-global/reverse-document
Command: npx skills add https://github.com/dnkrow/skill --skill reverse-document-dnkrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you create missing design and architecture documentation by deriving intent, mechanics, and system decisions directly from existing implementation instead of guessing.

Core Features & Use Cases

  • Reverse-engineers design artifacts: Produces design documents, ADRs, or concept write-ups based on the current code/prototype behavior.
  • Extracts mechanics, formulas, and patterns: Identifies gameplay rules for design docs and technical decisions for ADRs (including dependencies and trade-offs).
  • Clarifies intent before drafting: Asks targeted questions about “why” to avoid documenting incorrect assumptions.

Use cases: recovering documentation after shipping features, onboarding to an unfamiliar codebase, formalizing a prototype into a structured spec, and documenting architectural decisions from evolving systems.

Quick Start

Ask the skill to reverse-document your current implementation by running: /reverse-document design src/gameplay/magic-system

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?

You generate architecture documentation from existing code by analyzing implementation patterns and dependencies to produce structured artifacts. This skill evaluates mechanics and trade-offs directly from the codebase to draft the records.

What is the best way to create a game design document from a prototype?

Creating a game design document from a prototype involves analyzing prototype directories to extract gameplay rules and formulas. This skill identifies mechanics from the implementation and formalizes them into a structured design spec.

Can I recover missing design docs for a shipped feature?

Yes, you can recover missing design docs for a shipped feature by reverse-engineering the current implementation. The skill derives intent and system decisions directly from the code, asking targeted questions to clarify original goals before drafting.

How do you reverse engineer an architecture decision record from an evolving system?

To reverse engineer an architecture decision record from an evolving system, the skill extracts technical decisions, dependencies, and trade-offs from the current code. It asks clarification questions about original intent to avoid documenting incorrect assumptions.

Does reverse-documenting work for onboarding to an unfamiliar codebase?

Reverse-documenting works for onboarding to an unfamiliar codebase by generating concept documents and design write-ups from existing implementation behavior. It clarifies mechanics and architectural decisions without requiring prior system knowledge.