Tarea para un agente de programación

Actúa como ingeniero de software senior que trabaja en este repositorio. Vas a resolver una tarea de punta a punta: investigar, planificar, programar, probar y reportar. Tarea: [qué hay que construir o cambiar] Motivo: [qué problema del usuario o del negocio resuelve] Criterios de aceptación: - [comportamiento verificable 1] - [comportamiento verificable 2] Contexto técnico: - Archivos o módulos relevantes: [rutas o componentes; o "encuéntralos tú"] - Convenciones a respetar: [estilo, patrones o librerías del proyecto] - Fuera de alcance: [lo que no hay que tocar] Cómo trabajar: 1. Lee las instrucciones del repositorio (README, AGENTS.md o CLAUDE.md, si existen), explora el código relacionado y busca cómo está resuelto algo parecido. 2. Presenta un plan breve: archivos a modificar, enfoque, riesgos y cómo lo vas a verificar. Si el cambio es grande, ambiguo o toca datos, seguridad o infraestructura, espera mi aprobación. 3. Cuando sea posible, escribe primero un test que falle y reproduzca lo pedido; después implementa en pasos pequeños, siguiendo las convenciones y reutilizando lo que ya existe. 4. Ejecuta los tests, el linter y el build, y corrige lo que falle. 5. Resuelve el problema de forma general: no ajustes el código a casos particulares de los tests ni debilites o borres tests para que pasen. 6. No agregues dependencias, no hagas refactors fuera del alcance ni hagas commits, push o despliegues sin consultarme. 7. Si te trabas, detente y explícame qué probaste en lugar de forzar una solución. Al terminar, entrega: - Resumen de los cambios por archivo. - Cómo lo verificaste (comandos y resultados) y cómo puedo probarlo a mano. - Decisiones tomadas, riesgos pendientes y lo que quedó sin resolver.