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/state-schema.md
View on GitHub# Schema — .reversa/state.json
Este arquivo persiste o estado completo da análise entre sessões. O Reversa lê e escreve neste arquivo.
## Estrutura completa
```json
{
"version": "1.0.0",
"project": "nome-do-projeto",
"user_name": "Nome do Usuário",
"chat_language": "pt-br",
"doc_language": "Português",
"answer_mode": "chat",
"doc_level": null,
"output_folder": "_reversa_sdd",
"phase": "reconhecimento",
"completed": ["reconhecimento"],
"pending": ["escavacao", "interpretacao", "geracao", "revisao"],
"engines": ["claude-code"],
"agents": ["reversa", "reversa-scout", "reversa-archaeologist"],
"checkpoints": {
"scout": {
"completed_at": "2026-04-26T10:00:00Z",
"files": [
"_reversa_sdd/inventory.md",
"_reversa_sdd/dependencies.md",
".reversa/context/surface.json"
]
},
"archaeologist": {
"completed_at": "2026-04-26T11:00:00Z",
"modules_analyzed": ["auth", "orders", "payments"],
"files": [
"_reversa_sdd/code-analysis.md",
"_reversa_sdd/data-dictionary.md",
".reversa/context/modules.json"
]
}
},
"created_files": [
"CLAUDE.md",
".agents/skills/reversa/SKILL.md",
".reversa/state.json",
".reversa/plan.md"
]
}
```
## Campos
| Campo | Tipo | Descrição |
|-------|------|-----------|
| `version` | string | Versão do Reversa instalada |
| `project` | string | Nome do projeto legado |
| `user_name` | string | Nome do usuário (para interações) |
| `chat_language` | string | Idioma das interações (ex: pt-br, en-us) |
| `doc_language` | string | Idioma das specs geradas (ex: Português, English) |
| `answer_mode` | string | Como o usuário responde às lacunas: `chat` ou `file` |
| `doc_level` | string \| null | Volume de documentação gerada: `essencial`, `completo` ou `detalhado`. Começa `null` — obrigatório preencher via escolha do usuário após o Scout. |
| `output_folder` | string | Pasta de saída das specs (padrão: `_reversa_sdd`) |
| `phase` | string \| null | Fase atual. `null` = não iniciado |
| `completed` | string[] | Fases concluídas |
| `pending` | string[] | Fases pendentes |
| `checkpoints` | object | Registro de conclusão de cada agente |
| `engines` | string[] | Engines configuradas (ex: `["claude-code", "codex"]`) |
| `agents` | string[] | Agentes instalados |
| `created_files` | string[] | Todos os arquivos criados pelo Reversa (para uninstall seguro) |
## Fases válidas
`reconhecimento` → `escavacao` → `interpretacao` → `geracao` → `revisao`
## Regra ao escrever
Nunca remova campos existentes. Apenas adicione ou atualize.
## Onde NÃO escrever
A decisão de organização das specs (granularidade, pastas customizadas, sugestão original do Scout, timestamp da escolha) **não** vai no `state.json`. Ela é persistida em `.reversa/config.toml`, seção `[specs]`, conforme `references/step-03-specs-organization.md`. O `state.json` é estado runtime, o `config.toml` é decisão de longo prazo.
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 |