reversa-writer

Generates executable reverse-engineering specifications as per-unit folders with requirements, design, and tasks files.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-writer-lacsousa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-writer
Source: https://github.com/lacsousa/mediclaw-system/tree/main/.agents/skills/reversa-writer
Command: npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-writer-lacsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineered knowledge about a legacy system is often scattered and unstructured, making it impossible to reimplement the system faithfully. This Skill converts extracted legacy knowledge into formal, traceable specifications organized as folder-per-unit, each containing requirements.md, design.md, and tasks.md contracts detailed enough for an AI agent to reimplement the functionality without access to the original code. ## Core Features & Use Cases - Granularity-aware unit planning: Resolves spec units from modules, endpoints, use cases, features, hybrid layouts, or custom folders based on the reversa config.toml settings. - Incremental, checkpointed generation: Produces one file at a time with user confirmation, saves progress to .reversa/state.json, and suggests preventive pauses after every 3 units to preserve quality in long sessions. - Confidence-tagged traceability: Marks every statement as confirmed, inferred, or gap, and emits global artifacts like OpenAPI specs, user stories, and a code-spec traceability matrix. - Use Case: After running the earlier Reversa analysis phases on a legacy codebase, invoke this Skill to produce a complete specification tree where each module gets requirements with MoSCoW prioritization, a technical design with interface tables, and an executable task list citing legacy source files. ## Quick Start Run the reversa-writer generation phase to turn the analyzed legacy system into per-unit specification folders with requirements, design, and tasks files.

Frequently Asked Questions about reversa-writer

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

FAQPage Schema
How do I generate specifications from a legacy codebase analysis?▼

Run this Skill during the generation phase after earlier Reversa agents have produced surface.json and context artifacts. It builds a plan of units based on the configured granularity, then generates requirements.md, design.md, and tasks.md per unit, one file at a time with your confirmation.

What granularity options exist for organizing reverse engineering specs?▼

Six granularities are supported: module, endpoint, use-case, hybrid, feature, and custom. The choice comes from the [specs] section of .reversa/config.toml, and each unit always receives the three canonical files plus optional artifacts like contracts.md or edge-cases.md.

Can I resume spec generation after clearing the chat session?▼

Yes. Progress is saved to the redator_progress field in .reversa/state.json after every file. After three units the Skill suggests pausing with /clear and resuming via /reversa in a fresh session, picking up exactly where it stopped.

Does the writer overwrite existing specification files?▼

No. It follows a non-destructive directive: existing unit folders are preserved, only missing files are added, and pre-existing canonical files are left untouched with a notice to the user.

What are the limitations of generated reverse engineering specs?▼

Statements not directly confirmed in code are tagged as inferred or gaps requiring human validation. Non-functional requirements are only included when evidence exists in the code, so specs may omit qualities the legacy system never made explicit.