Imported from conexaoarteiro/itxpro-sdd-plugin (skills/sdd-setup/SKILL.md). Install upstream with npx skills add conexaoarteiro/itxpro-sdd-plugin --skill sdd-setup. Copyright stays with the author.

Setup do projeto SDD

Você conduz o setup: entrevista a pessoa, preenche a constituição e copia o esqueleto do pacote. Você não inventa conteúdo. O que a pessoa não respondeu fica declarado como pendência.

Fixe o locale em todo comando de contrato desta skill: export LC_ALL=en_US.UTF-8.

Passo 0 — Pré-requisitos

Rode sh "${CLAUDE_PLUGIN_ROOT}/hooks/check-prereqs.sh" antes de qualquer outra coisa.

• gitleaks ausente ou abaixo de 8.21.0: imprima o comando de instalação que o check sugere, recomende verificar o checksum do binário contra o release oficial, e PARE. A pessoa instala e roda o setup de novo.

É proibido ao agente executar o download ou a instalação do gitleaks. A skill imprime o comando e devolve a execução à pessoa. Sem gitleaks, o gate de commit é fail-closed: commit nenhum passa.

Depois, rode python3 "${CLAUDE_PLUGIN_ROOT}/hooks/check-plugins.py". Ele lê a tabela "Plugins de terceiros: instalação" de ${CLAUDE_PLUGIN_ROOT}/base/skills-padrao.md e o registro local de plugins instalados (leitura somente); imprime, para cada ausente, o comando de instalação, a fonte oficial e o que degrada sem ele. Você não instala nada e não roda o comando impresso: repita a lista no fechamento e no registro da entrevista como pendência "plugin ausente: ", com o comando ao lado. Se o script disser "não verificado", a lista inteira entra como não verificada (pendência "plugins não verificados: confira com /plugin"), nunca como presente. Nenhum plugin da tabela é pré-requisito: o setup continua.

• Plugin recomendado ausente (lista do check-plugins): continue o setup e declare a ausência como pendência no fechamento e no registro da entrevista. Ausência nunca vira silêncio.

A entrevista

Abertura, em cinco linhas:

1. Vou configurar o SDD neste projeto: preencho a constituição e crio o esqueleto.
2. São seis blocos de perguntas, uns 15 minutos.
3. "Não sei" vale como resposta e fecha o item na hora. Dá pra parar e retomar depois: o progresso vive no arquivo.
4. Nada sai da sua máquina: as respostas só vivem em arquivos deste repositório.
5. Não cole credencial, chave, connection string, token, nem dado pessoal de cliente real. Responda com categorias, não com exemplos reais.

Anuncie o progresso a cada bloco ("Bloco 3 de 6"). As regras abaixo valem a entrevista inteira.

Regras invioláveis (ux). Toda pergunta com default aceita confirmação de uma palavra. Todo bloco aceita "aceitar o bloco inteiro". "Não sei" fecha o item na hora, sem insistência.

Anti-autopreenchimento (AX). Nunca preencha lacuna com valor que a pessoa não deu. Sugestão mora na pergunta, escolha mora na resposta. É proibido inferir resposta de git config, de arquivo do repo, de outra resposta ou de conhecimento geral. Sem resposta, o item vira PENDENTE, nunca valor plausível. Grave o par pergunta → resposta no registro da entrevista antes de gravar na constituição. Nunca grave resposta que contenha "[[LACUNA:".

Higiene (security). Não cole credencial, chave, connection string, token, nem dado pessoal de cliente real. Categorias, não exemplos reais. Resposta com cara de segredo (padrões do .gitleaks.toml) não é gravada: descarte e peça reformulação. As respostas só vivem em arquivos sob a raiz do repositório do adotante.

Repita o aviso de higiene, na íntegra, antes do Bloco 2 (dado) e antes do Bloco 3 (stack).

Os seis blocos e os ids que preenchem

A pergunta e o exemplo de cada id vivem na própria lacuna do template. Faça a pergunta da lacuna, com o exemplo como default quando couber.

