Workflows de Desenvolvimento
Seis abordagens para desenvolver software de alta qualidade com Claude Code — do dev solo ao pipeline 100% autônomo. Cada workflow incorpora Clean Code, TDD, arquitetura hexagonal, testes completos e segurança OWASP.
Por que workflows importam
Existe uma diferença fundamental entre pedir para o Claude escrever código e orquestrar um workflow de desenvolvimento. A primeira abordagem delega uma tarefa. A segunda orquestra um processo.
Quando você simplesmente pede ao Claude para escrever uma função, você recebe uma função. Pode estar correta, pode ser legível, mas provavelmente não tem testes, não segue a arquitetura do projeto, não passou por revisão de segurança e não foi validada contra os requisitos reais.
Um workflow muda a equação. Ele define como o Claude deve operar — quais etapas seguir, quais critérios de qualidade aplicar, quais portas de verificação passar antes de avançar. O modelo executa dentro de um processo deliberadamente estruturado.
"O melhor modelo com um workflow ruim produz código ruim. O pior modelo com um workflow excelente produz código defensável."
Isso significa que a escolha do workflow é mais determinante para a qualidade do resultado do que a escolha do modelo. Os workflows nesta parte do curso foram projetados para garantir, em cada abordagem, que TDD, arquitetura hexagonal, cobertura de testes e segurança OWASP não sejam opcionais — são parte do processo.
Os seis workflows
Cada workflow foi projetado para um contexto específico. Eles não são mutuamente exclusivos — você pode combinar elementos ou migrar de um para outro conforme o projeto evolui.
O workflow mais direto. Você e o Claude Code, sem dependências externas. Ideal para projetos pessoais, protótipos rápidos e situações onde velocidade importa mais do que processo.
Módulo 23Integração com o GSD skill para gerenciamento de milestones, memória cross-session e execução em waves. Pensado para times com roadmap definido e entregas planejadas.
Módulo 24Usa o Cortex para memória semântica organizacional. Três agentes paralelos (implementador, revisor, testador) com contexto persistente entre sessões e projetos.
Módulo 25Workflow focado em uma feature única do início ao fim. Três agentes com papéis definidos: arquiteto, implementador e code-reviewer. Overhead baixo, qualidade controlada.
Módulo 26Autonomia máxima. N agentes especializados operam em pipeline sem intervenção humana — agente de testes, agente de segurança, agente de build. Ideal para CI/CD autônomo.
Módulo 27A abordagem production-grade. Combina GSD, múltiplos skills, gates de qualidade rigorosos e intervenção humana mínima nos pontos certos. Para quem não aceita comprometer qualidade.
Módulo 28Tabela comparativa
Use esta tabela para comparar os workflows nas dimensões que mais importam para o seu contexto. Cada célula resume o comportamento padrão — os módulos individuais detalham como personalizar.
| Dimensão | W1 Solo | W2 GSD | W3 Cortex | W4 Feature Dev | W5 Agentic | W6 Ideal |
|---|---|---|---|---|---|---|
| Instalação | nenhuma | GSD skill | brew install cx |
plugin install | nenhuma | GSD + skills |
| Overhead | mínimo | médio | médio | baixo | alto setup | alto |
| Paralelismo | nenhum | waves | 3 agentes | 3 agentes | N agentes | multi-wave |
| Memória cross-session | manual | GSD memory | Cortex semantic | nenhum | arquivos | híbrido |
| PM envolvido | não | sim (discuss) | não | não | não | sim |
| TDD enforçado | manual | via execute | via /implement | via reviewer | via test agent | hard gate |
| OWASP gate | manual | security phase | memory + review | code-reviewer | security agent | CI gate |
| Ideal para | solo/rápido | times/milestones | memória org. | feature única | CI autônomo | prod-grade |
| Intervenção humana | total | gates | gates | gates | zero | gates mínimos |
Árvore de decisão
Se você ainda não sabe qual workflow usar, percorra este diagrama. Cada bifurcação leva à recomendação mais adequada para o seu contexto atual.
Árvore de decisão para escolha do workflow adequado ao contexto
Fundamentos transversais
Todos os seis workflows compartilham os mesmos fundamentos de qualidade. Antes de escolher um workflow, leia o Módulo 22 — Fundamentos de Qualidade. Ele define os critérios que cada workflow implementa à sua maneira.
Os sete fundamentos transversais presentes em todos os workflows são:
- Clean Code + SOLID — nomenclatura, funções pequenas, responsabilidade única, extensibilidade
- Arquitetura Hexagonal — portas e adaptadores, separação de domínio e infraestrutura, testabilidade por design
- TDD (Test-Driven Development) — testes escritos antes da implementação, ciclo red-green-refactor
- Pirâmide de Testes — unitários, integração e E2E em proporção adequada, sem gaps de cobertura
- OWASP Top 10 — validação de entrada, controle de acesso, exposição de dados, injeção e demais categorias
- Context Window Discipline — prompts concisos, contexto relevante, evitar overflow e degradação de qualidade
- Frontend Design Standards — acessibilidade, responsividade, consistência visual e experiência do usuário
Como usar este módulo
Esta visão geral é o ponto de entrada da Parte 6. Siga esta sequência para aproveitar ao máximo:
- Leia os fundamentos primeiro. O Módulo 22 — Fundamentos de Qualidade define o vocabulário comum e os critérios de qualidade que todos os workflows aplicam. Pular este passo significa não entender por que cada workflow faz o que faz.
- Escolha seu workflow pela tabela comparativa. Identifique as dimensões mais relevantes para o seu contexto — tamanho do time, necessidade de memória cross-session, grau de autonomia desejado — e use a tabela acima para filtrar as opções.
- Use a árvore de decisão se ainda tiver dúvida. O diagrama percorre as perguntas certas para chegar à recomendação mais adequada ao seu momento atual.
- Leia o módulo do workflow escolhido em profundidade. Cada workflow tem seu próprio módulo com setup completo, exemplos práticos e instruções de prompt.
Todo workflow desta parte já inclui TDD, OWASP, testes completos e arquitetura hexagonal como partes não-negociáveis do processo — não como opcionais a adicionar depois.