Vários agentes, um repo

Cada agente pega uma tarefa. Os outros veem que ela está pega e não conseguem pegá-la também.

  • OrquestradorDivide o objetivo em tarefas, cada uma com suas pastas.
  • SubagentesCada um pega uma tarefa e trabalha em paralelo.
  • ScopesUm agente que entra nas pastas de outro é avisado. Uma tarefa já pega é recusada.

Sem ele

  • A mesma tarefa, duas vezes

    Dois agentes começam a mesma tarefa. Nenhum dos dois sabe.

  • Os mesmos arquivos, sobrescritos

    Duas tarefas mexem no mesmo código. Você descobre no merge.

  • Trabalho abandonado

    Uma sessão cai. A tarefa parece pega, mas ninguém está nela.

Uma pasta e um nome por agente

Dê a cada agente a própria cópia do repo (git worktree) e o próprio nome (ANK_AGENT).

git worktree add ../svc-rate -b task/rate
export ANK_AGENT=codex:rate
refs/ank/TASK-0e7d../svcANK_AGENT=claude:auth../svc-rateANK_AGENT=codex:rateerror[4] held by claude:auth
Fig. 05refs/ank/claims/TASK-0e7d · git worktree

Pegar uma tarefa

Um comando, `ank claim`, faz três coisas:

  1. 01

    Marca como em andamento

    Os outros agentes veem que a tarefa está pega.

  2. 02

    Registra no git

    Toda cópia do repo enxerga, até em outras máquinas.

  3. 03

    Trava o objetivo

    Os critérios de sucesso não podem ser mudados depois.

Trabalhar em paralelo

  • A ordem vem das dependências

    Uma tarefa só espera as tarefas de que depende (blocked_by). O resto pode rodar ao mesmo tempo.

  • Uma branch por tarefa

    Cada tarefa é verificada na própria branch. O merge continua sendo trabalho do git.

  • O git faz o resto

    O ank nunca cria branches nem faz merge. Ele só acompanha as tarefas.

Instalar o ank

Dois comandos. Linux, macOS e Windows. Precisa do git.

npm install -g @haksolot/ank
npx skills add haksolot/ank