spec-driven-workflow

Plugin do Claude Code para desenvolvimento spec-driven com workflow de 3 fases:

Pesquisa → Discussão → Execução.

Instalação

/plugin install souzalemos/spec-driven-workflow

Primeiro uso (obrigatório)

Após instalar, rode dentro do seu projeto:

/init-workflow

Este comando cria os arquivos que o plugin não pode instalar automaticamente:

• CLAUDE.md — orquestrador do workflow (customizado para seu projeto)
• 3 rules — spec-rules, code-rules, test-rules (path-scoped)
• 6 templates .spec/ — STATE, PROJECT, DECISIONS, KNOWLEDGE, REQUIREMENTS, RUNTIME
• settings.json — hooks de lint/test antes de commit
• .gitignore — atualizado com exclusões do workflow

O que o plugin instala

• 18 slash commands: /init-workflow, /start-project, /start-milestone, /discuss, /execute, /bugfix, /hotfix, /quick, /small-feature, /refactor, /spike, /security-audit, /dep-upgrade, /steer, /queue, /status, /validate, /retro
• 15 skills: research, discuss, execute-task, complete-slice, bugfix, hotfix, small-feature, refactor, spike, security-audit, dep-upgrade, adr, retrospective, start-project, status-dashboard
• 3 subagents: scout (codebase), researcher (web), reviewer (code review)
• Hooks: lint/test antes de commit, auto-format após edição

Quick Start

/init-workflow              # Configuração inicial (uma vez)
/start-project              # Projeto novo: propõe TODOS os milestones
/start-milestone            # Inicia próximo milestone da fila
/discuss                    # Planejamento com boundary map
/execute                    # Implementação (repetir por task)
/status                     # Dashboard visual
/validate                   # Validação final

Workflows Especializados

| Comando | Cerimônia | Quando usar | |---|---|---| | /hotfix | Zero | Produção quebrada, P0 | | /bugfix | Baixa | Bug com diagnóstico | | /quick | Baixa | Tarefa simples (< 7 arquivos) | | /small-feature | Média | Feature nova com 2-5 tasks | | /refactor | Média | Migração por waves | | /spike | Média | Pesquisa pura, zero código | | /security-audit | Média | Scan + triage + remediate | | /dep-upgrade | Média | Upgrade de dependências |

Novidades da v1.1

• Boundary Map obrigatório no ROADMAP.md (produces/consumes por slice)
• Slice Context (S0x-CONTEXT.md) com scope in/out e integration points
• Reassessment formal com coverage check ao completar cada slice
• continue.md para retomada de tasks interrompidas
• blocker_discovered para invalidar plano do slice
• Milestone Validation rigorosa com verification classes
• 6 workflow templates especializados (hotfix, refactor, spike, etc.)
• /start-project que propõe todos os milestones de uma vez

Licença

MIT

Autor

Bruno Lemos — souzalemos@gmail.com https://github.com/souzalemos