Ir para o conteúdo

Orchestration Flow
Tipo Coordenação multi-ticket
Trigger 2+ tickets ativos em paralelo, início de sprint, revisão semanal de prioridades — /manage-queue
Agentes orchestrator-agent
Checkpoints humanos 1 (Tech Lead revisa o Queue Report)

Pré-requisito: instalação concluída — ver 00 — Instalação e Setup.

1. O que é e quando usar

Workflow meta: não entrega código — coordena os demais workflows quando há vários tickets concorrendo. Prioriza o backlog, detecta conflitos entre tickets e aloca devs em lanes isoladas.

Use quando: - O time tem 2+ tickets ativos em paralelo. - Início de sprint (snapshot do backlog). - Revisão semanal de prioridades.

Não use quando: - Há apenas 1 ticket ativo — desnecessário. - Um P1 está em andamento — P1 tem prioridade absoluta, não interrompa para rodar manage-queue.

2. Visão geral do fluxo

Tickets ativos em .ns-flow/state/
          │
          ▼
    /manage-queue
          │
          ▼
  orchestrator-agent
  ├── Inventário de tickets (lê todos os state.md)
  ├── Leitura do risk-map
  ├── Detecção de conflitos (mesmo arquivo crítico / migration no mesmo schema)
  └── Priorização (P1 > P2 > P3 > P4 → fase → antiguidade)
          │
          ▼
   Queue Report → .ns-flow/orchestration/queue-<DATA>.md
          │
          ▼
  ⚡ Checkpoint — Tech Lead revisa
          │
    ┌─────┴──────┐
 Sem conflito   Conflito detectado
    │                │
  Devs alocados   Sequenciar tickets
    └─────┬──────────┘
          ▼
  Cada ticket segue bug-flow ou feature-development
  independentemente em sua lane

3. Passo a passo

Passo 1 — /manage-queue [dev1 dev2 ...] — orchestrator-agent

  1. Lê todos os state files em .ns-flow/state/ e extrai fase atual, severidade, módulos afetados.
  2. Identifica orphans (tickets sem state.md).
  3. Cruza módulos afetados com o risk-map.md para detectar sobreposições.
  4. Prioriza por P1 > P2 > P3 > P4, depois fase, depois antiguidade.
  5. Detecta conflitos BLOQUEANTES (mesmo arquivo crítico ou migration no mesmo schema).
  6. Gera recomendações de alocação se os devs forem informados. Output: .ns-flow/orchestration/queue-<DATA>.md → Parar. Checkpoint.

Passo 2 — ⚡ Checkpoint (Tech Lead revisa)

O Tech Lead valida prioridades, confirma/ajusta alocação de devs, decide sequenciamento de tickets em conflito e cria state.md para orphans.

Passo 3 — Execução em lanes isoladas

Cada dev segue o fluxo padrão do seu ticket: 

Bug:     /analyze-bug → /generate-fix → /run-regression → [/smoke → /validacao-testes → /qa-gate] → /open-pr → /release-check
Feature: /feature → (design/tasks se L/C) → [/qa-gate: cobertura+smoke+E2E] → /open-pr → /release-check
Cada lane passa pela Esteira de Qualidade (4 gates) antes do PR — independentemente.

Regras de isolamento: - Conflito BLOQUEANTE: um ticket aguarda o merge do outro antes de avançar para delivery. - Conflito ATENÇÃO: devs se comunicam antes de iniciar a fase de delivery. - Migrations: o primeiro ticket que chegar ao delivery "trava" o schema; o segundo aguarda.

Passo 4 — Re-execução periódica

Rode /manage-queue novamente quando: um ticket encerrar, surgir um novo P1/P2, um dev ficar disponível, ou no início de sprint. Frequência recomendada: toda segunda-feira + a cada P1 aberto.

4. Checkpoint humano

# Quando Quem aprova Verifica
1 Após Queue Report Tech Lead Prioridades corretas? Alocação confirmada? Sequenciamento de conflitos? Orphans tratados?

5. Pastas e arquivos

Etapa Arquivo
Entrada todos os .ns-flow/state/<ticket>-state.md + .speckit/architecture/risk-map.md
Queue Report .ns-flow/orchestration/queue-<DATA>.md

Não gera artifacts de delivery — esses vêm dos workflows individuais que ele coordena.

6. Aplicação pelo time (papéis)

Papel Responsabilidade
Tech Lead Roda /manage-queue, revisa e aprova o Queue Report, decide sequenciamento e alocação
Devs Mantêm seus state.md atualizados; respeitam as regras de isolamento de lanes

Pré-condição prática: o valor do Orchestration Flow depende de state files atualizados. Times que mantêm .ns-flow/state/ em dia extraem priorização e detecção de conflito confiáveis.

Referências

Voltar ao topo