# 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”.
