Skip to content

stribus/pygerengastos / .agents/skills/reversa

reversa

Verified

Ponto de entrada principal do Reversa. Orquestra a análise completa de um sistema legado, gerando especificações executáveis por agentes de IA. Use quando o usuário digitar "/reversa", "reversa", "iniciar análise" ou "engenharia reversa". É o primeiro skill a ser chamado em qualquer sessão.

references/step-02-resume.md

View on GitHub
# Passo 2 — Retomada de sessão

## 0. Verificação de migração em andamento

Antes de tudo, leia `.reversa/state.json` apenas para resolver `output_folder` (padrão `_reversa_sdd`).

Verifique se `<output_folder>/migration/.state.json` existe. Se não existir, pule esta seção e siga para a seção 1.

Se existir, leia o arquivo e classifique o estado da migração:

| Condição | Estado |
|----------|--------|
| `pendingAgents.length > 0` ou `currentAgent.agent` diferente de `null` | em andamento |
| `currentAgent.status == "awaiting_user_approval"` | pausa intra-agente pendente |
| `pendingAgents.length == 0`, `currentAgent.agent == null` e `<output_folder>/migration/handoff.md` existe | concluída |

Se o estado for **concluída**, pule esta seção (a migração já terminou, nada a perguntar) e siga para a seção 1.

Se o estado for **em andamento** ou **pausa intra-agente pendente**, apresente a pergunta ao usuário antes de qualquer outra coisa:

> "[Nome], encontrei uma **migração em andamento** em `<output_folder>/migration/`.
>
> - Concluído: <N> de 6 agentes (<lista de completedAgents>)
> - Pendente: <lista de pendingAgents>
> - Estado atual: <currentAgent.agent ou \"aguardando aprovação humana\">
>
> Como prefere continuar:
>
> 1. **Retomar a migração**: volta ao Time de Migração de onde parou
> 2. **Retomar o fluxo do Reversa**: segue descoberta/forward, ignora migração por agora
> 3. **Cancelar**: encerra esta sessão sem mudar nada
> 4. **Outro**: descreva o que prefere fazer
>
> Use o mecanismo de menu interativo da engine (no Claude Code, `AskUserQuestion`); em engines sem suporte a menu, peça que o usuário digite o número 1–4 ou texto livre."

Aguarde a resposta. NÃO escolha por conta própria.

- Se **1**: encerre o `/reversa` aqui com a instrução final:
  > "Para retomar a migração, digite `/reversa-migrate`. Ele detecta o estado salvo e oferece as opções de retomada."
  
  NÃO ative `reversa-migrate` automaticamente, deixe o usuário digitar (padrão de handoff explícito do Reversa).
- Se **2**: prossiga com a seção 1 deste passo normalmente.
- Se **3**: encerre sem fazer nada.
- Se **4** (texto livre): interprete a intenção do usuário e ofereça a melhor rota possível, sem inventar fluxos novos. Se a intenção for ambígua, refaça a pergunta uma vez antes de decidir.

## 1. Leitura do estado

Leia `.reversa/state.json` e `.reversa/plan.md`.

## 2. Verificação de versão

Compare `.reversa/version` com o npm registry. Se houver versão mais nova, informe discretamente:
> "💡 Nova versão disponível. Execute `npx reversa update` quando quiser atualizar."

## 3. Saudação

Diga: "[Nome], bem-vindo de volta ao Reversa! 🎼"

## 4. Resumo de progresso

Mostre:
- ✅ Fases concluídas (campo `completed` do state.json)
- 🔄 Fase atual (campo `phase`) com a última tarefa registrada em `checkpoints`
- ⏳ Próximas fases (campo `pending`)

Exemplo:
> "Progresso atual:
> ✅ Reconhecimento concluído
> 🔄 Escavação em andamento — módulos `auth` e `orders` analisados, `payments` e `users` pendentes
> ⏳ Interpretação, Geração, Revisão"

## 5. Modo de resposta a lacunas

Se `answer_mode` for `"file"`:
> "Lembre-se: suas respostas às perguntas devem ser preenchidas em `_reversa_sdd/questions.md`. Me avise quando terminar."

Se `answer_mode` for `"chat"` (padrão):
> Continue normalmente — farei as perguntas aqui no chat.

## 6. Confirmação

Pergunte apenas: "Continuamos de onde paramos? (CONTINUAR para seguir)"

Após confirmação, retome a próxima tarefa pendente no plano (`.reversa/plan.md`).

**🚫 Não ofereça `/clear` + `/reversa` neste momento.** O usuário acabou de retomar a sessão; pedir para limpar e reabrir agora é redundante. O prompt de pausa entre etapas (descrito em `SKILL.md`, seção "Checkpoint preventivo entre etapas") só vale **depois** que um agente concluir trabalho dentro desta sessão, nunca na própria saudação de retomada.

Consulte `references/checkpoint-guide.md` para as regras de escrita no state.json.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall