rdd-glossary
Gera ou atualiza os 3 glossários do projeto (DEV, BUSINESS, USER) a partir do mesmo insumo. Faz merge incremental — nunca deleta termos existentes, apenas adiciona novos. Use quando o usuário pedir "gerar glossário", "glossário de negócio", "DEV_GLOSSARY" ou "atualizar termos do glossário".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-glossary
- description
- Gera ou atualiza os 3 glossários do projeto (DEV, BUSINESS, USER) a partir do mesmo insumo. Faz merge incremental — nunca deleta termos existentes, apenas adiciona novos. Use quando o usuário pedir "gerar glossário", "glossário de negócio", "DEV_GLOSSARY" ou "atualizar termos do glossário".
03 SKILL.md 正文
rdd-glossary — Glossários (3 níveis)
Gera 3 arquivos de glossário a partir do mesmo insumo, cada um para uma audiência diferente. Faz merge incremental com termos existentes.
Referências
- Front matter:
docs/CONSTITUTION.md §2 - Fonte primária de dados:
docs/CONSTITUTION.md §6
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(se existir)<modulo>/<projeto>/glossaries/DEV_GLOSSARY.md(se existir, para merge; fallback: raiz)<modulo>/<projeto>/glossaries/BUSINESS_GLOSSARY.md(se existir, para merge; fallback: raiz)<modulo>/<projeto>/glossaries/USER_GLOSSARY.md(se existir, para merge; fallback: raiz)- Transcrição de reunião ou termos soltos
Gera (downstream)
<modulo>/<projeto>/glossaries/DEV_GLOSSARY.md<modulo>/<projeto>/glossaries/BUSINESS_GLOSSARY.md<modulo>/<projeto>/glossaries/USER_GLOSSARY.md
Nunca edita
REQUIREMENTS.md- Qualquer outro documento de requisito
Tools
read(ler arquivos existentes)write(escrever glossários)question(para ambiguidades)
Modo de erro
continue — se falhar, loga warning e segue. Glossários são enriquecimento.
Algoritmo
- Leia
REQUIREMENTS.md(se existir) e a transcrição/termos fornecidos — extraia os termos candidatos. - Leia os 3 glossários existentes em
glossaries/(fallback: raiz) para o merge incremental. - Para cada termo novo, classifique a audiência (DEV/BUSINESS/USER) e aplique o formato e a regra de idioma do glossário correspondente.
- Aplique as regras de merge incremental: adicione apenas termos novos; em definição conflitante, use
question. - Escreva/atualize
DEV_GLOSSARY.md,BUSINESS_GLOSSARY.mdeUSER_GLOSSARY.mdemglossaries/.
Formato de commit
docs: add/update glossary terms for <projeto>
Regras de merge incremental
- Leia os glossários existentes antes de gerar
- Adicione apenas termos novos (não presentes no existente)
- Nunca delete ou sobrescreva termos existentes
- Se um termo existente tiver definição conflitante, use
questionpara perguntar
1. DEV_GLOSSARY.md — audiência [tecnica]
---
project: <NOME>
module: glossario
audience: [tecnica]
status: draft
---
Formato por termo:
## [Nome do Termo]
**Definição:** [definição técnica precisa]
**Classificação DDD:** [Aggregate Root, Value Object, Entity, Domain Event]
**Relações:** [termos relacionados]
**Não confundir com:** [termos parecidos]
Regra de idioma: o título é o termo técnico (jargão da área, frequentemente em inglês — ex.: ## Backfill). Não traduza o título para DEV; a tradução/contexto vai na definição.
2. BUSINESS_GLOSSARY.md — audiência [negocio]
---
project: <NOME>
module: glossario
audience: [negocio]
status: draft
---
Formato por termo:
## [Termo em português (sigla/expansão em português)]
[2-4 frases, linguagem clara, sem jargão técnico]
Regra de idioma: glossário 100% em português — título e parênteses na língua da audiência (PT-BR). Nunca use termos em inglês (nem no título, nem entre parênteses). Parênteses apenas para siglas ou expansões em português (ex.: ## GTA (Guia de Trânsito Animal), ## Unidade de Exploração (UE)). Se o conceito só existir em inglês, traduza o título e explique na definição.
3. USER_GLOSSARY.md — audiência [usuario_final]
---
project: <NOME>
module: glossario
audience: [usuario_final]
status: draft
---
Formato por termo:
## O que é [nome]
[2-4 frases, linguagem coloquial]
Regra de idioma: [nome] em português (língua da audiência), linguagem coloquial. Ex.: ## O que é Carga Inicial.
Casos de Borda
- Termo existente com definição conflitante: não sobrescreva — use
questionpara decidir entre manter, atualizar ou registrar as duas acepções. - Termo que só existe em inglês: no DEV_GLOSSARY mantenha o título técnico em inglês; no BUSINESS e no USER traduza o título e explique na definição (nunca inglês nesses dois).
- Mesmo termo serve a várias audiências: gere a entrada nos 3 glossários, cada uma no formato e idioma da sua audiência — não reutilize o texto do DEV no BUSINESS.
- Glossários ainda não existem: crie os 3 arquivos em
glossaries/com front matter — o merge incremental passa a valer nas execuções seguintes. - Termo sem definição clara no insumo: pergunte via
questionantes de escrever — não publique definição genérica.
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-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".
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".