mercadodevida/harness/contracts/handoff.md

Handoff Contract

Regla anti teléfono-descompuesto

Los agentes no devuelven código en chat. Deben escribir a disco y responder solo:

• done -> <ruta>
• blocked -> <ruta>

Contexto mínimo por stage

Cada stage recibe solo:

1. Los archivos listados en harness/workflow.stages.yml como input.
2. El artefacto del stage anterior cuando el workflow lo declare.
3. La memoria Engram que el leader seleccione explícitamente para ese stage.

No se considera válido pasar todo el chat anterior como contexto operativo. Si un stage necesita más información, debe pedir una ruta o artefacto concreto y bloquear hasta tenerlo.

Rutas estándar por feature

• work/artifacts/<feature_id>/implementer.md
• work/artifacts/<feature_id>/reviewer.json
• work/artifacts/<feature_id>/security.json
• work/artifacts/<feature_id>/qa.json
• work/artifacts/<feature_id>/documenter.md (opcional; requerido solo si cambiaron docs/API/contratos/comportamiento user-facing)
• work/artifacts/<feature_id>/leader-close.json

Campos mínimos de artefactos JSON de gate

• feature_id (string)
• agent (reviewer|security|qa|leader)
• verdict (APPROVED|CHANGES_REQUESTED)
• summary (string)
• evidence (array de comandos/salidas/rutas)
• timestamp (ISO 8601)