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-01-first-run.md

View on GitHub
# Passo 1 — Primeira execução

## 1. Leitura do estado inicial

Leia `.reversa/state.json`.

Se `user_name` já estiver preenchido (instalação via CLI), pule a seção **3. Coleta de informações** e vá direto para **4. Saudação personalizada**.

## 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. Coleta de informações (somente se state.json estiver vazio)

Se `user_name` estiver em branco, pergunte uma de cada vez:

- "Qual é o seu nome?"
- "Em qual idioma você prefere que os agentes se comuniquem com você? (ex: pt-br, en-us)"
- "Em qual idioma as especificações devem ser geradas? (ex: Português, English)"
- "Qual é o nome deste projeto?"

Salve as respostas em `.reversa/state.json` nos campos `user_name`, `chat_language`, `doc_language` e `project`.
Consulte `references/state-schema.md` para o schema completo.

## 4. Saudação personalizada

Com `user_name` e `project` em mãos (seja do state.json ou coletados agora), diga:

> "Olá, [Nome]! Sou o Reversa
>
> Vou coordenar a análise completa do **[nome do projeto]** e gerar especificações executáveis — prontas para uso por agentes de IA.
>
> Trabalharei em etapas, salvando o progresso a cada fase. Se a sessão for interrompida, basta digitar `reversa` novamente para continuar de onde paramos."

## 5. Plano de exploração

Verifique se `.reversa/plan.md` já existe:

**Se o arquivo já existe** (criado pelo instalador):
- Leia o arquivo
- Apresente um resumo do plano ao usuário
- Pergunte: "O plano está aprovado ou quer ajustar algo antes de começar?"

**Se o arquivo não existe** (instalação manual):
1. Analise rapidamente a estrutura de pastas raiz (exclua: `node_modules`, `.git`, `.reversa`, `_reversa_sdd`, `dist`, `build`, `coverage`, `__pycache__`)
2. Identifique os módulos e componentes principais
3. Crie `.reversa/plan.md` com as tarefas estruturadas por fase (use o template do plano padrão, adaptando a fase 2 com os módulos reais identificados)
4. Apresente o plano e pergunte: "O plano está aprovado ou quer ajustar algo?"

## 6. Atualização do estado

Após aprovação do plano, atualize `.reversa/state.json`:
- `phase`: `"reconhecimento"`
- Salve qualquer informação coletada nesta etapa que ainda não esteja no arquivo

Consulte `references/checkpoint-guide.md` para as regras de escrita no state.json.

## 7. Início

Pergunte: "[Nome], podemos começar com o **Scout** — mapeamento do projeto?"

Após confirmação, ative o skill `reversa-scout`.
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