rdd-ui-spec
Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-ui-spec
- description
- Gera UI_SPEC.md a partir das RNs em REQUIREMENTS.md. Descreve telas, componentes, fluxos de navegação, validações de frontend e regras de exibição condicional. Use quando o usuário pedir "especificação de UI", "spec de telas", "layout de formulários" ou "fluxo de navegação".
03 SKILL.md 正文
rdd-ui-spec — Especificação de UI
Gera <modulo>/<projeto>/specs/UI_SPEC.md com a especificação de interface
derivada das regras de negócio e casos de uso.
Referências
- Front matter:
docs/CONSTITUTION.md §2 - EARS (para validações de frontend):
docs/CONSTITUTION.md §3
Resolução de caminhos (IMP-011)
Os artefatos do módulo seguem a estrutura com subpastas (IMP-011):
- Raiz: PROJECT_CHARTER.md, CONSTITUTION.md, REQUIREMENTS.md, DECISIONS.md, CHANGELOG.md
specs/: DATA_MODEL.md, API_CONTRACTS.md, ERROR_CATALOG.md, UI_SPEC.md, ARCHITECTURE.md, SECURITY.md, ACCEPTANCE_CRITERIA.md, USER_STORIES.md, US<NNN>.md, FIGMA_PROMPTS.md, COMPLIANCE.mdquality/: TEST_STRATEGY.md, DEFINITION_OF_DONE.md, TRACEABILITY.md, VALIDATION_REPORT.md, PROPAGATION_STATUS.md, PROGRESS_REPORT.mddelivery/: TASKS.md, TASKS_.md, TASKS_AZURE_CONSOLIDADO.md, SCOPE_AGREEMENT.md, CLIENT_REQUIREMENTS.md, CLIENT_REPORT_.md, HANDOVER_LOG.mdsupport/: LEGACY_CONTEXT.md, KNOWN_ERRORS.md, MIGRATION.md, CHANGE_REQUESTS.mdglossaries/: DEV_GLOSSARY.md, BUSINESS_GLOSSARY.md, USER_GLOSSARY.md, GLOSSARY.mddocs/: howto/*.md e documentos auxiliaresmeetings/,contracts/: checkpoints (inalterados)
Regra de fallback (transição): ao LER um artefato, verifique primeiro
o caminho novo (ex: specs/DATA_MODEL.md); se não existir, use o caminho
legado na raiz do módulo (ex: DATA_MODEL.md). Ao ESCREVER/GERAR, use
sempre o caminho novo. Módulos ainda não migrados via rdd-restructure
continuam legíveis durante a transição.
Lê (upstream)
<modulo>/<projeto>/REQUIREMENTS.md(essencial — §2 Atores, §5 RNs, §7 Casos de Uso, §8 Saídas)<modulo>/<projeto>/specs/API_CONTRACTS.md(se existir, para campos e validações; fallback: raiz do módulo)<modulo>/<projeto>/specs/DATA_MODEL.md(se existir, para tabelas e colunas envolvidas; fallback: raiz do módulo)<modulo>/<projeto>/glossaries/(se existir, para consistência terminológica; fallback: raiz do módulo)
Gera (downstream)
<modulo>/<projeto>/specs/UI_SPEC.md
Nunca edita
REQUIREMENTS.mdAPI_CONTRACTS.mdDATA_MODEL.md
Tools
read(ler REQUIREMENTS.md, API_CONTRACTS.md, DATA_MODEL.md)write(escrever UI_SPEC.md)question(para ambiguidades de layout ou comportamento visual)
Modo de erro
strict — se a UI spec não for gerada, o time de frontend não tem input.
Propagação de confiança (legado)
- Afirmações derivadas de RN induzida de engenharia reversa herdam a marca de confiança da RN de origem (campo
**Confiança:**em REQUIREMENTS.md). - Escala: Alta → 🟢 CONFIRMADO · Média → 🟡 INFERIDO · Baixa → 🔴 GAP.
- Regra de ouro: na dúvida, nível mais baixo.
- Quando disponível, anexe a evidência da análise reversa (
[arquivo:linha]ou@<hash>) — afirmação sem evidência nunca recebe 🟢.
Formato de commit
docs: add ui spec for <projeto>
Workflow
- Leia
REQUIREMENTS.md §2 (Atores e Permissões)— identifique perfis de usuário - Leia
REQUIREMENTS.md §5 (Regras de Negócio)— identifique regras de exibição condicional - Leia
REQUIREMENTS.md §7 (Casos de Uso)— identifique fluxos de tela - Leia
REQUIREMENTS.md §8 (Saídas e Integrações)— identifique outputs visuais - Leia
API_CONTRACTS.md(se existir) — identifique campos e validações a espelhar no frontend - Para cada ator, descreva:
- Telas disponíveis
- Fluxo de navegação entre telas
- Permissões por tela/ação
- Para cada fluxo, descreva:
- Componentes de tela (formulários, tabelas, modais)
- Campos com tipo de input (text, date, select, checkbox)
- Regras de exibição condicional (exibir/ocultar campo baseado em valor)
- Validações de frontend (derivadas de RNs)
- Estados (carregando, vazio, erro, sucesso)
- Escreva
specs/UI_SPEC.md - Aponte o próximo passo natural: fechado o conjunto de specs do módulo, a camada seguinte da DAG é a de features — proponha gerá-la com
rdd-task-spec(análiseanalysis/RN-NNN — <título>/+delivery/<grupo>/RN-NNN — <título> — Feature.md— IMP-092/093) ou confirme a ordem comrdd-next.
Template — UI_SPEC.md
---
project: <NOME>
module: ui
audience: [tecnica]
status: draft
---
# UI Specification — [Nome do Sistema]
> **Derivado de:** REQUIREMENTS.md (RN-XXX, RN-YYY)
> **Última atualização:** DD/MM/AAAA
---
## 1. Atores e Telas
| Ator | Telas disponíveis | Fluxo inicial |
|---|---|---|
| [papel] | [lista de telas] | [tela de entrada] |
---
## 2. [Tela 1 — Nome]
### 2.1 Acesso
**Permissão:** [papel]
**URL:** /[path]
### 2.2 Layout
[Descrição textual do layout, seções da tela]
### 2.3 Componentes
| Componente | Tipo | Campos | Regras |
|---|---|---|---|
| Formulário de cadastro | Form | campo1, campo2 | RN-XXX |
| Tabela de listagem | Table | coluna1, coluna2 | RN-YYY |
### 2.4 Campos do Formulário
| Campo | Input | Obrigatório | Validação | RN |
|---|---|---|---|---|
| nome | text | Sim | max 100 chars | RN-XXX |
| data | date | Sim | >= data mínima | RN-YYY |
| tipo | select | Sim | options: [A, B, C] | RN-ZZZ |
### 2.5 Regras de Exibição Condicional
| Condição | Ação | RN |
|---|---|---|
| Se tipo = A | Exibir campo X | RN-XXX |
| Se propriedade rastreada | Exibir aba Animais | RN-YYY |
### 2.6 Estados
| Estado | Comportamento |
|---|---|
| Carregando | Skeleton/spinner |
| Vazio | Mensagem "Nenhum registro encontrado" |
| Erro | Toast com mensagem do erro |
| Sucesso | Redirecionar para listagem |
---
## 3. [Tela 2 — Nome]
...
---
## 4. Fluxo de Navegação
[Tela 1] → [Tela 2] → [Tela 3] ↓ ↓ [Erro] [Sucesso]
---
## 5. Regras de UI Globais
| Regra | Descrição | RN |
|---|---|---|
| Formatação de data | DD/MM/AAAA | — |
| Moeda | R$ 1.234,56 | — |
| Confirmação antes de excluir | Modal "Tem certeza?" | — |
Casos de Borda
- Sem API_CONTRACTS.md — derive campos e validações apenas de REQUIREMENTS.md e sinalize a ausência no cabeçalho (
Derivado de:). - Projeto API-only (sem UI) — informe que a skill não se aplica ao módulo e encerre sem gerar arquivo.
- RN ambígua para layout/comportamento visual — use
questionantes de especificar (não invente interação). - Regra de exibição condicional sem RN associada — pergunte qual RN origina a regra; toda linha das seções de exibição deve referenciar uma RN-XXX.
- Ator sem permissão definida em REQUIREMENTS.md — pergunte antes de criar tela para o ator.
04 同仓库更多 Skills
rdd-wiki-lint
Audita integridade dos artefatos RDD: contradições entre seções, artefatos órfãos, referências cruzadas quebradas, links internos inválidos e drift de estrutura. Complementa rdd-validate (que valida a DAG de RNs → downstreams) e rdd-decision-audit (que valida DECISIONS.md) com foco em integridade documental dos artefatos individualmente. Use quando o usuário pedir "lint dos documentos", "verificar integridade dos artefatos", "wiki lint", "contradições nos docs" ou "validar estrutura".
rdd-vps-troubleshoot
Diagnóstico guiado por sintoma para VPS da organização já configurada — container unhealthy / healthcheck expirando, GHCR denied/unauthorized no pull, git "could not read Username for 'https://github.com'", GitHub Actions (appleboy/ssh-action) falhando SSH (handshake failed, ParsePrivateKey), services systemd duplicados do cloudflared em activating (auto-restart), requisições caindo no servidor errado (tunnel compartilhado), porta ocupada, logs (journalctl / docker logs), conectividade (curl local vs público, ss, nc) e banco vazio / migrations não aplicadas. Base de conhecimento: runbook.md nesta pasta (sintomas genéricos de deploy em VPS; lições de produção da organização no pack `rules/<pack-da-organizacao>.md` — IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário reportar "container unhealthy", "deploy falhou", "ssh action erro", "ghcr denied", "tunnel não responde", "banco vazio", "sem tabelas", "service duplicado", "vps com problema" ou pedir troubleshooting de deploy.
rdd-vps-setup
Wizard guiado de setup de VPS nova (OS do perfil — ex.: Amazon Linux) para hospedar uma API — atualização do sistema, Docker + Compose + buildx, permissões de arquivos, autenticação no registry do perfil (ex.: ghcr.io), git via SSH (deploy keys), chave SSH dedicada do GitHub Actions (appleboy/ssh-action), tunnel Cloudflare EXCLUSIVO por servidor + route DNS (domínio do perfil), tunnels como serviço systemd (autostart), logging do cloudflared com rotação, pipeline completo de deploy (push main → build → registry → ssh-action → deploy.sh) e backup automatizado (RClone + cronie + canal de alerta do perfil). Base de conhecimento validada: pack da organização em `rules/<pack-da-organizacao>.md` §infra-vps-setup (IMP-105). Modo guiado — sugere comandos com explicação; o operador executa na VPS. Use quando o usuário pedir "setup de VPS", "configurar VPS nova", "preparar servidor para deploy", "tunnel cloudflare", "ghcr", "deploy key", "backup rclone", "docker compose na vps" ou "pipeline de deploy na VPS".
rdd-validate
Percorre o grafo de documentos do projeto e valida integridade: RN sem downstream esperado, ID quebrado, CR aprovado sem reflexo. Gera relatório VALIDATION_REPORT.md. Suporta flag --fix para auto-correção. Use quando o usuário pedir "validar integridade", "checar a DAG", "validar referências cruzadas" ou "validação do módulo".
rdd-ui-capture
Captura evidência visual em runtime do sistema legado para migração (golden master de UI) via MCP Playwright — screenshots por rota/estado, requisições de rede observadas e erros de console, gravados em reverse/ui/ com manifesto reverse/UI_CAPTURE.md e candidatas visuais na fila reverse/CANDIDATES.md. Complemento runtime da engenharia reversa estática (IMP-144). Use quando o usuário pedir "captura visual", "golden master de UI", "screenshots do legado", "captura de UI" ou "ui capture".
rdd-typesafe-ai
Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives. Its System One models, including Jev, turn natural language and application state into typed judgments and probabilities that code can combine. Use when a feature needs programmable common sense, when brainstorming what AI could make possible in an app, or when an LLM prompt-and-parse step could become a structured decision. Applications include routing, ranking, extraction, verification, and interactive experiences; these are starting points, not the limits. Read live docs and cookbooks to find useful patterns and discover new combinations.