reversa-plan

Convert legacy requirements.md into a delta-based technical roadmap with investigation artifacts.

1.5k|383|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-plan-sandeco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-plan
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-plan
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-plan-sandeco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts a feature’s requirements.md into a concrete technical plan expressed as a delta against what already exists in the legacy codebase, so AI agents can implement changes safely and traceably.

Core Features & Use Cases

  • Delta-based technical planning: Produces roadmap.md that summarizes approach, architectural delta, data delta, contract delta, migration plan, risks, and “criterion of pronto”.
  • Legacy impact aware artifacts: Reads the Reversa pipeline context (selected _reversa_sdd/* artifacts plus .reversa/principles.md) and prepares an impact list that will feed later /reversa-coding.
  • External contract interface generation: Creates interfaces/<nome>.md files per affected external contract (HTTP, queue, gRPC, GraphQL) including request/response, errors, idempotency, and timeouts.
  • Doubt-aware planning: Detects [DÚVIDA] markers in requirements.md, routes clarification via /reversa-clarify, and—if confirmed—turns each doubt into explicit roadmap premises.

Quick Start

Run the skill by asking your agent: “/reversa-plan”.

Frequently Asked Questions about reversa-plan

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

FAQPage Schema
How do I generate a technical roadmap delta from legacy requirements for AI coding agents?

To generate a technical roadmap delta, translate a legacy `requirements.md` into a delta-based plan that summarizes architectural, data, and contract changes against the existing codebase. This produces a `roadmap.md` file that AI agents use to implement modifications safely and traceably.

How does doubt-aware planning handle unresolved requirements during legacy modernization?

Doubt-aware planning detects `[DÚVIDA]` markers inside `requirements.md` during legacy modernization. It routes these items to a clarification process and, once resolved, converts each confirmed doubt into explicit premises within the final technical roadmap.

Can I generate external interface contracts for HTTP and gRPC from feature requirements?

Yes, you can generate external interface contracts for HTTP, gRPC, GraphQL, and queues. The process creates individual `interfaces/<nome>.md` files per affected contract, detailing request/response schemas, errors, idempotency rules, and timeouts.

What is the best way to plan data schema changes when modernizing a legacy codebase?

The best way to plan data schema changes is by producing a `data-delta.md` artifact alongside the technical roadmap. This data delta maps structural modifications against the existing legacy state, ensuring AI agents understand migration requirements and risks.

Do I need a state file to start delta-based technical planning?

Yes, delta-based technical planning requires reading `.reversa/state.json` and `.reversa/active-requirements.json` to validate active requirements. It also applies `before-plan` hooks and reads `.reversa/principles.md` to establish context.