Fluxo de Trabalho de IA Estruturado com Comandos Baseados em Fases para Reduzir Retrabalho

Um desenvolvedor no r/ClaudeAI descreve um fluxo de trabalho repetível e programável projetado para abordar problemas persistentes ao usar IA para desenvolvimento diário. O problema central identificado não era precisar de um modelo mais inteligente, mas sim de um processo repetível para parar de corrigir os mesmos erros. Os principais pontos de dor incluíam a IA perdendo contexto entre sessões, quebrando padrões do projeto em aspectos básicos como nomenclatura e estilo, misturando planejamento com execução e tratando a documentação como uma reflexão tardia.

Fluxo de Trabalho Baseado em Comandos por Fase

A solução substitui a dependência de um único prompt gigante por uma série de comandos claros e específicos por fase:

• /pwf-brainstorm – Define escopo, arquitetura e decisões.
• /pwf-plan – Transforma o brainstorm em fases e tarefas executáveis.
• Portões de qualidade opcionais: /pwf-checklist, /pwf-clarify, /pwf-analyze.
• /pwf-work-plan – Executa o plano fase por fase.
• /pwf-review – Realiza uma revisão mais profunda.
• /pwf-commit-changes – Fecha a tarefa com commits estruturados.

Para tarefas pequenas, o desenvolvedor usa /pwf-work, mas mantém a disciplina de revisão e documentação.

A Regra Crítica

A regra que teve o impacto mais significativo na qualidade: /pwf-work e /pwf-work-plan são obrigados a ler a documentação antes da implementação e atualizá-la depois. Isso garante que a IA trabalhe com "memória do projeto" em vez de "meio cega", melhorando dramaticamente a consistência e reduzindo o retrabalho.

Estrutura de Projeto de Suporte

O fluxo de trabalho é suportado por uma estrutura de projeto específica para melhorar o contexto da IA:

• Uma pasta para repositórios de código.
• Uma pasta para ativos do espaço de trabalho (documentos, controles, configurações).

Ambas as pastas são abertas como multi-raiz em um editor (como VS Code ou Cursor), criando uma experiência semelhante a um monorepo que ajuda a IA a ver o sistema completo sem caos.

Resultados e Referências

O desenvolvedor relata impactos diretos: menos erros repetidos, menos retrabalho, melhor consistência entre sessões e mais produção com menos erros. Eles citaram o fechamento de 25 tarefas (pequenas, médias, grandes) em um dia ao evitar o mesmo ciclo de erro. A abordagem foi informada pelo estudo de conceitos como Compound Engineering, Superpowers, Spec Kit e Spec-Driven Development, mas adaptada e refinada através do uso pessoal, em vez de copiar uma estrutura.