stribus/pygerengastos / .agents/skills/reversa-screen-translator
reversa-screen-translator
VerifiedQuinto 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.6 KB |
| references/adapter-pairs.md | markdown | 6.6 KB |
| references/platform-detection.md | markdown | 5.9 KB |
| references/templates/golden_manifest.yaml | config | 2.8 KB |
| references/templates/inventory.schema.json | config | 5.1 KB |
| references/templates/screen_deviation_log.md | markdown | 2.2 KB |
| references/templates/screen_modernization_decision.md | markdown | 4.7 KB |
| references/templates/target_screens.md | markdown | 6.7 KB |
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.>
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: 322k | 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 |