reversa-writer

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning knowledge extracted from a legacy codebase into formal, traceable specifications is slow and inconsistent. This Skill converts reverse-engineering findings into operational contracts that an AI agent could use to reimplement the system 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: Every claim is marked as confirmed, inferred, or a gap, and each task cites the legacy source file it was derived from. - Incremental, checkpointed workflow: Generates one file at a time with user confirmation, saves progress to state.json, and suggests preventive pauses on long sessions. - Use Case: After scanning a legacy monolith with the Reversa framework, use this Skill to produce a complete spec tree including OpenAPI definitions, user stories, and a code-to-spec traceability matrix. ## Quick Start Ask the agent to generate the executable specifications for the analyzed legacy system following the granularity defined in the reversa config.

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 of a Reversa reverse-engineering workflow. It reads state.json, config.toml, and surface.json, then produces requirements.md, design.md, and tasks.md per unit, one file at a time with your confirmation.

What granularity options exist for organizing generated specs?▼

Units can be organized by module, endpoint, use-case, hybrid (modules with nested use cases), feature, or custom folders. The granularity is set in the [specs] section of config.toml and determines how units are enumerated.

Does the reversa-writer skill work with Claude Code and other agents?▼

Yes, it declares compatibility with Claude Code, Codex, Cursor, Gemini CLI, and other agents supporting the Agent Skills format. It only requires the Reversa framework artifacts to be present in the project.

Why does the skill generate files one at a time instead of all at once?▼

Generating everything in a single response consumes excessive context, lowers quality, and blocks incremental review. The one-file-at-a-time flow with checkpoints in state.json lets you review, adjust, or resume after a session reset.

What happens if a unit folder already exists in the output directory?▼

The Skill follows a non-destructive directive: it preserves existing content, adds only missing files, and never overwrites canonical files without confirmation. Existing folders are reused rather than recreated.