Adaptive SDD Workflow Skill

Workflow reutilizável para usar SDD no Codex: descoberta de produto, especificação, planejamento técnico, implementação com gates, validação final e handoff.

O pacote instala CLIs globais pelo npm e registra uma skill do Codex para governar o processo dentro dos projetos.

Instalação

npm install -g @vonderheidon/adaptive-sdd-workflow-skill
sdd-workflow-install-skill

Para também tentar instalar dependências conhecidas:

sdd-workflow-install-skill --install-deps

No PowerShell, se npm ou os comandos sem extensão forem bloqueados por política de execução, use os wrappers .cmd:

sdd-workflow-install-skill.cmd
sdd-workflow-init.cmd
sdd-workflow-doctor.cmd

Primeiro Uso

Em um projeto novo:

mkdir meu-projeto
cd meu-projeto
git init
sdd-workflow-init
sdd-workflow-doctor

Depois, no Codex, inicie o fluxo:

/iniciar-projeto-sdd

Ou crie uma feature diretamente:

sdd-workflow-start-feature user-login --scaffold

Dependências De Skills

sdd-workflow-install-skill instala a skill principal e verifica as auxiliares:

• grill-me: instalada automaticamente a partir da cópia embutida quando faltar.
• grill-me-with-docs: instalada automaticamente a partir da cópia embutida quando faltar.
• tlc-spec-driven: verificada por padrão; com --install-deps, o CLI tenta instalar via npx --yes @tech-leads-club/agent-skills install -s tlc-spec-driven.
• context7-mcp: verificada em ~/.codex/skills e ~/.agents/skills; se faltar, instale manualmente conforme a fonte oficial do seu ambiente.

Comandos Principais

sdd-workflow-install-skill
sdd-workflow-install-skill --install-deps
sdd-workflow-init
sdd-workflow-doctor
sdd-workflow-start-feature minha-feature --scaffold
sdd-workflow-pr --draft

Também existe o roteador:

adaptive-sdd-workflow init
adaptive-sdd-workflow install-skill
adaptive-sdd-workflow doctor
adaptive-sdd-workflow start-feature minha-feature --scaffold

Documentação

• Quickstart: instalação e uso em poucos minutos.
• Manual: modelo operacional, estados, gates e regras do workflow.
• Maintainer: estrutura interna do pacote, release e publicação npm.

Defaults

• Branch por feature: codex/<feature-slug>.
• Branch criada no início da feature.
• Commit, push e PR são explícitos/manuais.
• Validação final é uma etapa separada e explícita.
• Contexto alvo antes de codar: abaixo de 40k tokens.