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/checkpoint-guide.md
View on GitHub# Guia de Checkpoints — .reversa/state.json
O Reversa é o único agente que **escreve** no state.json. Os demais agentes apenas leem.
## Regras absolutas
1. **Nunca remova campos existentes.** Apenas adicione ou atualize.
2. **Sempre leia o arquivo antes de escrever** — outro agente pode ter atualizado `checkpoints`.
3. **Salve após cada fase concluída**, não apenas no final.
4. **Em caso de estouro de contexto**, salve imediatamente antes de pausar.
## O que salvar a cada fase
### Ao iniciar uma fase
```json
{
"phase": "reconhecimento"
}
```
### Ao concluir um agente
```json
{
"checkpoints": {
"scout": {
"completed_at": "2026-04-26T10:30:00Z",
"files": [
"_reversa_sdd/inventory.md",
"_reversa_sdd/dependencies.md",
".reversa/context/surface.json"
]
}
}
}
```
### Ao concluir uma fase inteira
```json
{
"phase": "escavacao",
"completed": ["reconhecimento"],
"pending": ["escavacao", "interpretacao", "geracao", "revisao"]
}
```
### Ao marcar uma tarefa parcial do Archaeologist
```json
{
"checkpoints": {
"archaeologist": {
"modules_analyzed": ["auth", "orders"],
"modules_pending": ["payments", "users"]
}
}
}
```
## Sequência de fases
```
null → reconhecimento → escavacao → interpretacao → geracao → revisao
```
Ao mover de fase:
- Retire a fase concluída de `pending` e adicione a `completed`
- Atualize `phase` para a próxima fase
## Exemplo de state.json com análise em andamento
```json
{
"version": "1.0.0",
"project": "meu-sistema",
"user_name": "Ana",
"chat_language": "pt-br",
"doc_language": "Português",
"answer_mode": "chat",
"output_folder": "_reversa_sdd",
"phase": "escavacao",
"completed": ["reconhecimento"],
"pending": ["escavacao", "interpretacao", "geracao", "revisao"],
"checkpoints": {
"scout": {
"completed_at": "2026-04-26T10:30:00Z",
"files": [
"_reversa_sdd/inventory.md",
"_reversa_sdd/dependencies.md",
".reversa/context/surface.json"
]
},
"archaeologist": {
"modules_analyzed": ["auth", "orders"],
"modules_pending": ["payments", "users"]
}
},
"engines": ["claude-code"],
"agents": ["reversa", "reversa-scout", "reversa-archaeologist"],
"created_files": []
}
```
## Mensagem de pausa por estouro de contexto
Se o contexto estiver se esgotando, salve o checkpoint atual e diga:
> "[Nome], vou pausar aqui para preservar o contexto. Tudo está salvo em `.reversa/state.json`. Digite `reversa` em uma nova sessão para continuar de onde paramos."
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 |