stribus/pygerengastos / .agents/skills/reversa-designer
reversa-designer
VerifiedQuarto 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.4 KB |
| references/paradigm-checklist.md | markdown | 1.9 KB |
| references/templates/data_migration_plan.md | markdown | 2.4 KB |
| references/templates/target_architecture.md | markdown | 2.2 KB |
| references/templates/target_data_model.md | markdown | 1.8 KB |
| references/templates/target_domain_model.md | markdown | 1.7 KB |
| references/templates/topology_decision.md | markdown | 3.8 KB |
references/templates/topology_decision.md
View on GitHub---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
version: "x.y.z"
kind: topology_decision
producedBy: designer
hash: "sha256:<hash do corpo abaixo do front-matter>"
---
# Topology Decision
> Decisão consciente sobre como organizar o sistema novo: preservar a topologia do legado, adotar uma topologia moderna ou aplicar um híbrido.
> Este artefato é leitura obrigatória do próprio Designer (para decompor bounded contexts) e do agente de codificação (para criar a árvore de pastas).
## Topologia do legado detectada
- **Padrão organizacional**: <package-by-layer | package-by-feature | feature-sliced | módulos por domínio | DDD com bounded contexts | monorepo | monolito sem fronteiras claras | híbrido: ...>
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
- **Evidências**:
- <evidência 1, com referência a artefato do `_reversa_sdd/` (architecture.md, inventory.md, dependencies.md)>
- <evidência 2>
- **Mapa da árvore legada** (resumido):
```
<árvore curta com pastas/módulos principais>
```
## Diagnóstico estrutural
- **Acoplamento**: <alto | médio | baixo, com evidência>
- **Coesão por módulo**: <alta | média | baixa, com evidência>
- **Módulos órfãos / mortos**: <lista, ou "nenhum">
- **Camadas redundantes**: <lista, ou "nenhuma">
- **Violações de fronteira**: <lista, ou "nenhuma">
- **Mistura de paradigmas/estilos**: <descrição, ou "homogêneo">
- **Avaliação geral**: <saudável | problemática | parcialmente problemática>
## Topologia moderna proposta
- **Padrão**: <hexagonal | vertical slices | feature-sliced | DDD com bounded contexts | package-by-feature | modularização por capability | monorepo com pnpm/turborepo | ...>
- **Justificativa**: <por que esse padrão se encaixa no stack alvo, no domínio, no tamanho do time e na estratégia de migração escolhida>
- **Ganhos concretos esperados**:
- <ganho 1: ex. testabilidade isolada por feature>
- <ganho 2: ex. deploy independente por bounded context>
- <ganho 3: ex. onboarding mais rápido>
- **Custo / risco**:
- <custo 1: ex. curva de aprendizado da equipe>
- <custo 2: ex. esforço de reorganização>
- **Esboço da árvore proposta**:
```
<árvore curta com pastas/módulos no padrão moderno>
```
## Opções apresentadas ao usuário
1. **Preservar topologia legada** (conservador)
- Consequências: mantém mapa mental do time atual; perpetua eventuais débitos estruturais; reduz risco de migração.
2. **Adotar topologia moderna proposta** (transformacional)
- Consequências: rompe com débito estrutural; exige aprendizado; maximiza ganhos do stack alvo.
3. **Híbrido** (equilibrado)
- Consequências: <descrever quais bordas preservam o legado e quais adotam o moderno, com justificativa por borda>
## Decisão do usuário
- **Escolha**: <1 | 2 | 3>
- **Justificativa do usuário**: <texto livre>
- **Decidido em**: <ISO-8601>
## Mapeamento legado → novo
| Módulo / pasta legada | Bounded context novo | Tipo | Observações |
|---|---|---|---|
| <legado A> | <novo X> | preservado | <obs> |
| <legado B + C> | <novo Y> | fundido | <justificativa> |
| <legado D> | <novo Y1, Y2> | dividido | <justificativa> |
| (vazio) | <novo Z> | novo | <justificativa> |
| <legado E> | (descartado) | removido | ver `discard_log.md` |
## Implicações pendentes para próximos passos do Designer
| Etapa do Designer | Implicação | Como honrar |
|---|---|---|
| Bounded contexts | <implicação> | <ação esperada> |
| target_architecture | <implicação> | <ação esperada> |
| target_domain_model | <implicação> | <ação esperada> |
| target_data_model | <implicação> | <ação esperada> |
## Notas
<Qualquer ponto adicional que o agente de codificação precisa saber para criar a árvore de pastas e respeitar a topologia escolhida.>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |