reversa-writer

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

1|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/tjsasakifln/extra-cli --skill reversa-writer-tjsasakifln
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-writer
Source: https://github.com/tjsasakifln/extra-cli/tree/main/.agents/skills/reversa-writer
Command: npx skills add https://github.com/tjsasakifln/extra-cli --skill reversa-writer-tjsasakifln

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reverse-engineering a legacy system produces scattered knowledge that is hard to act on. This Skill converts extracted legacy knowledge into formal, traceable specifications organized as one folder per unit, each containing requirements.md, design.md, and tasks.md, so an AI agent can reimplement functionality without access to the original code. ## Core Features & Use Cases - Folder-per-unit spec generation: Creates requirements.md, design.md, and tasks.md per unit, with granularity driven by config (module, endpoint, use-case, hybrid, feature, or custom). - Confidence-tagged traceability: Marks every statement as confirmed, inferred, or a gap, and links tasks and requirements back to legacy source files and line numbers. - 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 codebase, use this Skill to produce a complete specification tree, including optional contracts, OpenAPI definitions, user stories, and a code-to-spec traceability matrix. ## Quick Start Ask the agent to run the reversa-writer generation phase to produce the specification folders for all units identified in the prior reverse-engineering analysis.

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 after the earlier Reversa phases have produced state.json and surface.json. It builds a generation plan listing all units and files, waits for your confirmation, then writes requirements.md, design.md, and tasks.md one file at a time.

What is a folder-per-unit specification structure?▼

Each unit (module, endpoint, use case, or feature, depending on configured granularity) gets its own folder containing three canonical files: requirements.md, design.md, and tasks.md. Optional files like contracts.md, flows.md, and edge-cases.md are added based on documentation level.

Can I resume spec generation after clearing the session?▼

Yes. Progress is saved to the redator_progress field in .reversa/state.json after each file. After three or more units, the Skill suggests pausing, clearing the session, and resuming with the Reversa command in a fresh session.

Does the Skill overwrite existing specification files?▼

No. It follows a non-destructive directive: existing unit folders and canonical files are preserved, and only missing files are added. It never deletes, moves, or modifies pre-existing content in the output folder.

How are confidence levels used in generated specs?▼

Every statement is tagged as confirmed (green, verified in code), inferred (yellow), or a gap (red, requiring human validation). Non-functional requirements without code evidence are omitted rather than invented.