Skip to content

stribus/pygerengastos / .agents/skills/reversa-designer

reversa-designer

Verified

Quarto agente do Time de Migração. Opera em duas fases. Fase 1: detecta a topologia do legado, sempre propõe uma topologia moderna alternativa e produz topology_decision.md (com pausa humana para aprovação). Fase 2: desenha as specs do sistema novo sob a topologia escolhida, produzindo target_architecture.md, target_domain_model.md, target_data_model.md e data_migration_plan.md, com rastreabilidade total para o legado. Ativação: /reversa-designer (geralmente invocado por /reversa-migrate).

references/templates/data_migration_plan.md

View on GitHub
---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
  version: "x.y.z"
kind: data_migration_plan
producedBy: designer
hash: "sha256:<hash do corpo abaixo do front-matter>"
---

# Data Migration Plan

> Plano de migração dos dados do legado para o sistema novo: mapeamento, transformações, ETL, cutover de dados e validação.

## Resumo
- Volume estimado: <linhas / GB por entidade principal>
- Janela de migração: <ver `cutover_plan.md`>
- Estratégia: backfill prévio + delta + corte | bulk único | replicação contínua

## Mapeamento legado → novo

| Origem | Destino | Tipo | Notas |
|---|---|---|---|
| `<schema legado>.tb_pedidos` | `pedidos` | renomeação | normalização de tipos |
| `<schema legado>.tb_pedido_item` | `pedido_itens` | renomeação | FK ajustada |
| `<schema legado>.usr_x` | `usuarios` (parcial) + `perfis` | divisão | extrai dados de perfil |

## Transformações

### Transformação T-01: <nome>
- **Aplica em**: <coluna ou tabela>
- **Regra**: <texto explícito>
- **Tratamento de inválidos**: <descartar | rejeitar | preencher com default>
- **Origem da regra**: <referência a `target_business_rules.md` ou `discard_log.md`>

<repetir por transformação>

## Estratégia de ETL

- **Ferramenta**: <ex: scripts SQL, dbt, Airbyte, custom>
- **Fluxo**:
  1. <extração>
  2. <transformação>
  3. <carga>
- **Idempotência**: <como o ETL é seguro para reexecução>
- **Throughput esperado**: <ex: 50k linhas/s>

## Backfill e delta

- **Backfill**: <data inicial, escopo, duração>
- **Captura de delta**:
  - **Mecanismo**: CDC | log mining | timestamps | replicação | trigger
  - **Latência aceitável**: <segundos>
- **Reconciliação periódica**: <frequência, escopo>

## Cutover de dados

> Ver também `cutover_plan.md`. Aqui apenas a parte específica de dados.

- **Janela**: <ISO-8601>
- **Sequência de corte**:
  1. <passo>
  2. <passo>
- **Verificação pós-corte**:
  - **Contagens**: <quais tabelas, tolerância>
  - **Checksums**: <colunas críticas>

## Validação de qualidade

| Métrica | Alvo | Fonte de medição |
|---|---|---|
| Contagem por entidade | igual ± 0% | comparação direta |
| Soma de valores monetários | igual ± 0,01% | reconciliação financeira |
| Integridade referencial | 0 órfãos | scripts de auditoria |

## Riscos específicos de dados
- <RISK-XXX: ver `risk_register.md`>

## Notas
<Observações adicionais.>
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall