stribus/pygerengastos / .agents/skills/reversa-plan
reversa-plan
VerifiedEsboç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`.
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
- Leia
.reversa/state.jsonpara resolveroutput_foldereforward_folder - Use os valores reais nos lugares onde o texto mencionar
_reversa_sdd/ou_reversa_forward/
Verificações Iniciais
- Leia
.reversa/active-requirements.json1.1. Se ausente, aborte com mensagem apontando para/reversa-requirements - Carregue o
requirements.mddafeature-dir2.1. Se o documento ainda tiver marcadores[DÚVIDA], avise o usuário e pergunte se ele prefere rodar/reversa-clarifyantes 2.2. Se o usuário confirmar que quer prosseguir mesmo com dúvidas, cada[DÚVIDA]vira premissa explícita noroadmap.md, com aviso visível - Aplique ganchos
before-planda forma padrão (mesma lógica do skillreversa-requirements)
Coleta de contexto técnico
Leia os artefatos da pipeline reversa nesta ordem, ignorando os que não existirem:
_reversa_sdd/architecture.md(componentes, dependências internas)_reversa_sdd/c4-context.md(fronteiras externas)_reversa_sdd/state-machines.md(máquinas de estado afetadas)_reversa_sdd/dependencies.md(bibliotecas usadas)_reversa_sdd/code-analysis.md, mas apenas as seções dos componentes citados no requirements.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:
- Avalie se a feature respeita o princípio
- Se houver conflito, escreva o conflito numa seção
## Princípios Aplicadosdoroadmap.md - 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:
| Arquivo | Conteúdo esperado |
|---|---|
roadmap.md | resumo 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.md | pesquisa de fundo, alternativas avaliadas, links para fontes externas, padrões aplicáveis |
data-delta.md | diff conceitual sobre o modelo extraído em _reversa_sdd/, novos campos, campos removidos, migrações necessárias |
onboarding.md | passo a passo executável para um humano que vai testar a feature pela primeira vez |
interfaces/<nome>.md | um 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.mdem 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
- Caminhos absolutos dos artefatos gerados
- Lista de princípios em conflito, se houver
- Lista de premissas adotadas a partir de marcadores
[DÚVIDA]não resolvidos - Sugestão de próximo passo:
/reversa-to-do(ou/reversa-auditse houver desconfiança)
Termine com:
Digite CONTINUAR para prosseguir conforme a sugestão acima.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |