Al0olo/Agents-village

Handoff

El objetivo: que el próximo agente, sin memoria de esta conversación, continúe sin preguntar a nadie y sin volver a deducir nada.

Al inicio

1. Lee por completo docs/HANDOFF.md, luego las 3 primeras entradas de docs/handoff/LOG.md.
2. Verifícalo contra la realidad: git status, git log --oneline -10, git branch -a, y los PR abiertos (gh api repos/al0olo/agents-village/pulls --jq '.[].title').
3. Si el handoff y la realidad discrepan, cree en la realidad, luego corrige el handoff antes de comenzar el nuevo trabajo y menciónalo en el log.
4. Enuncia el siguiente paso al usuario en una o dos frases, luego hazlo.

Mientras trabajas

Actualiza docs/HANDOFF.md inmediatamente cuando ocurra cualquiera de estos eventos: finaliza una unidad de trabajo, se toma una decisión, un enfoque falla, encuentras una peculiaridad del entorno, abres o fusionas un PR.

Al final (o cuando te corten)

1. Reescribe docs/HANDOFF.md usando la plantilla de abajo. Es estado actual, no historial: reemplaza líneas obsoletas, no acumules.
2. Antepón una entrada fechada a docs/handoff/LOG.md (la más reciente primero): qué hiciste, por qué, qué falló, enlaces. La historia vive allí.
3. Ejecuta scripts/check-handoff.sh y confirma el handoff junto con el trabajo.
4. Mensaje final al usuario: qué está hecho, qué sigue, cualquier cosa que necesite su decisión.

Plantilla para docs/HANDOFF.md

# Handoff
Actualizado: YYYY-MM-DD por <agente/modelo> · Rama: <nombre> · Último commit: <sha>

## Objetivo
Un párrafo: qué intenta lograr el proyecto en este momento.

## Estado
- Hecho: elemento (PR #n)
- En progreso: elemento, exactamente dónde se detuvo, archivos sin commit si los hay
- No iniciado: elemento

## Siguiente paso
La única acción siguiente, lo suficientemente concreta para empezar de inmediato, con comandos.

## Cola
Lista ordenada después del siguiente paso.

## Decisiones abiertas (el propietario debe decidir)
Pregunta, opciones, mi recomendación.

## Gotchas
Peculiaridades del entorno, enfoques fallidos y por qué, cosas que parecen incorrectas pero son intencionadas.

## Cómo verificar
Comandos que demuestran que el estado actual es saludable.

## Punteros
Archivos y documentos para leer en profundidad.

Nivel de calidad

• Nombra archivos, ramas, números de PR, comandos. Nada de "como arriba", nada de "lo que discutimos".
• Registra los enfoques fallidos y por qué, para que nadie los repita.
• Separa lo que verificaste de lo que supones, y di cuál es cuál.
• Mantén docs/HANDOFF.md por debajo de aproximadamente 150 líneas; mueve el historial al log.