reverse-document

Generate design and architecture documentation from existing implementation.

18|5|Updated Nov 25, 2025
One-click install
npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill reverse-document-wsman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-document
Source: https://github.com/wsman/MY-DOGE-MICRO/tree/main/.agents/skills/reverse-document
Command: npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill reverse-document-wsman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn existing implementation into clear design, architecture, or concept documents when the original planning docs are missing or outdated. It is especially useful when you need to reconstruct intent from code, prototypes, or system behavior before making changes.

Core Features & Use Cases

  • Reverse documentation: Derives design docs, ADRs, or concept notes from source code and project artifacts.
  • Intent clarification workflow: Surfaces uncertain areas and asks targeted questions before drafting anything final.
  • Product and technical coverage: Supports API modules, CLI workflows, migrations, configuration surfaces, UI behavior, and core architecture decisions.
  • Use case: Analyze an existing service or command folder and produce a structured document that captures current behavior, assumptions, edge cases, and follow-up work.

Quick Start

Use reverse-document to analyze src/api/invoices and draft a product design document that captures the current behavior, unclear intent, and follow-up questions.

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 docs from existing source code?

Generate design docs from existing source code by reading local project artifacts, extracting behavior and patterns, and drafting a document that captures current behavior, assumptions, and edge cases. The process identifies unclear intent and asks clarifying questions before writing.

What is the best way to reverse-engineer an API module into architecture documentation?

Reverse-engineering an API module into architecture documentation involves analyzing the implementation folder to extract behavior, identify patterns, and produce a structured document covering current behavior, edge cases, and technical decisions. Uncertain areas are surfaced through targeted questions before finalizing.

Can I reconstruct architecture decision records from an existing codebase?

You can reconstruct architecture decision records from an existing codebase by analyzing source code and project artifacts to derive technical decisions. The workflow extracts behavior and assumptions, preparing a draft with clarifying questions before any write action.

How do I document CLI workflows when the original planning docs are missing?

Document CLI workflows when original planning docs are missing by reading local project artifacts to extract behavior and patterns. The process identifies unclear intent, drafts a concept note capturing current behavior, and asks targeted questions before finalizing.

Does reverse documentation work for analyzing migrations and UI behavior?

Reverse documentation works for analyzing migrations and UI behavior by reading local project artifacts to extract behavior, identify patterns, and prepare a draft document. It captures current behavior, assumptions, edge cases, and follow-up work before writing.

What are the limitations of reverse-engineering code into documentation?

A limitation of reverse-engineering code into documentation is that intent may remain unclear from implementation alone. The process requires reading local project artifacts and depends on asking clarifying questions to surface uncertain areas before drafting final design documents.