stribus/pygerengastos / .agents/skills/reversa
reversa
VerifiedPonto 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.7 KB |
| references/checkpoint-guide.md | markdown | 2.5 KB |
| references/state-schema.md | markdown | 3.0 KB |
| references/step-01-first-run.md | markdown | 2.6 KB |
| references/step-02-resume.md | markdown | 4.0 KB |
| references/step-03-specs-organization.md | markdown | 7.7 KB |
| references/step-04-regression-check.md | markdown | 5.2 KB |
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`.
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: 472k | 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 |