workflow-patterns

Visão Geral

O que é workflow-patterns?

workflow-patterns é uma skill criada para ajudar desenvolvedores e equipes a implementarem workflows estruturados de desenvolvimento orientado a testes (TDD) em projetos baseados em git. Ela oferece um processo claro para gerenciar tarefas, checkpoints de fases, commits git e protocolos de verificação, garantindo qualidade e rastreabilidade durante todo o ciclo de desenvolvimento.

Quem Deve Usar Esta Skill?

• Desenvolvedores que seguem práticas TDD
• Equipes que gerenciam projetos complexos com múltiplas fases
• Qualquer pessoa que precise acompanhar o progresso e aplicar gates de qualidade usando git
• Colaboradores que trabalham com arquivos plan.md do Conductor

Problemas Resolvidos

• Garante que as tarefas sejam concluídas na ordem correta e acompanhadas nos arquivos de plano
• Aplica o ciclo TDD red-green-refactor para cada tarefa
• Padroniza práticas de commit git para status e implementação das tarefas
• Integra protocolos de verificação para assegurar qualidade

Como Usar

Passos para Instalação

1. Instale a skill usando o comando abaixo:

   npx skills add https://github.com/wshobson/agents --skill workflow-patterns

2. Consulte a documentação principal em SKILL.md para um guia detalhado do workflow.

Primeiros Passos

• Comece pelo arquivo plan.md do seu projeto para identificar as tarefas pendentes.
• Siga o ciclo de vida TDD:
  1. Selecione a próxima tarefa [ ] na ordem.
  2. Marque-a como [~] (em andamento) no plan.md e faça um commit dessa alteração separadamente.
  3. Escreva testes que falham (fase RED) antes da implementação.
  4. Implemente a tarefa para passar nos testes (fase GREEN).
  5. Refatore conforme necessário (fase REFACTOR).
  6. Atualize o plan.md para [x] (concluído) e faça commit.
  7. Siga os protocolos de verificação conforme descrito na documentação.

Estrutura de Arquivos e Referências Principais

• SKILL.md: Guia principal do workflow
• plan.md: Acompanhamento e atualização do status das tarefas
• README.md, AGENTS.md, metadata.json: Contexto adicional e metadados
• rules/, resources/, references/, scripts/: Arquivos de suporte para uso avançado

Melhores Práticas

• Sempre faça commits das mudanças de status das tarefas separadamente das alterações de código
• Não pule fases; conclua as tarefas na ordem correta
• Use mensagens de commit claras para documentar progresso e verificações

Perguntas Frequentes

Quando o workflow-patterns é indicado?

Use workflow-patterns quando precisar de um workflow disciplinado e repetível para TDD e gerenciamento de tarefas em projetos git, especialmente ao trabalhar com arquivos plan.md do Conductor ou listas de tarefas estruturadas similares.

Posso usar workflow-patterns fora do Conductor?

Sim, embora otimizado para Conductor, o workflow e as práticas de commit podem ser adaptados para qualquer projeto baseado em git que se beneficie de TDD estruturado e acompanhamento de tarefas.

Quais arquivos devo revisar primeiro?

Comece pelo SKILL.md para uma visão geral do workflow, depois confira o plan.md com a lista de tarefas do seu projeto. Explore as pastas de suporte para configurações avançadas.

O workflow-patterns automatiza comandos git?

Não, workflow-patterns oferece um processo e documentação para gerenciar tarefas e commits, mas não automatiza operações git. Você deve executar os comandos git manualmente seguindo o workflow.

Onde encontro mais detalhes?

Abra a aba Files no repositório para explorar toda a documentação, referências e scripts auxiliares para um entendimento mais profundo e personalização.