By souzalemos
Workflow Pesquisa → Discussão → Execução para desenvolvimento spec-driven com Claude Code. Milestones, slices e tasks com 3 fases obrigatórias. 18 commands, 15 skills, 3 agents.
npx claudepluginhub souzalemos/spec-driven-workflow --plugin spec-driven-workflowInvestigue e corrija um bug específico. Siga o skill **bugfix** rigorosamente.
Upgrade de dependencias com analise de impacto e breaking changes.
Inicie a fase de discussão para o milestone atual. Nenhum código será escrito.
Execute a próxima task pendente do milestone atual.
Fix URGENTE com cerimonia ZERO. Producao quebrada, velocidade maxima.
Configure o workflow spec-driven no projeto atual. Rode este comando uma vez apos instalar o plugin.
Enfileire o próximo milestone sem interromper o trabalho atual.
Execute uma tarefa rápida com as garantias do workflow, mas sem a cerimônia completa de milestone.
Refatoracao ou migracao sistematica com inventario e execucao por waves.
Faça uma retrospectiva do milestone recém-completado.
Auditoria de seguranca sistematica do codebase.
Feature com planejamento leve — mais que /quick, menos que /start-milestone.
Pesquisa pura — investigar, avaliar opcoes, recomendar. NENHUM codigo de producao.
Inicie um novo milestone para o projeto. Siga este processo rigorosamente:
Inicie um projeto NOVO do zero. Diferente de /start-milestone que cria 1 milestone,
Mostre o dashboard visual do estado do projeto no terminal.
Ajuste o plano do milestone ou slice em andamento sem interromper o progresso.
Valide o milestone completado com verificacao rigorosa. Todos os slices devem estar [x] no ROADMAP.md.
Pesquisa externa sobre tecnologias, libs, best practices e padrões. Use quando precisar de informação que não está no codebase.
Revisão de código antes de marcar task como completa. Verifica qualidade, segurança e aderência ao plano. Use após implementação e antes do commit.
Reconhecimento rápido do codebase. Use quando precisar entender a estrutura, padrões e dependências do projeto antes de tomar decisões. Ideal para início de milestones e antes de mudanças arquiteturais.
Use quando uma decisão arquitetural importante precisa ser registrada com mais detalhes do que o formato padrão do DECISIONS.md. Ativado por: "registrar decisão", "ADR", decisões sobre banco de dados, frameworks, padrões arquiteturais, infraestrutura.
Use quando for investigar e corrigir um bug específico. Segue o fluxo: investigar → diagnosticar → corrigir → verificar → documentar. Ativado por: /bugfix, "corrigir bug", "fix", "está quebrado", "não funciona", "erro em", "bug no", menções de stack traces ou erros.
Use quando todas as tasks de um slice foram completadas. Gera UAT, faz reassessment formal do roadmap, atualiza estado. Ativado por: última task do slice completa, /validate-slice.
Upgrade de dependencias com analise de impacto. Assess, upgrade, fix, verify. Para: atualizar pacotes, bump de versoes, renovate, npm update. Ativado por: /dep-upgrade, "atualizar dependencias", "upgrade", "outdated", "bump".
Use durante a fase de discussão de um milestone. Apresenta pesquisa, facilita decisões, cria roadmap e decompõe em tasks. Ativado por: /discuss, após fase de pesquisa, pedidos de planejamento.
Use quando for executar uma task específica de um slice. Implementa, verifica, documenta e commita. Uma task por vez. Ativado por: /execute, pedidos de implementação, "próxima task".
Cerimonia minima para fixes urgentes. Producao quebrada, prioridade maxima. Ativado por: /hotfix, "urgente", "producao caiu", "critico", "P0", "ASAP".
Refatoracao ou migracao sistematica com inventario e execucao por waves. Para: renomear, reestruturar, migrar patterns, modernizar APIs. Ativado por: /refactor, "refatorar", "migrar", "renomear", "reestruturar", "reorganizar".
Use quando iniciar pesquisa para um novo milestone ou slice. Mapeia o codebase existente e pesquisa ecossistema externo. Ativado por: /start-milestone, início de novo milestone, pedidos de pesquisa.
Use após validar e completar um milestone para fazer retrospectiva. Analisa o que funcionou, o que não funcionou, e extrai lições. Ativado por: /retro, após /validate, "retrospectiva", "o que aprendemos".
Auditoria de seguranca sistematica. Scan, triage, remediate, re-scan. Cobre OWASP Top 10, dependencias vulneraveis e concerns do projeto. Ativado por: /security-audit, "auditoria seguranca", "vulnerabilidade", "OWASP", "CVE".
Feature com planejamento leve. Mais estrutura que /quick, menos que milestone. Para: novo comando, endpoint, componente, modulo. 2-5 tasks. Ativado por: /small-feature, "adicionar feature", "criar endpoint", "novo componente".
Pesquisa pura. Investigar questao, avaliar opcoes, prototipar se necessario. Output e CONHECIMENTO, nao codigo de producao. Para: avaliacao de tech, decisoes de arquitetura, "devemos usar X?". Ativado por: /spike, "pesquisar", "investigar", "comparar", "avaliar", "e se".
Ponto de entrada para projetos NOVOS. Analisa o escopo completo, propoe multiplos milestones com decomposicao, e cria a estrutura inteira. Diferente de /start-milestone que cria 1 milestone por vez. Ativado por: /start-project, "novo projeto", "comecar do zero", "greenfield".
Gera um dashboard visual no terminal com o estado completo do projeto. Mostra milestone, slices, tasks, progresso, decisões e próxima ação. Ativado por: /status, "status", "como está o projeto", "progresso".
Plugin do Claude Code para desenvolvimento spec-driven com workflow de 3 fases: Pesquisa → Discussão → Execução.
/plugin install souzalemos/spec-driven-workflow
Após instalar, rode dentro do seu projeto:
/init-workflow
Este comando cria os arquivos que o plugin não pode instalar automaticamente:
/init-workflow, /start-project, /start-milestone, /discuss, /execute, /bugfix, /hotfix, /quick, /small-feature, /refactor, /spike, /security-audit, /dep-upgrade, /steer, /queue, /status, /validate, /retro/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
| 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 |
MIT
Bruno Lemos — souzalemos@gmail.com https://github.com/souzalemos
Battle-tested Claude Code plugin for engineering teams — 38 agents, 156 skills, 72 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Works with Claude Code, Kiro, Clawd CLI, Gemini CLI, Cursor, Continue, Hermes, and 17+ AI coding assistants. Now with Arabic, German, Spanish, and Chinese (Simplified & Traditional) support.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Comprehensive startup business analysis with market sizing (TAM/SAM/SOM), financial modeling, team planning, and strategic research
Uses Bash, Write, or Edit tools