recipe-reverse-engineer

Generate PRDs and Design Docs from codebases through agent-coordinated discovery and review.

29|4|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/shinpr/codex-workflows --skill recipe-reverse-engineer-shinpr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-reverse-engineer
Source: https://github.com/shinpr/codex-workflows/tree/main/.agents/skills/recipe-reverse-engineer
Command: npx skills add https://github.com/shinpr/codex-workflows --skill recipe-reverse-engineer-shinpr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Replacing messy, undocumented codebases with clear PRDs and Design Docs to align engineering work with product goals and governance.

Core Features & Use Cases

  • Orchestrates a multi-phase workflow that converts code into PRD and Design Docs.
  • Performs discovery, verification, review, and revision with agent coordination.
  • Supports Phase 2 Design Doc generation and traceability from source units to design artifacts.

Quick Start

Provide the target project path and desired scope to automatically generate PRD and Design Docs from the codebase.

Frequently Asked Questions about recipe-reverse-engineer

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

FAQPage Schema
How do I generate PRDs and design docs from an existing codebase?

To generate PRDs and design docs from a codebase, you provide the target project path and desired scope to trigger an automated multi-phase workflow that reverse-engineers code into traceable product requirement documents and architectural design artifacts.

Can I reverse-engineer a large undocumented repository to map current architecture?

Yes, you can reverse-engineer large undocumented repositories by orchestrating multi-step discovery, verification, review, and revision agents to map the current implementation and produce evidence-based architectural documentation.

How does code to documentation automation ensure traceability to source units?

Code to documentation automation ensures traceability by coordinating agents throughout the discovery and review phases, linking generated design doc artifacts directly back to their originating source code units within the repository.

What is the best way to align formal documentation with existing implementation in mid-size projects?

The best way to align formal documentation with existing implementation in mid-size projects is applying an automated reverse-engineering workflow that verifies code structure and revises outputs to accurately reflect the current product architecture.

Does automated PRD generation work for repositories lacking formal documentation?

Yes, automated PRD generation works for undocumented repositories by replacing messy codebases with clear PRDs and design docs, orchestrating agent-driven discovery to produce evidence-based documentation that aligns engineering work with product goals.

When should I not use automated reverse-engineering for documentation?

You should not use automated reverse-engineering for documentation on very small codebases or when formal documentation does not need to reflect the current implementation and architecture of mid-size to large repositories.