# AGENTS.md — Entrada de Orquestra

## Arranque obligatorio
1. Ejecutar `./scripts/verify.sh`.
2. Leer `work/current.md`.
3. Leer `backlog/features.json` y seleccionar **una** feature `pending`.
4. Seguir `harness/workflow.stages.yml` y `harness/agents.matrix.yml`.
5. Actualizar estado visible con `python3 scripts/agent_status.py set ...` antes de cada stage.

## Reglas duras
- Orquestra se ejecuta secuencialmente en Pi: no subagentes.
- Para Pi limpio, arrancar con `./scripts/pi_orquestra.sh`, no con `pi` directo.
- Una sola feature en `in_progress`.
- Ningún rol pasa código por chat: todo va a `work/artifacts/<feature_id>/`.
- `implementer` nunca marca `done`.
- `done` requiere gates aprobados: `reviewer`, `security`, `qa`.
- Si `verify.sh` falla, no se cierra la feature.
- **Solo se puede escribir en carpetas permitidas**: `project/`, `tests/`, `work/`, `backlog/`, `spec/`, `harness/`, `scripts/`, `platforms/`, `docs/`. Cualquier otra escritura será bloqueada por la extensión `orquestra-status`.
- **Al cerrar una feature, el leader ejecuta `scripts/close_feature.py <feature_id>`** que valida gates, actualiza el backlog y hace commit/push automáticamente.
- **NUNCA editar `backlog/features.json` directamente**. Usar siempre `scripts/close_feature.py` para cerrar features. La extensión `orquestra-status` bloquea escrituras directas a este archivo.
- **Directorios prohibidos**: `specs/` (plural), `apps/`, `frontend/`, `src/`, `lib/`. El código del producto va en `project/`.
- **Nomenclatura de gates**: usar `reviewer`, no `review`. El `verify.sh` valida que no se usen nombres deprecated.
- **Schema de features**: todas las features deben tener al menos `id` y `status`. Las gates deben usar nombres válidos: `reviewer`, `security`, `qa`, `close`, `leader`.

## Reentrada
- Releer `work/current.md`, `work/runtime-status.json` y artefactos de la feature activa.
- Ejecutar `./scripts/verify.sh`.
- Continuar desde el próximo stage pendiente.