reversa-writer

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

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-writer-ruggery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-writer
Source: https://github.com/Ruggery/OCR_Cartorio/tree/main/.agents/skills/reversa-writer
Command: npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-writer-ruggery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineering a legacy system into formal, traceable specifications is slow and inconsistent when done by hand. This Skill turns extracted knowledge about a legacy codebase into operational contracts that an AI agent could use to reimplement the system faithfully, without access to the original code. ## Core Features & Use Cases - Folder-per-unit spec generation: Creates requirements.md, design.md, and tasks.md for each unit, with the unit definition driven by configurable granularity (module, endpoint, use-case, hybrid, feature, or custom). - Confidence-tagged traceability: Marks every statement as confirmed, inferred, or a gap, and produces a code-to-spec traceability matrix plus optional OpenAPI and user-story artifacts. - Incremental, checkpointed workflow: Generates one file at a time with user confirmation, saves progress to state.json, and supports pause-and-resume across sessions. - Use Case: After running the earlier Reversa analysis phases on a legacy monolith, invoke this Skill to produce a complete specification tree where each module gets requirements, design, and implementation tasks linked back to the original source files. ## Quick Start Ask the agent to run the reversa-writer generation phase to produce the specification units from the existing Reversa analysis artifacts.

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

Run the Reversa analysis phases first to produce surface.json and context artifacts, then invoke this Skill. It builds a generation plan of units based on the configured granularity and creates requirements, design, and tasks files one at a time with your confirmation.

What files does the reversa-writer skill create per unit?▼

Each unit folder always contains requirements.md, design.md, and tasks.md. Depending on the documentation level and context, it can also add contracts.md, flows.md, edge-cases.md, decisions.md, questions.md, and tests.md.

What granularity options control how units are split?▼

The [specs] section of config.toml supports module, endpoint, use-case, hybrid, feature, and custom granularity. Hybrid nests use cases under modules, while custom uses folders you define in custom_folders.

Can I pause and resume the specification generation?▼

Yes. Progress is saved to the redator_progress field in .reversa/state.json after every file. After three or more units, the Skill suggests pausing, clearing the session, and resuming later without losing work.

Does the skill overwrite existing specification files?▼

No. It follows a non-destructive directive: existing unit folders and canonical files are preserved, only missing files are added, and nothing is overwritten without explicit confirmation.