Research first

¿Qué hace Research first?

No codifiques basándote en lo que crees que es la API. Verifica primero.

Debes hacer esto antes de cualquier edit o write que no sea trivial:

1. Investigar: research/findings/<tema>.md

• Revisa research/findings/ primero. Si alguien ya lo investigó, reutilízalo.
• Luego haz grep en el código base. Después, búsqueda web si necesitas documentación externa. Usa 2026 en la búsqueda para obtener documentación actual.
• Cita lo que encontraste. Si no existe documentación, escribe un pequeño repro para verificar la hipótesis.
• Guárdalo en research/findings/<slug>.md para que la siguiente sesión no repita el trabajo.

Plantilla:

# Hallazgos: <tema>

Fecha: 2026-09-04
Fuentes: [url, url]
Código existente: `ruta:línea`: lo que encontramos

## Veredicto

Enfoque recomendado: ...
Alternativas: ...
Riesgos: ...

2. Planificar: research/plans/<tarea>.md

# Plan: <tarea>

Investigación: research/findings/<tema>.md
Enfoque: ...
Archivos a modificar: [lista]
Pruebas: ...
Rollback: ...

3. Aprobación

Muestra el plan al usuario. No comiences a codificar hasta que diga que está bien. Para ediciones de un solo archivo muy pequeñas, el instinto de autoaprobación puede dejarte pasar.

4. Implementar y verificar

Ejecuta el plan, ejecuta pruebas, harness bench --quick, luego harness memory sync para que la próxima sesión recuerde lo que funcionó.

Notas

• Si ya existen hallazgos, no los repitas.
• Lee archivos para obtener hechos, no adivines. Si lo que encuentras contradice lo que esperabas, dilo y confía en el archivo.
• Cuando termines, actualiza los hallazgos con lo que realmente funcionó.

No hagas esto

• edit antes de read o grep
• adivinar firmas de API
• saltarse el plan porque "es pequeño" cuando estás a punto de tocar 3+ archivos