57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
# 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”.
|