• Bloco 1: do fácil pro denso. Nome, produto, diferencial, estilo de escrita.
• Bloco 2: três a quatro abertas, cada uma com o exemplo da lacuna. Aviso de higiene antes.
• Bloco 3: aviso de higiene antes. Para cada camada, apresente o default do template, uma alternativa e um insight de uma frase no formato "X te serve até Y; troque se Z". Aceite por camada em uma palavra; "aceitar o bloco inteiro" fecha as nove camadas de uma vez. Na camada design-system, resposta "não tenho" grava este texto fixo (vem da skill, não é geração): Sem design system definido. A primeira fatia com UI cria o do projeto em specs/_design-system/ e ele passa a reger daí em diante. Junto, registre a pendência de forma rastreável (arbitragem do portão de Veredito da fatia 003): com GitHub disponível no projeto, crie a issue "Criar design system na primeira fatia com UI"; sem GitHub, acrescente essa pendência ao docs/roadmap.md inicial. "Não sei" grava PENDENTE como qualquer id. Pergunta da camada, no ritmo desenhado: "Camada design system: o projeto já tem um design system definido? Se sim, diga qual e onde vive (repositório, pacote ou URL dos tokens). Ex.: tokens e CSS no repositório acme-designsystem. 'Não tenho' vale e fecha a camada: a primeira fatia com UI cria o do projeto. Insight: design system declarado vira o guia do ux-architect e das demais vozes em telas, relatórios e dashboards."
• Bloco 4: o projeto tem base de conhecimento pra RAG? Existe MCP de acesso a dado? Quais outros MCPs os agentes usam? Nenhuma lacuna no template: a resposta vai ao registro da entrevista e o que exigir decisão vira pendência declarada lá.
• Bloco 5: LGPD é afirmação, não pergunta: a constituição já a assume (contexto Brasil). Pergunte o compliance específico com o menu único abaixo. Múltipla escolha; "nenhum" e "não sei" valem.
• Bloco 6: fechamento (seção Término).

Menu de compliance, uma linha de "quando se aplica" cada:

• NIST CSF 2.0: quando a empresa organiza o programa de segurança por funções, de governar a recuperar.
• NIST AI RMF: quando o produto usa IA e o risco de IA precisa de gestão nomeada.
• ISO 42001: quando a empresa quer certificar o sistema de gestão de IA.
• ISO 27001: quando cliente ou contrato exige certificação de gestão de segurança da informação.
• GDPR: quando o produto trata dado de pessoa na União Europeia.
• EU AI Act: quando o produto opera ou vende sistema de IA na União Europeia.
• SOC 2: quando cliente B2B pede relatório de controles de confiança.
• CIS Controls: quando o time quer uma lista priorizada e prática de controles técnicos.
• COBIT: quando a governança de TI corporativa exige framework formal.
• ITIL: quando a operação de serviço de TI segue processos formais de incidente e mudança.

Mecânica de preenchimento

1. Grave o par pergunta → resposta literal no registro da entrevista (abaixo), por id.
2. Em seguida substitua a lacuna inteira ([[LACUNA:id | ... ]]) no CLAUDE.md do projeto pela resposta, imediatamente. Uma resposta, uma gravação: o disco é o progresso.
3. "Não sei" grava (PENDENTE:id — o adotante decide depois) no ponto exato da lacuna.
4. Escape na gravação: se a resposta contém "[[", grave com um espaço entre os colchetes ("[ ["). Resposta contendo "[[LACUNA:" não é gravada de forma nenhuma: peça reformulação.
5. versao-plugin: leia o campo version de ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json e grave sem perguntar. É a linha de origem da constituição; atualização futura do plugin não a reescreve.

Registro da entrevista: docs/decisoes/AAAA-MM-DD-setup-sdd.md, com a data da PRIMEIRA execução. Append-only: nunca reescreva entrada existente. Retomada acrescenta ao fim do MESMO arquivo; nunca crie um segundo registro com data nova. Cada entrada tem o id, a pergunta feita e a resposta literal. O diff entre template e constituição precisa ser bijetivo com esse registro: trecho alterado sem par registrado é palpite.

O esqueleto

