reversa-plan

Generate a technical roadmap as a delta over legacy architecture from active requirements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolve o gap entre requirements e implementação ao transformar a descrição funcional em um plano técnico concreto, especificando delta arquitetural, delta de dados, migração, riscos e contratos impactados.

Core Features & Use Cases

  • Tradução de requirements em proposta técnica: converte requirements.md da feature ativa em roadmap.md com decisões, delta do legado e critérios de pronto.
  • Delta de arquitetura e dados: descreve alterações e migrações necessárias sobre os artefatos _reversa_sdd/* (componentes, dependências, state machines e princípios).
  • Interfaces por contrato externo: cria interfaces/<nome>.md quando a feature afetar contratos externos (HTTP/fila/gRPC/GraphQL), incluindo request/response, erros e idempotência.

Quick Start

Use a command reversa-plan para esboçar o plano técnico da feature ativa em delta do legado.

Frequently Asked Questions about reversa-plan

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

FAQPage Schema
How do I translate active requirements into a technical roadmap for a legacy system?

To translate active requirements into a technical roadmap, you validate functional descriptions and apply them as an architectural delta over existing legacy artifacts, producing a concrete implementation plan with data migrations and risk assessments.

What is a legacy delta in technical planning?

A legacy delta in technical planning is the specific architectural and data alteration applied over existing legacy components, detailing required migrations and state machine changes rather than rebuilding the entire system architecture from scratch.

How do I handle external contract interfaces when planning feature migrations?

When planning feature migrations affecting external contract interfaces, you generate dedicated interface files specifying request and response schemas, error handling, and idempotency rules for HTTP, queue, gRPC, or GraphQL protocols.

Can I validate requirement doubts before generating an implementation plan?

Yes, you can validate requirement doubts before implementation planning by checking for specific doubt markers within active requirements, ensuring all open questions are resolved before the technical roadmap is generated.

How do I plan data migrations across existing legacy architecture artifacts?

To plan data migrations across legacy architecture artifacts, you assess the impact of active requirements on existing components and dependencies, outputting a data-delta document that describes the necessary alterations and migration steps.

What is the best way to document architecture changes for a new feature?

The best way to document architecture changes for a new feature is generating a technical roadmap that captures implementation decisions, legacy architectural deltas, data migrations, and explicit ready criteria based on validated requirements.