reversa-reconstructor

Convert Reversa specifications into a bottom-up reconstruction plan and execute tasks on demand.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-reconstructor-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-reconstructor
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-reconstructor
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-reconstructor-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns Reversa-generated specifications into an executable bottom-up reconstruction plan, then implements each task on demand while minimizing context read to preserve tokens.

Core Features & Use Cases

  • Bottom-up reconstruction planning: Generates _reversa_sdd/reconstruction-plan.md from either original specs or migration specs, depending on what’s available and what you choose.
  • Interactive migration source selection: Detects whether _reversa_sdd/migration/handoff.md exists and asks you to choose between Specs originais, Specs da migração, or Outro (free-form).
  • Token-preserving execution mode: Reads only the files listed in each task’s Lê: field during execution, and stops to confirm whenever a 🔴 gap is found.

Quick Start

Invoke the skill using the activation command /reversa-reconstructor and then reply with INICIAR to create or continue the reconstruction plan.

Frequently Asked Questions about reversa-reconstructor

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

FAQPage Schema
How do I generate a bottom-up reconstruction plan from existing specification documents?

To generate a bottom-up reconstruction plan, the tool converts specifications stored in `_reversa_sdd/` into an executable `_reversa_sdd/reconstruction-plan.md` file. It requires strict preflight checks for required folders and files before creating the plan from the appropriate template.

How does token-preserving execution work during project rebuilding?

Token-preserving execution works by reading only the files explicitly listed in each task's `Lê:` field during implementation. This minimizes context reads to preserve tokens, stopping to confirm whenever a 🔴 gap is found in the specifications.

Can I use migration specifications to rebuild a project instead of original specs?

Yes, you can use migration specifications for project rebuilding. The tool detects if `_reversa_sdd/migration/handoff.md` exists and interactively asks you to choose between original specs, migration specs, or a free-form alternative source before generating the reconstruction plan.

What is needed before starting a specification-driven reconstruction?

Before starting a specification-driven reconstruction, you need valid Reversa-generated specifications located in `_reversa_sdd/` or `_reversa_sdd/migration/`. The tool enforces strict preflight checks for these required folders and files before allowing any planning or execution to proceed.

How do I implement tasks one at a time from a reconstruction plan?

You implement tasks one at a time by invoking the skill and replying with INICIAR to create or continue the reconstruction plan. The execution mode then processes tasks sequentially on demand, reading only per-task `Lê:` files to maintain token efficiency.