SDD — Spec-Driven Development (plugin multiplataforma)

Fluxo de desenvolvimento guiado por spec, empacotado como plugin de skills instalável em Cursor, Claude Code, OpenAI Codex, GitHub Copilot CLI, Gemini CLI e OpenCode.

As skills cobrem o ciclo completo — /sdd-init (bootstrap) → 01 New → 02 Research → 03 Specify → 04 Plan → 05 Review → 06 Execute (implement + review loop; worktree opt-in) → 07 Spec review → 08 Docs → finish-branch — mais skills transversais de TDD condicional, debugging, verificação, worktrees, receber review, execução paralela, commit message e design de schema PostgreSQL.

Em cada mudança rastreável, o fluxo também gera documentação de histórico versionada no repositório — pasta specs/ com spec (As Is → To Be), plano, execuções, revisões e implementation-log.md — registrando o porquê, o que mudou e como foi validado.

Genérico por design. As skills não assumem stack/linguagem. O específico de cada projeto (comandos de build, issue tracker, integrações, branch base, mapas) vive no AGENTS.md do repositório que consome o plugin. Veja o contrato em skills/using-sdd/references/agents-md-contract.md.

Repositório: guskuma/sdd-workflow.

O /sdd-01-new faz o scaffold de specs/ na primeira mudança do repositório (templates em specs/templates/). Cada spec vive em uma pasta datada e acumula artefatos ao longo das fases:

specs/
├── templates/                 # cópia dos templates do plugin (primeira spec)
├── implementation-log.md      # índice global de specs concluídas
└── YYYY-MM-{ISSUE-KEY}-slug/
    ├── spec.md                # As Is, To Be, goals, restrições (research → specify)
    ├── design.md              # opcional — alta complexidade (specify)
    ├── tasks.md               # opcional — backlog detalhado (plan, ≥ 5 tasks)
    ├── executions.md          # gates, revisões, desvios, fechamento (execute → docs)
    ├── issue-summary.md       # snapshot da issue (new)
    └── mr-template.md         # corpo do MR/PR (preenchido em docs)

Sem issue tracker? Use um identificador curto no lugar de {ISSUE-KEY} (ex.: o slug) e marque os campos de issue como N/A. A convenção completa está em skills/using-sdd/references/agents-md-contract.md.

Inclui ainda: commands/ (slash /sdd-init e /sdd-0X), agents/code-reviewer.agent.md, templates SDD empacotados (scaffoldados em specs/ pelo /sdd-01-new; bootstrap de projeto pelo /sdd-init).

Adicione o marketplace e instale o plugin sdd-workflow (ou aponte o Cursor para este repositório como plugin). Os comandos /sdd-init e /sdd-0X ficam disponíveis no chat.

/plugin marketplace add guskuma/sdd-workflow
/plugin install sdd-workflow@sdd-marketplace

copilot plugin marketplace add guskuma/sdd-workflow
copilot plugin install sdd-workflow@sdd-marketplace

Peça ao Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/guskuma/sdd-workflow/refs/heads/main/.codex/INSTALL.md

Detalhes: .codex/INSTALL.md.

gemini extensions install https://github.com/guskuma/sdd-workflow

Detalhes: .opencode/INSTALL.md.

1. O hook SessionStart injeta a skill using-sdd no início da sessão (formato JSON detectado por plataforma).
2. using-sdd orienta o agente a sempre consultar o AGENTS.md do projeto e a invocar as skills relevantes.
3. Sem AGENTS.md, o agente sugere /sdd-init para analisar o repositório e gerar os arquivos de bootstrap.
4. As skills usam nomes de tools do estilo Claude Code/Cursor; o mapeamento para outras plataformas está em skills/using-sdd/references/*-tools.md.

Para o fluxo funcionar bem, o repositório que usa o plugin precisa de um AGENTS.md na raiz com, no mínimo: Gate de qualidade (comandos de lint/test/build), issue tracker, branches, integrações externas e restrições padrão. Modelo completo em skills/using-sdd/references/agents-md-contract.md.

Primeira vez no projeto? Rode /sdd-init — a skill detecta stack, comandos de CI, issue tracker e convenções Git quando possível, gera AGENTS.md (ou preenche lacunas no existente) e cria CLAUDE.md / GEMINI.md apontando para ele.

Onde um recurso não existe, as skills degradam graciosamente (ex.: sem Plan mode, descrevem o micro-plano no chat; sem subagentes, executam sequencialmente).

MIT — ver LICENSE.