Esqueleto só nasce de cópia do pacote ou de lacuna preenchida, nunca de geração. Se você está redigindo conteúdo que não veio do pacote nem de resposta da pessoa, pare.

Cópia é copy-if-absent: arquivo que já existe no projeto nunca é sobrescrito; reporte e siga. Origem ${CLAUDE_PLUGIN_ROOT}/base/:

Quando gitleaks.yml for copiado ou já existir no destino, imprima este texto fixo da skill, na íntegra:

Proteção de segredo neste repositório, camada por camada: (1) o hook local do plugin bloqueia o git commit com segredo executado pelo agente nesta sessão do Claude Code (PreToolUse sobre Bash), fail-closed, na sua máquina; commit que você faz no seu terminal não passa por ele; (2) o workflow .github/workflows/gitleaks.yml varre o histórico no CI e reporta falha no job; (3) só um required check bloqueia o merge, e required check depende do plano e da visibilidade do repositório no GitHub (repositório privado em plano Free não tem required check). Nenhuma camada dessas é ativada por mim: a (1) e a (2) vêm com o esqueleto; a (3) é configuração sua no GitHub.

Em seguida, uma pergunta opcional, resposta fechada: "Este repositório é privado e está em plano Free? sim / não / não sei." Um destino por resposta:

• "Não" → registro da entrevista: "required check disponível; recomendação: marcar o job do gitleaks como required check nas regras do branch padrão".
• "Sim", "não sei" ou sem resposta → PENDENTE required-check-gitleaks no registro da entrevista, com a recomendação (required check quando o plano permitir, ou repositório público) e os comandos para a própria pessoa verificar: gh repo view --json isPrivate,visibility e gh api user --jq .plan.name (organização: gh api orgs/<org> --jq .plan.name). Você não roda esses comandos nem infere a resposta de arquivo, remoto ou git config: a regra de anti-autopreenchimento vale aqui. A pendência segue o mesmo rito do design system: com GitHub no projeto, issue "Ativar required check do gitleaks quando o plano permitir"; sem GitHub, linha no docs/roadmap.md inicial. Ela aparece no fechamento junto das demais pendências.

Crie também, vazios de conteúdo gerado: docs/decisoes/ (recebe o registro da entrevista) e docs/roadmap.md inicial (título e uma linha: as fatias entram pela mesa de Intenção). Os hooks nativos não se copiam: vêm do plugin, via hooks.json.

Término e idempotência

Término da entrevista é fato mecânico, não interpretação:

export LC_ALL=en_US.UTF-8
! grep -qF '[[LACUNA:' CLAUDE.md

Enumeração, quando precisar listar o que falta (a pessoa nunca roda grep; você roda e apresenta):

grep -nE '\[\[LACUNA:[a-z0-9-]+[^]]*\]\]' CLAUDE.md   # lacunas restantes
grep -nE 'PENDENTE:[a-z0-9-]+' CLAUDE.md               # pendências por id

Fechamento (Bloco 6), nesta ordem:

1. Resumo por bloco, uma linha cada.
2. Pendências por id, com a pergunta original ao lado (a pergunta vive no registro da entrevista).
3. Plugins recomendados ausentes (ou não verificados), um por linha, com o comando de instalação ao lado; a instalação é da pessoa.
4. Varredura anunciada: rode grep -rni itxpro CLAUDE.md, ignorando só o padrão exato itxpro-sdd@ da linha de origem e itxpro-sdd-plugin da regra de feedback; qualquer outro hit é erro de preenchimento, corrija com a pessoa.
5. Lista do que foi criado (arquivo por arquivo) e do que foi pulado por já existir.
6. Versão gravada: "constituição nascida do plugin itxpro-sdd@X.Y.Z".
7. Próximo passo único: "rode /sdd".

Re-execução da skill:

• CLAUDE.md com [[LACUNA: → retome só o que falta: enumere as lacunas restantes e pergunte só essas. Não refaça bloco fechado.
• CLAUDE.md sem [[LACUNA: → reporte a versão da linha de origem e ofereça revisar só os (PENDENTE:, por id. Nada mais é reaberto.
• Sem CLAUDE.md → setup do zero.

Racionalizações já observadas