rdd-requirements
Gera ou atualiza <modulo>/<projeto>/REQUIREMENTS.md a partir da transcricao de uma reuniao de negocios. Cobre criacao inicial e merge incremental. Registra decisoes em DECISIONS.md e gera CHANGELOG.md como efeito colateral. Le o checkpoint de rdd-clarify como entrada. IMP-094: promove PEND a RN (nova RN sequencial com proveniência da PEND de origem) — a RN ancora feature; PEND nunca ancora feature. Use quando o usuário pedir "gerar requisitos", "atualizar REQUIREMENTS.md", "registrar RNs de reunião" ou "regras de negócio".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-04
- Stars
- ★ 4
- Forks
- 1
01 前言 Front Matter
- name
- rdd-requirements
- description
- Gera ou atualiza <modulo>/<projeto>/REQUIREMENTS.md a partir da transcricao de uma reuniao de negocios. Cobre criacao inicial e merge incremental. Registra decisoes em DECISIONS.md e gera CHANGELOG.md como efeito colateral. Le o checkpoint de rdd-clarify como entrada. IMP-094: promove PEND a RN (nova RN sequencial com proveniência da PEND de origem) — a RN ancora feature; PEND nunca ancora feature. Use quando o usuário pedir "gerar requisitos", "atualizar REQUIREMENTS.md", "registrar RNs de reunião" ou "regras de negócio".
03 SKILL.md 正文
rdd-requirements — Gerenciamento de REQUIREMENTS.md
Gera ou atualiza <modulo>/<projeto>/REQUIREMENTS.md a partir de transcrição
de reunião de negócios. Faz merge incremental, nunca reescreve do zero.
Referências
- EARS:
docs/CONSTITUTION.md §3 - Front matter:
docs/CONSTITUTION.md §2 - IDs RN-XXX, PEND-XXX:
docs/CONSTITUTION.md §1 - Template de 11 seções:
docs/CONSTITUTION.md(aqui embutido por praticidade) - 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>/PROJECT_CHARTER.md(para REDMINE #, escopo, stakeholders)<modulo>/<projeto>/REQUIREMENTS.md(se existir)<modulo>/<projeto>/DECISIONS.md(se existir)<modulo>/<projeto>/meetings/(checkpoints do rdd-clarify e meetings anteriores)<modulo>/<projeto>/LINGUAGEM_UBIQUA.md(opcional — se existir, use os termos canônicos; termo divergente na transcrição vira nota de rodapé)
Gera (downstream)
<modulo>/<projeto>/REQUIREMENTS.md<modulo>/<projeto>/DECISIONS.md(se houver novas decisões)<modulo>/<projeto>/CHANGELOG.md(efeito colateral automático)<modulo>/<projeto>/meetings/YYYY-MM-DD-NN.md(resumo da reunião + perguntas/respostas, NN = próximo sequencial na pasta)
Nunca edita
support/CHANGE_REQUESTS.md(mudança em RN existente só por CR; fallback: raiz)PROJECT_CHARTER.md
Tools
read(ler arquivos existentes)write(escrever/atualizar REQUIREMENTS.md, DECISIONS.md, CHANGELOG.md)question(para ambiguidades não cobertas pelo CLARIFY)
Modo de erro
strict — se REQUIREMENTS.md não for gerado/atualizado, o fluxo para.
Algoritmo
- Leia o checkpoint mais recente em
meetings/(saída dordd-clarify) e o REQUIREMENTS.md existente, se houver - Extraia da transcrição: RNs candidatas, PENDs, decisões (com decisor), campos, atores e escopo
- Se o arquivo existe, faça merge incremental (novas RNs/PENDs sequenciais a partir da última; PENDs resolvidas movem para a seção de resolvidas; PENDs promovidas a RN seguem a seção "Promoção de PEND a RN (IMP-094)"); se não, gere do template
- Registre novas decisões em DECISIONS.md e atualize o CHANGELOG.md como efeito colateral
- Escreva o checkpoint da reunião em
meetings/YYYY-MM-DD-NN.md(NN = próximo sequencial) - Se houver ambiguidade não coberta pelo clarify, use
questionantes de registrar - Portão de cobertura downstream (IMP-046): ao fechar um lote de RNs novas (≥ 3 RNs), verifique antes de encerrar se cada RN nova tem downstream previsto — rode
rdd-traceability(ou verifique os gaps na matriz) e reporte explicitamente:RN sem downstream em DATA_MODEL/API_CONTRACTS/UI_SPEC = pendência do lote. Um lote NÃO está encerrado enquanto houver RN nova sem destino downstream declarado (ou justificativa explícita de por que não aplica). Isso evita repetir gaps reais já vistos em retrospectivas (lote de RNs de uma feature sem seção dedicada no DATA_MODEL — ver retrospectivas do produto). - Confiança de RNs induzidas (legado): quando a fonte é relatório de engenharia reversa do
@rdd-reverse-orchestrator(módulo comsistema_existente: true), cada RN induzida carrega no corpo a tag de confiança da análise reversa:**Confiança:** Alta|Média|Baixa(escala: Alta→🟢 CONFIRMADO, Média→🟡 INFERIDO, Baixa→🔴 GAP; na dúvida, registre o nível mais baixo). RN com confiança Baixa que não passar por validação humana segue a regra IMP-094 (vira PEND — nunca ancora feature).
Segunda camada Jev (opcional) — passo 8
- Antes de gravar a tag de confiança de cada RN induzida de legado, submeta ao
@rdd-jev-classifier:text= corpo da RN + evidência citada ([arquivo:linha]/@hash);questions= JSON TypeSafe, ex.:{"classificacao": {"type": "choice", "criteria": {"confirmada": "Evidencia citada confirma diretamente a afirmacao", "inferida": "Afirmacao e deducao de padrao, nao leitura direta", "lacuna": "Evidencia insuficiente para julgar"}}}. - Regra conservadora: se o Jev retorna
confirmadacom probabilidade < 0.7 (ou retornainferida/lacuna), rebaixe um nível (Alta→Média→Baixa) e anote no corpo da RN:Jev: inferida (p=0.55)— o Jev só rebaixa, nunca eleva o grau. - Agrupe as chamadas em lote (uma sessão do subagent para todas as RNs do lote), nunca 1 sessão por RN.
- O Jev é opcional — nunca gate bloqueante; se indisponível/falhar, grave a tag original e siga sem ele (avise no checkpoint da reunião).
Contradição semântica no merge (Jev, opcional) — passo 3
- RN induzida nova de re-análise reversa que toque no mesmo domínio de RN confirmada existente → submeta o PAR (texto antigo, texto novo) ao
@rdd-jev-classifiercom criteria{consistente, contraditoria, incomparavel}. contraditoriacom p >= 0.7 → NÃO sobrescrever silenciosamente: registre como candidato a Change Request (CR) emsupport/CHANGE_REQUESTS.mde sinalize no CHANGELOG.md, seguindo o fluxo de CR existente.- O Jev é opcional — se indisponível/falhar, siga o merge normal (regra geral 2) e registre o aviso; nunca bloqueie.
Formato de commit
docs: add/update requirements from meeting YYYY-MM-DD
Regras Gerais
-
Propague o REDMINE do PROJECT_CHARTER.md — leia o campo REDMINE no charter e inclua
> **REDMINE:** #[numero]no REQUIREMENTS.md. Se não houver REDMINE, omita. -
Não invente — definições, prazos, regras ou valores que não estiverem na transcrição. Se algo não estiver claro, use
question. -
Se o arquivo já existe, leia-o primeiro e faça merge incremental:
- Nunca reescreva do zero
- Novas RNs seguem numeração sequencial a partir da última existente
- Novas PENDs seguem numeração sequencial a partir da última existente
- PENDs resolvidas na reunião atual → mover para seção 10 (Decisões) com marcação
[confirmado] (data da reunião) - Contradições com o existente → use
questionem vez de corrigir
-
Se o arquivo não existe, gere do zero seguindo o template.
-
Toda RN nova deve ser registrada no CHANGELOG.md como efeito colateral.
-
Tabelas markdown: o número de segmentos
|---|no separador deve ser idêntico ao número de colunas do cabeçalho. Conte manualmente. Exemplo: 4 colunas →|---|---|---|(4 segmentos). 3 colunas →|---|---|(3 segmentos). Um segmento a mais ou a menos quebra a renderização. -
Decisões de design/escopo mencionadas na reunião devem ser registradas em DECISIONS.md no formato MADR:
- Extraia da transcrição quem decidiu (autor/decisor da decisão). Pode ser uma pessoa, um papel ('Lead Técnico', 'Cliente') ou múltiplos nomes separados por vírgula.
- Se o decisor não estiver explícito na transcrição, use
questionpara perguntar ao usuário. - Persista o decisor no campo
Decisor:de cada novo ADR (ver template abaixo). - Novos ADRs seguem numeração sequencial a partir do último existente; nunca renumerar ADRs antigos.
- ADRs existentes sem o campo
Decisor:devem ser preservados inalterados (merge incremental; não adicioneDecisor:retroativamente).
-
LINGUAGEM_UBIQUA.md — se existir no módulo, use exatamente os termos definidos nele. Termo divergente na transcrição: use o termo canônico e registre a variante em nota de rodapé.
-
Gatilho de divisão do documento — se o REQUIREMENTS.md resultante ultrapassar ~600-700 linhas, ou a transcrição cobrir mais de uma funcionalidade/módulo independente, avise o usuário que pode fazer sentido dividir em múltiplos arquivos (ex.
REQUIREMENTS_VACINACAO.md) e pergunte antes de decidir. Nunca divida automaticamente sem confirmação. -
Regra removida com relevância externa — se uma RN deixou de se aplicar mas tem relevância externa (ex.: referenciada em tarefa do Azure DevOps), marque como
[removido]com uma frase breve do motivo em vez de apagar silenciosamente. Se era puramente interna e nunca referenciada fora do documento, pode remover a linha — na dúvida, marque como removido. -
Promoção de PEND a RN (IMP-094) — PEND sai do estado aberta por promoção a RN, por virar CR (altera RN confirmada —
rdd-change-request) ou por encerrar como decisão; PEND NUNCA ancora feature. Ao promover, siga a seção "Promoção de PEND a RN (IMP-094)".
Promoção de PEND a RN (IMP-094)
PEND sai do estado aberta SOMENTE por promoção a RN (resolução define
requisito novo/complementar), por virar CR (resolução revela alteração em
RN já confirmada — via rdd-change-request, IMP-094 R2) ou por encerrar
como decisão. PEND NUNCA ancora feature (IMP-094 R1) — a feature nasce da
RN.
Ao promover uma PEND-NNN a RN:
- Numeração sequencial NOVA — a RN recebe o próximo número sequencial de RNs de REQUIREMENTS.md; NUNCA reutilize o número da PEND.
- Conteúdo derivado da PEND — texto da resolução esclarecida
(respostas do checkpoint de clarify / decisão do cliente), no padrão
EARS das demais RNs, com tag
[confirmado]e data. - Proveniência obrigatória — logo abaixo da linha da RN nova, inclua:
> Promovida de PEND-NNN em DD/MM/AAAA. - Marque a PEND de origem na §11 — mantenha a linha da PEND com a
marcação
**Promovida a RN-XXX em DD/MM/AAAA**(nunca apague a linha silenciosamente — rastreabilidade). - Registre no CHANGELOG.md — efeito colateral padrão (RN adicionada).
- A RN promovida é uma RN comum — qualquer alteração posterior passa
por CR (
rdd-change-request); nunca edite a RN promovida diretamente.
A RN criada é a âncora legítima da feature: rdd-task-spec gera a análise
e o Feature.md com a RN como âncora (IMP-094 R1).
Template — REQUIREMENTS.md (11 seções)
---
project: <NOME>
module: requisitos
audience: [tecnica, negocio]
status: draft
---
# [Nome do Sistema] — [Subtítulo descritivo]
> **REDMINE:** #[numero]
> **Última atualização:** DD/MM/AAAA
> **Objetivo:** [descrição concisa]
---
## 1. Escopo
- [item dentro do escopo]
> Fora do escopo:
> - [item fora]
---
## 2. Atores e Permissões
| Papel | Pode fazer | Não pode fazer |
|---|---|---|
---
## 3. Estrutura da Aplicação
[descrição textual]
---
## 4. Conceitos de Domínio
| Termo | API | Descrição |
|---|---|---|
---
## 5. Regras de Negócio
### [Tema]
- **RN-XXX** `[confirmado]` (DD/MM/AAAA) — `[tipo EARS]` [frase]
---
## 6. Dados e Campos
### [Entidade]
| Campo | Obrigatório | Formato | Comportamento |
|---|---|---|---|
---
## 7. Casos de Uso / Fluxos
1. [passo]
---
## 8. Saídas e Integrações
---
## 9. Persistência e Auditoria
| Entidade | Tabela | Finalidade | Rastreabilidade |
|---|---|---|---|
---
## 10. Decisões e Fora do Escopo
| Item | Decisão | Motivo |
|---|---|---|
---
> **Regra de idioma:** Requisitos em português brasileiro (PT-BR). Títulos de seção, descrições de RNs, UCs e campos em PT-BR. Apenas notação EARS (shall, must, should), identificadores (RN-001, UC-001) e termos técnicos do domínio permanecem no original.
## 11. Pendências e Dúvidas em Aberto
- **PEND-XXX** (DD/MM/AAAA) — [descrição]
- **PEND-YYY** (DD/MM/AAAA) — [descrição] `**Promovida a RN-ZZZ em DD/MM/AAAA**`
Template — Meeting (Checkpoint)
Arquivo: <modulo>/<projeto>/meetings/YYYY-MM-DD-NN.md (NN = próximo sequencial)
---
project: <NOME>
module: meeting
audience: [tecnica]
status: draft
---
# Requisitos — DD/MM/AAAA
**Resumo:** [descrição concisa do que foi discutido e incorporado]
## Perguntas e Respostas
### [pergunta]
**Resposta:** [resposta]
Template — CHANGELOG.md
# Histórico de Mudanças
## [data] — [descrição curta]
### Adicionado
- RN-XXX: [descrição]
### Alterado
- RN-YYY: [descrição da mudança]
### Removido
- RN-ZZZ: [descrição]
Template — DECISIONS.md
# Architecture Decision Records — [Nome do Módulo]
## ADR-NNN: [título curto]
**Status:** Aceito | Proposto | Rejeitado | Superseded
**Data:** DD/MM/AAAA
**Decisor:** [nome do decisor/autor da decisão] | Não informado
**Contexto:** [censo que levou à decisão]
**Decisão:** [o que foi decidido — usar linguagem direta]
**Consequências:** [impactos positivos, negativos, riscos, dívidas técnicas]
Exemplo de Commit
git add <modulo>/<projeto>/REQUIREMENTS.md <modulo>/<projeto>/DECISIONS.md <modulo>/<projeto>/CHANGELOG.md <modulo>/<projeto>/meetings/
git commit -m "docs: update requirements from meeting 2026-07-21
- Add RN-027 `[evento]` and RN-028 `[indesejado]` for batch validation
- Move PEND-001 para Decisoes (confirmado)
- Record decision on autocadastro workflow (Decisor: [nome])"
Casos de Borda
- Transcrição sem RNs novas — atualize apenas o que mudou (escopo, decisões); não gere seções vazias.
- Contradição com RN existente — não corrija silenciosamente; use
questione, se confirmada, registre CR emsupport/CHANGE_REQUESTS.md(nunca edite a RN diretamente). - Documento ultrapassando ~600-700 linhas — avise sobre divisão em múltiplos arquivos e pergunte antes.
- Linguagem ubíqua divergente da transcrição — use o termo canônico e registre a variante em nota (regra geral).
- RN com relevância externa deixando de se aplicar — marque
[removido]com motivo em vez de apagar. - Promoção de PEND a RN (IMP-094) — resolução de PEND define requisito: crie RN sequencial NOVA com proveniência
> Promovida de PEND-NNN em <data>e marque a PEND na §11 (nunca reutilize o número da PEND; nunca edite a RN promovida sem CR). Se a resolução altera RN já confirmada, o destino é CR (rdd-change-request), não RN nova.
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".