weapp-reverse-engineering

Generate architecture documents, Mermaid ER diagrams, and OpenAPI specs from Django codebases.

1|Updated Mar 11, 2026

Search Tags:#architecture #documentation #mermaid #openapi #django #drf #reverse-engineering

Ready to run

npx skills add https://github.com/hekinami/weapp-dev-workflow --skill weapp-reverse-engineering

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: weapp-reverse-engineering
Source: https://github.com/hekinami/weapp-dev-workflow/tree/main/skills/weapp-reverse-engineering
Command: npx skills add https://github.com/hekinami/weapp-dev-workflow --skill weapp-reverse-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns an existing Django + DRF project into up-to-date architecture, data model, and API documentation when source code exists but documentation is missing or stale.

Core Features & Use Cases

Project Structure Analysis: Reviews backend and frontend layout to identify apps, modules, and deployment assumptions.
Model Reverse Engineering: Converts Django models and relationships into Mermaid ER diagrams.
API Reverse Engineering: Maps DRF viewsets and routes into OpenAPI 3.0 documentation.
Use Case: Use it when onboarding a legacy app, rebuilding documentation after code drift, or preparing a first-pass technical spec for an existing project.

Quick Start

Ask this skill to inspect your existing Django project and generate the architecture, Mermaid model diagram, and OpenAPI documentation.

Frequently Asked Questions about weapp-reverse-engineering

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

FAQPage Schema

How do I generate architecture documentation from an existing Django project?▼

This Skill reverse engineers existing Django codebases by inspecting models, viewsets, and routes to generate architecture documents. It applies code-first precedence over outdated documentation, requiring user confirmation for uncertain elements during structural analysis.

Can I automatically create Mermaid ER diagrams from Django models?▼

Yes, you can automatically generate Mermaid ER diagrams from Django models. The reverse engineering process extracts model definitions and their relationships directly from the source code, converting them into visual entity-relationship diagrams for existing projects.

What is the best way to generate OpenAPI specifications from Django REST Framework code?▼

The best way to generate OpenAPI specifications from Django REST Framework code is through API reverse engineering. This approach maps DRF viewsets and routes directly into OpenAPI 3.0 documentation, ensuring the spec matches the actual implementation.

Does this approach work for reverse engineering a legacy Django REST Framework project?▼

Yes, this approach works for reverse engineering a legacy Django REST Framework project by analyzing the existing source code. It handles onboarding legacy apps and rebuilding documentation after code drift by taking code-first precedence over outdated specs.

How do I map DRF viewsets and routes into OpenAPI 3.0 documentation?▼

You map DRF viewsets and routes into OpenAPI 3.0 documentation by inspecting the routing logic and viewset definitions in the codebase. The reverse engineering process requires accurate routing inspection with user confirmation to ensure endpoint mapping accuracy.

What happens if the existing documentation contradicts the Django source code?▼

If existing documentation contradicts the Django source code, the reverse engineering process applies code-first precedence. It relies on accurate model, viewset, and routing inspection from the actual codebase, making conservative inferences for uncertain elements.