| name | dev-workflow |
| description | Executa workflow completo de desenvolvimento (plan → implement → test → review). Use para implementar features ou corrigir bugs de forma estruturada e sequencial. |
Dev Workflow
Workflow completo de desenvolvimento que executa sequencialmente as etapas de planejamento, implementação, testes e revisão.
Uso
/dev-workflow Implementar sistema de autenticação com JWT
Variables
FEATURE_DESC: $ARGUMENTS
SPEC_FILE: specs/<nome_gerado>.md
SPECS_DIR: specs/
Mapeamento de Ferramentas
| Ferramenta | Descrição |
|---|
Read | Leitura de arquivos e specs |
Write | Criação de arquivos |
Edit | Edição de arquivos existentes |
Glob | Busca por padrões de nome |
Grep | Busca por conteúdo |
Bash | Execução de comandos e testes |
Task | Execução de subagentes |
Instruções
Execute o workflow completo de desenvolvimento para: $ARGUMENTS
Validação Inicial
- Se
$ARGUMENTS estiver vazio, pergunte ao usuário o que deseja implementar
- Inicie o workflow automaticamente sem confirmação
Etapa 1: Planejamento (/plan)
Objetivo: Criar um plano detalhado de implementação
- Execute o comando
/plan com a descrição fornecida
- O plano será salvo em
specs/<nome_descritivo>.md
- Apresente o resumo do plano ao usuário
- Prossiga automaticamente para a implementação
Output: Arquivo de spec em specs/
Etapa 2: Implementação (/implement)
Objetivo: Implementar o código conforme o plano
- Execute o comando
/implement com o arquivo de spec gerado
- Implemente todos os itens listados no plano
- Marque os checkboxes conforme cada item é concluído:
- [ ] → - [x]
- Apresente um resumo das implementações realizadas
- Prossiga automaticamente para os testes
Output: Arquivos criados/modificados conforme spec
Etapa 3: Testes (/test)
Objetivo: Validar e executar testes
- Execute o comando
/test referenciando o arquivo de spec
- Verifique se arquivos foram criados corretamente
- Execute os testes unitários e de integração
- Corrija falhas automaticamente se possível
- Apresente o resultado dos testes
- Prossiga automaticamente para a revisão
Output: Relatório de testes com status
Etapa 4: Revisão (/review)
Objetivo: Revisar o código implementado
- Execute o comando
/review para analisar as mudanças
- Compare implementação com a spec original
- Identifique gaps, melhorias e inconsistências
- Apresente o relatório de revisão ao usuário
- Se houver problemas críticos, sugira correções
Output: Relatório de revisão com veredicto
Finalização
Ao concluir todas as etapas, apresente um resumo completo:
# Workflow Concluído ✅
## Resumo
| Aspecto | Valor |
|---------|-------|
| **Feature/Bug** | [descrição] |
| **Plano** | specs/[nome].md |
| **Arquivos criados** | X arquivos |
| **Arquivos modificados** | Y arquivos |
| **Testes** | X passando, Y falhando |
| **Revisão** | APROVADO/COM RESSALVAS/REPROVADO |
## Pipeline Executado
| Etapa | Status | Observação |
|-------|--------|------------|
| Plan | ✅ | spec gerada |
| Implement | ✅ | X arquivos |
| Test | ✅ | X/Y testes |
| Review | ✅ | aprovado |
## Arquivos Criados/Modificados
- `src/arquivo1.ts` - Criado
- `src/arquivo2.ts` - Modificado
## Próximos Passos
1. Fazer merge para branch principal
2. Deploy em staging
3. Validação manual (se necessário)
Regras do Workflow
- Sequencial: Cada etapa deve ser completada antes de iniciar a próxima
- Automático: Execute todas as etapas sem interrupção
- Transparência: Mantenha o usuário informado do progresso em cada etapa
Tratamento de Erros
| Etapa | Falha | Ação |
|---|
| Plan | Requisitos ambíguos | Perguntar ao usuário |
| Implement | Arquivo não criado | Tentar novamente ou registrar |
| Test | Testes falhando | Tentar corrigir ou prosseguir |
| Review | Reprovado | Listar correções e continuar |
- Se qualquer etapa falhar, tente corrigir automaticamente
- Se não for possível corrigir, continue para a próxima etapa
- Registre todos os problemas no relatório final
Cenários de Uso
Nova Feature
/dev-workflow Criar sistema de pagamentos com Stripe
Correção de Bug
/dev-workflow Corrigir bug de login que falha com email maiúsculo
Refatoração
/dev-workflow Refatorar módulo de autenticação para usar JWT
Integração com Comandos
| Etapa | Comando | Arquivo |
|---|
| 1 | /plan | .gemini/commands/plan.md |
| 2 | /implement | .gemini/commands/implement.md |
| 3 | /test | .gemini/commands/test.md |
| 4 | /review | .gemini/commands/review.md |