A ferramenta de coordenação burra

Gestão de projetos para equipes de humanos e agentes de código. Sem tracker, sem sprints, sem cerimônia.

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

Gratuito e open source. Linux, macOS e Windows.

  1. 01Ler as regrasank context
  2. 02Pegar uma tarefaank claim
  3. 03Escrever o códigoank log
  4. 04Passar nas verificaçõesank done

Seu agente não sabe o que você decidiu

Você combinou uma regra num chat ou numa reunião. Seu agente nunca viu, então quebra a regra.

Com o ank, a regra fica no repo, ligada à pasta que ela protege. O agente pergunta antes de codar e recebe a regra.

src/auth/src/api/.ank/ADR-06d2TASK-820dsrc/ui/src/auth/**
Fig. 01ank context src/auth/ → ADR-06d2 + TASK-820d

Por que dá para confiar

  • As regras seguem o código

    TASK-820dTASK-357bADR-06d2ADRTASKglob src/auth/**

    Uma regra fica ligada a pastas. Toda tarefa que mexe nelas recebe a regra.

  • O objetivo não muda

    TASK-820ddone_criteriasha256 94a1f6ank checkdone_criteria'≠

    Quando uma tarefa é pega, os critérios de sucesso ficam travados. Reescrevê-los não adianta.

  • Feito quer dizer verificado

    proof 94a1f6auth-testsno-jwt$ ank done

    Não é o agente que decide que terminou. O ank roda as verificações e guarda a prova.

Seis comandos

É tudo de que seu agente precisa.

ank01 → 06
  1. 01

    ank context <path>

    Pegar as regras e as tarefas de uma pasta.

  2. 02

    ank claim <id>

    Pegar uma tarefa. Os outros veem que ela está pega.

  3. 03

    ank show <id>

    Ler a tarefa inteira.

  4. 04

    ank log "<message>"

    Anotar o que você aprendeu no caminho.

  5. 05

    ank done

    O ank roda as verificações. Se passarem, a tarefa está feita.

  6. 06

    ank release --reason "<why>"

    Devolver a tarefa, e dizer por quê.

O que ele não é

  1. Não é um tracker de tickets. Sem sprints, estimativas ou quadros.

  2. Não é uma wiki. Só o que o agente precisa seguir ou fazer.

  3. Não é uma ferramenta de segurança. Mantém os agentes no rumo. Não barra atacantes.

Instalar o ank

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

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