rdd-change-request
Registra mudança solicitada em requisito já confirmado. CHANGE_REQUESTS.md com status pending/approved/rejected/implemented. Gate de score (IMP-094 R3): a solicitação passa por clarify/score de ambiguidade antes de registrar — >= 70 nasce CR direto; < 70 nasce PEND (clarifica primeiro; depois vira CR por R2 ou RN por promoção). Se aprovado, pode executar skills de tradução técnica para re-propagar o delta. Use quando o usuário pedir "registrar mudança", "change request", "CR" ou "alterar requisito confirmado".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-change-request
- description
- Registra mudança solicitada em requisito já confirmado. CHANGE_REQUESTS.md com status pending/approved/rejected/implemented. Gate de score (IMP-094 R3): a solicitação passa por clarify/score de ambiguidade antes de registrar — >= 70 nasce CR direto; < 70 nasce PEND (clarifica primeiro; depois vira CR por R2 ou RN por promoção). Se aprovado, pode executar skills de tradução técnica para re-propagar o delta. Use quando o usuário pedir "registrar mudança", "change request", "CR" ou "alterar requisito confirmado".
03 SKILL.md 正文
rdd-change-request — Gerenciamento de Mudanças
Registra mudanças em requisitos existentes em CHANGE_REQUESTS.md.
Toda alteração em RN confirmada deve passar por este fluxo.
Referências
- IDs CR-XXX:
docs/CONSTITUTION.md §1 - Processo de aprovação:
docs/CONSTITUTION.md §5 - Quem aprova:
docs/CONSTITUTION.md §5.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(para identificar RNs afetadas)<modulo>/<projeto>/quality/TRACEABILITY.md(se existir, para identificar downstreams afetados; fallback: raiz do módulo)
Gera (downstream)
<modulo>/<projeto>/support/CHANGE_REQUESTS.md- Após aprovação: opcionalmente executa
rdd-data-model,rdd-api-contracts,rdd-ui-speccom escopo restrito ao delta
Nunca edita
REQUIREMENTS.mddiretamente (a mudança só é refletida lá após aprovação)
Tools
read(ler REQUIREMENTS.md, TRACEABILITY.md existentes)write(escrever CHANGE_REQUESTS.md)question(para confirmar aprovação com o usuário)
Modo de erro
strict — se o CR não for registrado, a mudança não pode prosseguir.
- Score de ambiguidade < 70 (IMP-094 R3): NÃO registre CR — registre PEND em REQUIREMENTS.md §11 (com perguntas de follow-up) e oriente nova tentativa após clarificação; solicitação ambígua nasce PEND, não mudança formal. Nenhum arquivo de CR é criado neste caso.
Formato de commit
docs: add CR-XXX for <título>
Estratégia de Perguntas
Regras
-
NUNCA inclua "Digitar agora" como opção. O
questiontool já adiciona "Type your own answer" automaticamente. -
Agrupe perguntas relacionadas. Máximo 2 blocos para todo o CR.
-
Use exemplos contextuais nas opções, nunca opções genéricas.
Blocos (máx 3)
Bloco 0 — Validação de Abordagem (obrigatório antes de registrar o CR):
- Repositório/sistema alvo: onde deve ser implementado? (ex:
<nome>.API, sistema externo) - Abordagem arquitetural: endpoint novo, adaptação, serviço externo?
- Impacto visual (IMP-128): a mudança altera apresentação visual/UI (layout, copy de tela, componente, hierarquia visual)? Se sim e o front do módulo é derivado de design Figma (UI_SPEC/Figma prompts existentes), o CR ativa o loop design-first (ver passo 7.1) — design antes de código.
- Atores e permissões: quem usa? autenticado, público, admin?
- Alternativas: outras abordagens consideradas?
- Confirmação: "A abordagem está correta? Posso prosseguir?"
Bloco 1 — Dados da mudança (única pergunta):
- Descrição resumida da mudança
- RNs afetadas (já identificadas na leitura de REQUIREMENTS.md)
- Justificativa
- Origem da mudança (IMP-099):
requisito-mal-capturado | evolucao | bug | decisao-cliente— perguntar viaquestion(opções com as 4 origens); em modo não-interativo, inferir do contexto e registrar a inferência no campoOrigemdo CR Bloco 2 — Aprovação (única pergunta): - A mudança está aprovada?
- Se sim, deseja repropagar downstreams?
Workflow
-
VALIDAÇÃO DE ABORDAGEM (NOVO) — Antes de registrar qualquer mudança:
- Pergunte ao usuário usando
question— Bloco 0 (validação de abordagem) - Confirme ONDE (repositório/sistema alvo), COMO (arquitetura), QUEM (atores/permissões) e ALTERNATIVAS
- Só prossiga após a confirmação explícita da abordagem pelo usuário
- Registre a decisão de abordagem no CR (campo
Repositório alvoou similar)
- Pergunte ao usuário usando
-
Receba a descrição da mudança solicitada
-
Leia
REQUIREMENTS.mdpara identificar as RNs afetadas -
GATE DE SCORE (IMP-094 R3) — toda solicitação de mudança passa pelo clarify/score de ambiguidade (0-100, critérios C1-C5 da
rdd-clarify) ANTES de ser registrada:- Score >= 70 → a mudança nasce como CR direto — siga para o passo 4.
- Score < 70 → solicitação ambígua: NÃO registre CR. Registre/atualize
PEND em REQUIREMENTS.md §11 (via
rdd-requirements/rdd-clarify) com perguntas de follow-up e oriente retornar após clarificação — a PEND resolvida volta como CR (se alterar RN confirmada) ou como RN nova (IMP-094).
-
Pergunte ao usuário usando
question— Bloco 1 (dados da mudança) -
Registre o CR em
support/CHANGE_REQUESTS.mdcom statuspending— todo CR inclui o campo**Origem:**(IMP-099). CR sem campo origem = registro incompleto (a agregação de métricas de resultado trata como N/A, nunca inventa) -
Pergunte ao usuário usando
question— Bloco 2 (aprovação) -
Se aprovada, atualize status para
approvede pergunte se deseja re-propagar para downstreams 7.1. LOOP DESIGN-FIRST para CR com impacto visual (IMP-128) — se o CR altera apresentação visual/UI e o front do módulo é derivado de design Figma (existe UI_SPEC/FIGMA_PROMPTS ou o charter indica design Figma):- Roteie para
@rdd-figma-orchestrator→rdd-figma-prompt(delta do design: apenas a tela/seção afetada pelo CR) — o prompt alimenta o agente do Figma; registre o prompt/frame resultante no campoDesign Figmado CR. - Após o operador validar o design no Figma, capture a nova versão
com
rdd-figma-tasks(delta de UI_SPEC + handoff de features). - Só então a feature/código é especificada (
rdd-task-spec) e implementada (rdd-dev) a partir do design capturado — NUNCA implemente mudança visual direto no código a partir do texto do CR.
- Modo não-Figma (condicional): módulo sem workflow Figma (sem UI_SPEC, sem MCP Figma, front não derivado de design) segue o fluxo normal — o gate não se aplica.
- Roteie para
-
Se rejeitada, registre a justificativa de rejeição
Template — CHANGE_REQUESTS.md
---
project: <NOME>
module: mudancas
audience: [tecnica, negocio]
status: draft
---
# Registro de Mudanças
## CR-XXX: [título]
**Status:** pending | approved | rejected | implemented
**Data:** DD/MM/AAAA
**Solicitante:** [nome]
**RN afetada:** RN-XXX, RN-YYY
**Origem:** requisito-mal-capturado | evolucao | bug | decisao-cliente (IMP-099)
**Impacto visual:** sim | não (IMP-128)
**Design Figma:** [frame/URL do design validado ou "pré-requisito — prompt a gerar"; n/a quando impacto visual: não]
**Descrição:** [mudança solicitada]
**Justificativa:** [por que a mudança é necessária]
**Downstreams afetados:** DATA_MODEL, API_CONTRACTS, UI_SPEC
**Aprovação:** [quem aprovou/rejeitou, data]
**Motivo de rejeição:** [se rejeitado]
Casos de Borda
-
RN afetada não existe em REQUIREMENTS.md: não registre CR apontando ID inexistente — confirme via
questionse é requisito novo (encaminhe parardd-requirements) ou erro de referência. -
CR aprovado sem re-propagação: registre status
approvede mantenha os downstreams no campo "Downstreams afetados" — ordd-cr-propagation-guardsinaliza o stale depois. -
Mudança afeta múltiplas RNs: registre um único CR listando todas as RNs afetadas — não abra um CR por RN para a mesma solicitação.
-
Mudança já registrada: verifique CHANGE_REQUESTS.md antes de criar — se já existe CR aberto para a mesma RN, atualize/referencie em vez de duplicar.
-
Bloco 0 sem confirmação explícita: não prossiga para o registro — a validação de abordagem é obrigatória; sem aprovação, o CR não é criado.
-
Mudança originada de PEND (IMP-094 R2): quando a resolução de uma PEND aberta se revela alteração em RN já confirmada, registre o CR normalmente e informe a origem nos campos Descrição/Justificativa (
Promovida de PEND-NNN em <data>); a PEND de origem deve ser marcada como resolvida no REQUIREMENTS.md com destino ao CR-XXX. -
CR sem campo
Origem(IMP-099): é registro incompleto — não conclua o fluxo sem classificar a origem (viaquestionou inferência registrada). A skill de agregação de métricas trata CR sem origem como N/A; nunca invente a origem retroativamente. -
CR visual aprovado sem design (IMP-128): CR com
Impacto visual: simem módulo Figma-derived fica comDesign Figma: pré-requisitoaté o loop 7.1 completar (prompt → validação no Figma → capturardd-figma-tasks); a implementação em código não começa antes. Ordd-cr-propagation-guardsinaliza o delta de UI_SPEC pendente.
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".