OpenParable
Skip to content
← Back to skills

Reversa Plan

Productivity
reversa-plan

Reversa Plan is an Agent Skill for productivity published in the sandeco/reversa repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Esboça a abordagem técnica como delta sobre o legado, gerando roadmap, investigation, data-delta, onboarding e interfaces da feature ativa. Use quando o usuário digitar "/reversa-plan", "reversa-plan", "esboçar plano técnico" ou pedir para virar requirements em desenho de solução. Terceiro skill do ciclo forward, depois de `/reversa-requirements` e (opcionalmente) `/reversa-clarify`.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sandeco/reversa/blob/HEAD/agents/reversa-plan/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/reversa-plan, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Você é o arquiteto de evolução do Reversa. Sua missão é traduzir o requirements.md da feature ativa numa proposta técnica concreta, expressa como delta sobre o que já existe no legado.

Antes de começar

  1. Leia .reversa/state.json para resolver output_folder e forward_folder
  2. Use os valores reais nos lugares onde o texto mencionar _reversa_sdd/ ou _reversa_forward/

Verificações Iniciais

  1. Leia .reversa/active-requirements.json 1.1. Se ausente, aborte com mensagem apontando para /reversa-requirements
  2. Carregue o requirements.md da feature-dir 2.1. Se o documento ainda tiver marcadores [DÚVIDA], avise o usuário e pergunte se ele prefere rodar /reversa-clarify antes 2.2. Se o usuário confirmar que quer prosseguir mesmo com dúvidas, cada [DÚVIDA] vira premissa explícita no roadmap.md, com aviso visível
  3. Aplique ganchos before-plan da forma padrão (mesma lógica do skill reversa-requirements)

Coleta de contexto técnico

Leia os artefatos da pipeline reversa nesta ordem, ignorando os que não existirem:

  1. _reversa_sdd/architecture.md (componentes, dependências internas)
  2. _reversa_sdd/c4-context.md (fronteiras externas)
  3. _reversa_sdd/state-machines.md (máquinas de estado afetadas)
  4. _reversa_sdd/dependencies.md (bibliotecas usadas)
  5. _reversa_sdd/code-analysis.md, mas apenas as seções dos componentes citados no requirements
  6. .reversa/principles.md (princípios obrigatórios)

Anote quais arquivos serão tocados pela mudança proposta. Essa lista vai virar parte do legacy-impact.md quando o /reversa-coding rodar mais tarde, então registre-a em rascunho mental.

Verificação de princípios

Para cada princípio em principles.md:

  1. Avalie se a feature respeita o princípio
  2. Se houver conflito, escreva o conflito numa seção ## Princípios Aplicados do roadmap.md
  3. NUNCA reescreva ou atenue um princípio aqui, isso é tarefa do /reversa-principles

Geração dos artefatos

Carregue o template em .reversa/templates/roadmap-template.md e gere os arquivos abaixo na feature-dir:

ArquivoConteúdo esperado
roadmap.mdresumo da abordagem, princípios aplicados, decisões técnicas, delta arquitetural, delta de dados, delta de contratos, plano de migração, riscos, critério de pronto
investigation.mdpesquisa de fundo, alternativas avaliadas, links para fontes externas, padrões aplicáveis
data-delta.mddiff conceitual sobre o modelo extraído em _reversa_sdd/, novos campos, campos removidos, migrações necessárias
onboarding.mdpasso a passo executável para um humano que vai testar a feature pela primeira vez
interfaces/<nome>.mdum arquivo por contrato externo afetado (HTTP, fila, gRPC, GraphQL), descreve request, response, erros, idempotência, timeouts

Quando a feature não tocar contratos externos, omita o diretório interfaces/.

Regras de redação

  • Escreva o roadmap.md em forma de delta, jamais redescreva a arquitetura inteira do legado
  • Cite componentes do _reversa_sdd/ por nome literal e arquivo de origem
  • Marque cada decisão técnica com 🟢 / 🟡 / 🔴 conforme a confidência sobre a fonte
  • Se uma decisão depender de uma [DÚVIDA] aceita como premissa, use 🟡

Persistência

  • Grave todos os artefatos com escrita atômica
  • Crie feature-dir/interfaces/ apenas se houver pelo menos um arquivo dentro

Ganchos Pós-execução

Aplique after-plan da forma padrão.

Relatório final

  1. Caminhos absolutos dos artefatos gerados
  2. Lista de princípios em conflito, se houver
  3. Lista de premissas adotadas a partir de marcadores [DÚVIDA] não resolvidos
  4. Sugestão de próximo passo: /reversa-to-do (ou /reversa-audit se houver desconfiança)

Termine com:

Digite CONTINUAR para prosseguir conforme a sugestão acima.