reverse-document

Generate GDD sections and ADRs from existing code and prototypes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates design or architecture documentation by analyzing existing implementation and prototypes, transforming scattered code comments and knowledge into formal planning docs.

Core Features & Use Cases

  • Analyze codebases and prototypes to produce GDD sections and ADRs.
  • Create reverse-engineered documentation for legacy systems, onboarding, and feature retrospectives.
  • Output artifacts suitable for collaboration and version control (design docs, ADRs, and concept notes).

Quick Start

Run the reverse-document command with a type and path to generate the corresponding design artifact.

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 code?

To generate design documentation from existing code, you can scan codebases or prototypes to automatically produce formal design docs and architecture decision records. This process analyzes scattered implementation details to create structured planning artifacts for collaboration.

What is the best way to create ADRs for a legacy codebase with missing planning docs?

The best way to create ADRs for a legacy codebase with missing planning docs is to reverse-engineer the architecture by scanning the existing implementation. This automatically extracts design decisions and concepts to output formal ADRs suitable for version control.

Can I use code analysis to produce a GDD for prototyped features?

Yes, you can use code analysis to produce a GDD for prototyped features. By scanning the prototype implementation, the system reverse-engineers the code structure and logic to generate formal Game Design Documents and concept notes for retrospectives.

How does reverse-engineering documentation work for onboarding to architecture?

Reverse-engineering documentation for onboarding works by scanning existing code to extract architectural patterns and design concepts. It transforms scattered knowledge into structured ADRs and design docs, helping new team members understand the system architecture without manual writing.

What are the limitations of automating architecture documentation from code?

Automating architecture documentation from code relies entirely on the existing implementation structure and comments. It cannot infer external business requirements or undocumented future planning contexts, limiting its output to the architectural decisions actually embedded in the current codebase.