Skip to content

stribus/pygerengastos / .agents/skills/reversa-screen-translator

reversa-screen-translator

Verified

Quinto agente do Time de Migração. Traduz as telas do sistema legado em especificações executáveis, fechando a lacuna entre o catálogo do design-system e o código pronto. Opera em duas fases. Fase 1: detecta plataforma origem/alvo, apresenta os modos (literal, modernizado, híbrido) e exige decisão humana, produzindo screen_modernization_decision.md. Fase 2: gera target_screens.md, screen_deviation_log.md e, quando o oráculo legado roda, golden files com manifest.yaml para o Inspector consumir. Ativação: /reversa-screen-translator (geralmente invocado por /reversa-migrate, entre Designer e Inspector).

references/templates/screen_deviation_log.md

View on GitHub
---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
  version: "x.y.z"
kind: screen_deviation_log
producedBy: screen-translator
mode: append-only
hash: "sha256:<hash do corpo abaixo do front-matter>"
---

# Screen Deviation Log

> Registro de toda divergência entre o legado e a spec gerada em `target_screens.md`. Append-only. Deviations pendentes bloqueiam o handoff ao Inspector.
> Deviations aprovadas são propagadas para `parity_specs.md § Exceções` quando o Inspector rodar.

## Convenções

- **ID**: `DEV-NNN` (sequencial, três dígitos).
- **Tipo**:
  - `tecnica`: limitação técnica do alvo (ex: terminal Windows sem UTF-8 sem `chcp 65201`).
  - `modernizacao`: divergência intencional decorrente do modo modernizado.
  - `plataforma`: divergência forçada por incompatibilidade de plataforma (ex: Win16 → web).
  - `correcao`: bug visual do legado que o alvo corrige (ex: typo em label).
- **Aprovação**: `pendente` | `aprovado` | `rejeitado`.
- Deviation `aprovado` → também listada em `parity_specs.md § Exceções`.
- Deviation `pendente` → bloqueia handoff ao Inspector.
- Deviation `rejeitado` → arquivada com nota explícita; agente regenera a tela em modo conformante.

## Resumo

- **Total**: <N>
- **Pendentes**: <N>
- **Aprovadas**: <N>
- **Rejeitadas**: <N>

## Entradas

### DEV-001

| Campo | Valor |
|---|---|
| Tela afetada | <nome-canonical> |
| Tipo | `tecnica` \| `modernizacao` \| `plataforma` \| `correcao` |
| Descrição | <o que diverge entre legado e novo> |
| Motivo | <por que a divergência é necessária ou aceitável> |
| Origem no legado | <arquivo:linha> |
| Implicação para parity tests | <ex: comparação byte-a-byte falsa, usar comparação semântica> |
| Aprovação | `pendente` \| `aprovado` \| `rejeitado` |
| Aprovado por | <nome ou identificador, quando aprovado> |
| Aprovado em | <ISO-8601, quando aprovado> |
| Propaga para `parity_specs.md § Exceções` | sim \| não |

### DEV-002

(repetir o bloco acima para cada deviation)

## Telas com mais de uma deviation

| Tela | IDs |
|---|---|
| <tela X> | DEV-001, DEV-007 |

## Notas

<Observações gerais sobre o conjunto de deviations: padrões, aprendizados que valem para futuras migrações no mesmo par origem→alvo, sugestões de adapter melhorado para v2.>
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