stribus/pygerengastos / .agents/skills/reversa-migrate
reversa-migrate
VerifiedOrquestrador do Time de Migração do Reversa. Conduz o pipeline de migração após o `/reversa` ter populado o _reversa_sdd/. Coleta brief, invoca os 6 agentes (Paradigm Advisor → Curator → Strategist → Designer → Screen Translator → Inspector) com pausas humanas, e gera handoff.md final. Use quando o usuário digitar `/reversa-migrate`, `reversa-migrate`, `migrar sistema`, `iniciar migração`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.9 KB |
| references/auto-defaults.md | markdown | 3.9 KB |
| references/expected_legacy_artifacts.yaml | config | 1.7 KB |
| references/handoff-checklist.md | markdown | 2.1 KB |
| references/state.json | config | 632 B |
| references/templates/ambiguity_log.md | markdown | 1.1 KB |
| references/templates/handoff.md | markdown | 5.1 KB |
| references/templates/migration_brief.md | markdown | 1.6 KB |
| references/templates/pending_decisions.md | markdown | 1.2 KB |
references/templates/handoff.md
View on GitHub---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
version: "x.y.z"
kind: handoff
producedBy: orchestrator
hash: "sha256:<hash do corpo abaixo do front-matter>"
---
# Handoff para o Agente de Codificação
> Este documento é a porta de entrada para o agente de codificação (Claude Code, Codex, Cursor, Antigravity, etc.) que vai escrever o sistema novo a partir das specs.
## ⚠️ Leitura obrigatória primeiro
1. **`paradigm_decision.md`**, leitura inegociável. O paradigma alvo molda como toda a codificação deve acontecer.
2. **`topology_decision.md`**, leitura inegociável. A topologia escolhida (preservar / modernizar / híbrido) define a árvore de pastas e a fronteira entre módulos.
3. **`screen_modernization_decision.md`**, leitura inegociável quando o legado tem UI. O modo escolhido (literal / modernizado / híbrido) define como o codificador vai materializar as telas.
## Ordem de leitura recomendada
1. `paradigm_decision.md` (obrigatório, primeiro)
2. `topology_decision.md` (obrigatório, segundo)
3. `screen_modernization_decision.md` (obrigatório quando há UI; pular se Screen Translator rodou em modo skipped)
4. `migration_brief.md`
5. `target_business_rules.md`
6. `migration_strategy.md`
7. `target_architecture.md`
8. `target_domain_model.md`
9. `target_data_model.md`
10. `data_migration_plan.md`
11. `target_screens.md` (quando há UI)
12. `parity_specs.md` + `parity_tests/`
13. `screen_deviation_log.md` (consultivo, quando há UI)
14. `risk_register.md` + `cutover_plan.md`
15. `discard_log.md` (consultivo)
16. `ambiguity_log.md` (consultivo)
## Lista de artefatos produzidos
| Artefato | Produzido por | Status |
|---|---|---|
| migration_brief.md | orchestrator | criado |
| paradigm_decision.md | paradigm_advisor | criado |
| target_business_rules.md | curator | criado |
| discard_log.md | curator | criado |
| migration_strategy.md | strategist | criado |
| risk_register.md | strategist | criado |
| cutover_plan.md | strategist | criado |
| topology_decision.md | designer (Fase 1) | criado |
| target_architecture.md | designer | criado |
| target_domain_model.md | designer | criado |
| target_data_model.md | designer | criado |
| data_migration_plan.md | designer | criado |
| screen_modernization_decision.md | screen_translator (Fase 1) | criado / skipped |
| target_screens.md | screen_translator | criado / skipped |
| screen_deviation_log.md | screen_translator | criado / vazio |
| _reversa_sdd/screens/inventory.json | screen_translator | criado / vazio |
| _reversa_sdd/screens/golden/manifest.yaml | screen_translator | criado / opcional |
| parity_specs.md | inspector | criado |
| parity_tests/*.feature | inspector | <N> arquivos |
| ambiguity_log.md | orchestrator | consolidado |
## Bloqueadores para começar a implementação
> Itens que precisam de decisão humana antes do agente de codificação começar.
- <AMB-XXX: descrição curta + onde decidir>
- <ou: nenhum bloqueador, prosseguir>
## Próximos passos para o agente de codificação
1. **Ler `paradigm_decision.md` e internalizar**: o paradigma alvo é <do paradigm_decision>. Toda escolha de código deve honrar esse paradigma.
2. **Ler `topology_decision.md` e internalizar**: a topologia escolhida é <preservar | modernizar | híbrido>. Use o esboço da árvore registrado nesse artefato como base para criar a estrutura de pastas do novo repositório.
3. **Ler `screen_modernization_decision.md` e internalizar** (quando há UI): o modo de tradução de telas é <literal | modernizado | híbrido>. Em literal, materialize byte-a-byte (ou pixel-equivalente) o que está em `target_screens.md`; em modernizado, honre a hierarquia de componentes, tokens e os 4 estados (idle, loading, error, success).
4. **Configurar o repositório novo** com a stack declarada em `migration_brief.md` e a topologia decidida.
5. **Implementar bottom-up** seguindo `target_architecture.md` e `target_domain_model.md`:
- infraestrutura → dados → domínio → aplicação → bordas.
6. **Implementar as telas** consumindo `target_screens.md` como contrato literal. Em modo literal com golden files presentes em `_reversa_sdd/screens/golden/`, o resultado da implementação deve casar com o golden file dentro das `normalizationRules` declaradas no `manifest.yaml`.
7. **Escrever os testes** a partir de `parity_specs.md` e `parity_tests/*.feature` desde o início. Honrar a seção § Exceções, que reflete deviations aprovadas em `screen_deviation_log.md`.
8. **Para cada componente**, validar que respeita o paradigma escolhido (sinais explícitos em `target_architecture.md § Honra ao paradigma escolhido`) e a topologia escolhida (sinais explícitos em `target_architecture.md § Honra à topologia escolhida`).
9. **Para a migração de dados**, seguir `data_migration_plan.md`.
10. **Para o cutover**, seguir `cutover_plan.md` e os critérios go/no-go.
## Itens auto-decididos (apenas se executado em --auto)
> Listar aqui itens cujo default foi aplicado sem confirmação humana. Recomenda-se revisar antes do cutover.
- <ou: pipeline executado em modo interativo, nenhum item auto-decidido>
## Notas finais
<Observações do orquestrador para o agente de codificação.>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |