workflow-orchestration-patterns

Visão Geral

O que é workflow-orchestration-patterns?

workflow-orchestration-patterns é um módulo de habilidade focado no design de workflows robustos e duráveis para sistemas distribuídos usando Temporal. Ele oferece padrões práticos e orientações arquiteturais para orquestrar processos de negócios complexos e de longa duração, transações distribuídas e coordenação de microsserviços. A habilidade cobre conceitos essenciais como separação entre workflow e atividade, padrões saga, gerenciamento de estado e restrições de determinismo, tornando-se um recurso valioso para desenvolvedores backend e arquitetos que constroem sistemas resilientes.

Para quem esta habilidade é indicada?

Esta habilidade é ideal para engenheiros backend, arquitetos de sistemas e profissionais de DevOps que precisam automatizar, coordenar ou gerenciar processos multi-etapas entre serviços distribuídos. Se você está construindo workflows críticos para o negócio que exigem confiabilidade, recuperação de falhas e persistência de estado, workflow-orchestration-patterns foi feito para você.

Problemas resolvidos

• Orquestração de processos multi-etapas entre serviços, bancos de dados ou máquinas
• Implementação de transações distribuídas com garantias do tipo tudo ou nada
• Gerenciamento de workflows de longa duração com persistência automática de estado e recuperação
• Tratamento de processos de negócio como gestão de pedidos, aprovações e automação de infraestrutura

Como Usar

Passos para Instalação

1. Instale a habilidade usando o comando abaixo:

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

2. Comece revisando o arquivo SKILL.md para uma visão geral e orientações práticas.

3. Explore arquivos de suporte como README.md, AGENTS.md, metadata.json e quaisquer diretórios rules/, resources/, references/ ou scripts/ para obter contexto e detalhes de implementação.

4. Adapte os padrões e recomendações fornecidos para seu próprio repositório, infraestrutura e requisitos operacionais. Evite copiar exemplos literalmente — personalize-os para seu caso de uso.

Conceitos-Chave Abordados

• Separação entre Workflow e Atividade: Entenda o princípio central do design Temporal para orquestração confiável.
• Padrões Saga: Implemente transações distribuídas com lógica de compensação e rollback.
• Gerenciamento de Estado: Persista o estado do workflow para processos de longa duração.
• Restrições de Determinismo: Garanta que workflows sejam reproduzíveis e tolerantes a falhas.

Quando Usar workflow-orchestration-patterns

• Processos de negócio multi-etapas (ex: reservas, atendimento de pedidos, aprovações)
• Transações distribuídas que exigem consistência e rollback
• Workflows de longa duração que precisam sobreviver a falhas ou reinicializações
• Automação de infraestrutura (CI/CD, provisionamento, deploys)
• Sistemas com intervenção humana, com timeouts e escalonamentos

Quando NÃO Usar

• Operações CRUD simples ou chamadas de API sem estado
• Pipelines puramente de dados (considere Airflow ou ferramentas de processamento em lote)
• Streaming em tempo real (considere Kafka ou processadores de eventos)

Perguntas Frequentes

Qual o principal benefício de usar workflow-orchestration-patterns?

workflow-orchestration-patterns ajuda a projetar e implementar workflows confiáveis e fáceis de manter para sistemas distribuídos usando Temporal, reduzindo riscos de erros e simplificando a recuperação de falhas.

Como começar após a instalação?

Comece lendo o arquivo SKILL.md para uma visão geral. Depois, revise a documentação relacionada e adapte os padrões para sua arquitetura backend ou de microsserviços.

Posso usar essa habilidade para sistemas sem estado ou em tempo real?

Não, workflow-orchestration-patterns é mais indicado para processos com estado, de longa duração ou multi-etapas. Para sistemas sem estado ou streaming em tempo real, considere outras ferramentas como Kafka ou APIs padrão.

Onde encontro mais exemplos ou referências?

Abra a aba Files no repositório para explorar toda a árvore de arquivos, incluindo referências aninhadas, scripts auxiliares e documentação de suporte para aprofundar seu conhecimento.