La herramienta de coordinación tonta

Gestión de proyectos para equipos de humanos y agentes de código. Sin tracker, sin sprints, sin ceremonias.

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

Gratis y open source. Linux, macOS y Windows.

  1. 01Leer las reglasank context
  2. 02Tomar una tareaank claim
  3. 03Escribir el códigoank log
  4. 04Pasar las verificacionesank done

Tu agente no sabe lo que decidiste

Acordaste una regla en un chat o en una reunión. Tu agente nunca la vio, así que la rompe.

Con ank, la regla vive en el repo, ligada a la carpeta que protege. El agente pregunta antes de programar, y la recibe.

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

Por qué puedes fiarte

  • Las reglas siguen al código

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

    Una regla está ligada a carpetas. Toda tarea que las toque recibe la regla.

  • El objetivo no se mueve

    TASK-820ddone_criteriasha256 94a1f6ank checkdone_criteria'≠

    Al tomar una tarea, sus criterios de éxito quedan bloqueados. Reescribirlos no sirve de nada.

  • Hecho significa comprobado

    proof 94a1f6auth-testsno-jwt$ ank done

    El agente no decide que ha terminado. ank ejecuta las comprobaciones y guarda la prueba.

Seis comandos

Es todo lo que necesita tu agente.

ank01 → 06
  1. 01

    ank context <path>

    Obtener las reglas y las tareas de una carpeta.

  2. 02

    ank claim <id>

    Tomar una tarea. Los demás ven que está tomada.

  3. 03

    ank show <id>

    Leer la tarea completa.

  4. 04

    ank log "<message>"

    Anotar lo que aprendes por el camino.

  5. 05

    ank done

    ank ejecuta las comprobaciones. Si pasan, la tarea está hecha.

  6. 06

    ank release --reason "<why>"

    Devolver la tarea, y decir por qué.

Lo que no es

  1. No es un tracker de tickets. Sin sprints, estimaciones ni tableros.

  2. No es una wiki. Solo lo que el agente debe seguir o hacer.

  3. No es una herramienta de seguridad. Mantiene a los agentes en el buen camino. No frena a los atacantes.

Instalar ank

Dos comandos. Linux, macOS y Windows. Necesita git.

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