arnes/AGENTS.md

AGENTS.md — Entry point del template ARNES

Este repositorio es un template genérico para cualquier proyecto nuevo o en curso.

Arranque obligatorio

1. Usar ARNES dentro de un repo de proyecto real, no dentro del repo fuente de ARNES.
2. Si es primer uso en proyecto: ejecutar ./scripts/start.sh.
3. Leer work/current.md.
4. Leer backlog/features.json y seleccionar una feature pending.
5. Ejecutar ./scripts/verify.sh.
6. Mostrar estado runtime: python3 scripts/agent_status.py show.
7. Seguir harness/workflow.stages.yml y harness/agents.matrix.yml.

Ticket creation policy

• Tickets are created by leader (or triager) only.
• Use: python3 scripts/new_ticket.py
• Ticket language: English caveman.
• Internal orders/handoffs: English caveman.

Estado visible del arnés

• Estado runtime: work/runtime-status.json.
• Mostrar: python3 scripts/agent_status.py show.
• Actualizar transición:
  • python3 scripts/agent_status.py set --feature-id F-123 --stage build --agent implementer --action "Implementando" --state running --next-agent reviewer --waiting-for "work/artifacts/F-123/implementer.md"
• Cerrar/idle:
  • python3 scripts/agent_status.py reset

Reglas duras

• Una sola feature en in_progress.
• Ningún agente pasa código por chat: todo va a work/artifacts/<feature_id>/.
• implementer nunca marca done.
• done requiere gates aprobados: reviewer, security, qa.
• done requiere evidencia de documenter: work/artifacts/<feature_id>/documenter.md.
• done requiere publish final con commit+push del ticket: work/artifacts/<feature_id>/publish.json.
• Si verify.sh falla, no se cierra la feature.

Modelo por tarea (token-aware)

• Use smallest model that fits task.
• Routing config: harness/models.profiles.yml
• Rules: harness/policies/model-routing.md

Git publish por ticket

• Al terminar una feature/ticket, leader debe ejecutar:
  • python3 scripts/publish_ticket.py --feature-id F-123
• Esto crea commit + push del ticket y deja evidencia en work/artifacts/<feature_id>/publish.json.

Extensión por proyecto (overlay)

• Opcional: AGENTS.local.md para reglas específicas del proyecto actual.
• Opcional: scripts/verify.local.sh para checks de dominio.
• El core de ARNES debe seguir siendo agnóstico.

Reentrada (context loss)

• Releer work/current.md y artefactos de la feature activa.
• Ejecutar ./scripts/verify.sh.
• Mostrar python3 scripts/agent_status.py show.
• Continuar desde “Próximo paso”.