Codex avanzado para perfiles técnicos

Explícame este repositorio: qué hay en cada carpeta, cómo se arranca la aplicación de estoc, cómo se ejecutan las pruebas y qué incidencias hay abiertas. Ejecuta las pruebas para ver si pasan. No modifiques ningún fichero.

Revisa el AGENTS.md y añade estas normas:
- Responde en castellano y escribe los textos para el usuario en catalán, que es el idioma de Cafès Roca.
- No modifiques nunca los ficheros de dades/: son el origen. Si hay que transformarlos, guarda el resultado en otra carpeta.
- Antes y después de cambiar código de estoc/, ejecuta las pruebas.
- No instales paquetes npm sin preguntarme.
- Formato de números en catalán: coma decimal y punto de millares.
Incluye una sección «Dades» que describa vendes_cafes_roca_2026.csv: separador punto y coma, coma decimal, UTF-8 y saltos de línea CRLF.

Lee dades/brief_web_cafes_roca.txt. Quiero la landing que describe dentro de web/: index.html y una hoja de estilos aparte, sin frameworks ni librerías externas, que funcione bien en el móvil. Antes de escribir nada, hazme las preguntas que necesites y propón un plan con las secciones, los ficheros y cómo comprobaremos que está bien.

Adelante con el plan. Textos en catalán, tomados del brief sin inventar datos. El formulario de càtering valida los campos obligatorios y, al enviarlo, abre el correo del usuario dirigido a hola@cafesroca.cat con los datos rellenados. Cuando acabes, ábrela en el navegador integrado y revisa que no haya desplazamiento horizontal a 390 px de ancho.

En la captura que te adjunto, el botón de càtering de la cabecera queda demasiado pegado al texto y las tarjetas de los locales tienen alturas distintas en el móvil. Corrígelo sin cambiar los colores.

Crea web/build.mjs: un script de Node sin dependencias que convierta cada .md de web/articles/ en un .html con la cabecera, el pie y los estilos de la landing (títulos, párrafos, listas, negritas y enlaces). Añade a la landing una sección «Del nostre torrador» con enlaces a los dos artículos. Ejecuta el script y comprueba que las páginas se abren.

Crea analisi/analisi.mjs, un script de Node sin dependencias que:
1. Lea dades/vendes_cafes_roca_2026.csv sin modificarlo (punto y coma, coma decimal, CRLF) y avise si alguna fila tiene un formato incorrecto.
2. Calcule la facturación total, por local, por categoría con su peso en %, por mes y local, las bebidas frías por mes y los cinco productos que más facturan.
3. Compruebe que las sumas por local, categoría, mes y producto coinciden con el total, y se detenga con un error si no cuadran.
4. Guarde los resultados en analisi/resultats.json.
Ejecútalo y enséñame las cifras.

Añade al script tres gráficos en SVG, sin librerías, en analisi/grafics/: ventas mensuales por local (líneas), ventas por categoría (barras horizontales con importe y %) y bebidas frías por mes (columnas, con mayo y junio destacados). Colores de la marca: Gràcia #3B2A1F, Poblenou #C8553D, Sants #B08B5B. Para cada gráfico, explícame por qué ese tipo responde mejor a la pregunta.

Genera analisi/informe.md en catalán a partir de resultats.json: cifras principales, una tabla por local, una por categoría, la evolución de las bebidas frías y el top 5 de productos, con los gráficos insertados. Cada cifra tiene que salir del JSON; no escribas ningún número a mano.

Quiero un dashboard de ventas de Cafès Roca que la dirección y los encargados puedan abrir desde el navegador sin servidor. Hazme las preguntas que necesites sobre usuarios, indicadores, filtros, gráficos y diseño. Con mis respuestas, escribe dashboard/SPEC.md con objetivo, datos, contenido, diseño y criterios de aceptación con cifras que se puedan comprobar con analisi/resultats.json.

Implementa dashboard/SPEC.md. Los datos agregados los genera un script dashboard/genera-dades.mjs que lee el CSV y escribe dashboard/dades.js; el dashboard no lee el CSV directamente. Al acabar, abre el dashboard en el navegador integrado, prueba los filtros y comprueba uno por uno los criterios de aceptación. Dime cuáles se cumplen y cuáles no.

Antes de seguir: ¿cuánto contexto llevamos en este hilo y cuánto límite me queda? Si conviene, resume lo hecho en cinco líneas para que pueda abrir un chat nuevo y continuar.

Explícame cómo funciona la aplicación de estoc/: de dónde salen los datos, cómo se calcula el estoc a partir de los movimientos, cuándo un producto entra en alertas y cómo se calcula la comanda sugerida. Hazme un esquema del flujo desde que llega una petición a /api/comanda hasta que se pinta la tabla. No cambies nada.

Lee la incidencia #12 de estoc/ISSUES.md. Crea una rama codex/incidencia-12. Escribe en estoc/test/estoc.test.js una prueba que reproduzca exactamente el caso (leche de avena en Gràcia, 6 l, mínimo 6) y que compruebe que sale en alertas y en la comanda. Ejecuta las pruebas y enséñame que la nueva falla. Todavía no corrijas nada.

Ahora corrige el error con el cambio mínimo. No toques los datos ni las otras pruebas. Ejecuta todas las pruebas, explícame la causa en una frase y haz un commit por cada paso: uno con la prueba y otro con la corrección, mensajes en catalán con «(#12)».

Resuelve la incidencia #14 de estoc/ISSUES.md: función comandaCsv en src/estoc.js con su prueba, endpoint /api/comanda.csv con BOM para que Excel lea bien los acentos, y botón «Descarrega la comanda (CSV)». Ejecuta las pruebas.

Resuelve la incidencia #13 de estoc/ISSUES.md: selector de local que filtre el resumen, las alertas, la tabla y la comanda, y que recuerde la última opción en localStorage. Solo cambios en public/. Comprueba en el navegador integrado que funciona con cada local.

Estoy fusionando codex/filtre-local en main y hay un conflicto en estoc/public/style.css. Enséñame las dos versiones, explícame qué quería cada rama y resuélvelo conservando las dos. Ejecuta las pruebas y abre la aplicación para comprobar que el botón y el selector se ven bien.

Amplía el AGENTS.md de la raíz con dos secciones:
- «Flux de treball»: una rama por tarea con prefijo codex/, commits en catalán en imperativo con el número de incidencia, y antes de una PR pruebas en verde y /review sin problemas graves.
- «Code Review Rules»: grave modificar dades/, grave cualquier clave o token escrito en el código, toda función nueva de estoc/src/ con su prueba, importes en euros redondeados al final.
Y crea estoc/AGENTS.md con las normas propias de la aplicación: Node 20 con módulos ES, sin dependencias, lógica en funciones puras en src/estoc.js, pruebas con node:test y, para un error, primero la prueba que lo reproduce.

$skill-creator Crea una skill de proyecto llamada informe-estoc en .agents/skills/. Tiene que generar el informe semanal de estoc de Cafès Roca en informes/estoc_AAAA-MM-DD.md: primero ejecuta las pruebas (si fallan, se detiene), después un script scripts/informe.mjs que calcula alertas y comanda con las funciones de estoc/src/estoc.js, y al final añade tres líneas de observaciones. No modifica estoc/data/ ni envía nada. La descripción tiene que activarla cuando pidan el informe de estoc o qué hay que pedir al proveedor.

$informe-estoc

Crea un hook de proyecto en .codex/hooks.json que, después de cada edición de ficheros (PostToolUse con matcher apply_patch), ejecute node .codex/hooks/proves-estoc.mjs. El script lee de la entrada estándar el evento; si el cambio afecta a estoc/, ejecuta node --test dentro de estoc/ y, si alguna prueba falla, sale con código 2 y escribe el resultado en stderr. Que funcione en Windows y en Mac: nada de bash.

Con el servidor MCP de Playwright, abre web/index.html y prueba: (1) a 390 × 844 no hay desplazamiento horizontal; (2) enviar el formulario vacío muestra un aviso; (3) con 3 personas (el mínimo es 5) el mensaje dice qué campo está mal; (4) los enlaces a los dos artículos funcionan; (5) no hay errores en la consola. Guarda capturas en web/proves/ y un informe PROVES_NAVEGADOR.md. Si algo falla, corrígelo y vuelve a probar.

Crea en automatitzacio/: un esquema JSON comanda.schema.json (fecha, alertas con local, producto, cantidad y mínimo; líneas de comanda con local, código, lotes, cantidad e importe; total en euros y observaciones; todos los campos obligatorios y sin propiedades adicionales), y dos scripts, comanda-setmanal.sh y comanda-setmanal.ps1, que llamen a codex exec en solo lectura con ese esquema y guarden el resultado en informes/comanda_FECHA.json. Pruébalo.

Crea .github/workflows/pages.yml para publicar la carpeta web/ en GitHub Pages en cada push a main que cambie web/: checkout, Node 20, node web/build.mjs para generar los artículos, y despliegue con las acciones oficiales configure-pages, upload-pages-artifact y deploy-pages. Explícame qué hace cada paso y qué permisos necesita.

Quiero empezar un proyecto nuevo con Codex: [describe tu idea en dos líneas]. Antes de escribir código: hazme las preguntas necesarias, propón el stack más sencillo que funcione, escribe un SPEC.md con criterios de aceptación comprobables y un AGENTS.md con las normas del proyecto, y dime cómo lo probaremos. Trabajaremos por pasos pequeños, con un commit por paso.

Explícame este repositorio como si fuera mi primer día: para qué sirve, cómo se arranca, dónde está la lógica principal y qué partes parecen frágiles. Hazme un mapa de carpetas. No cambies nada.

En la carpeta exports/ hay tres CSV de ventas con columnas distintas. Escribe un script que los unifique en un solo CSV con fecha, cliente, producto e importe, que avise de las filas que no puede interpretar y que no toque los originales.

Propón un plan para renombrar los PDF de facturas/ con el formato AAAA-MM-DD_proveedor_importe.pdf leyendo los datos de cada factura. Enséñame la lista de cambios antes de aplicarlos y guarda un registro para poder deshacerlo.

Necesito reducir todos los vídeos MP4 de esta carpeta a 720p y menos de 20 MB para enviarlos por correo. Dame el comando, explícame cada parte y pruébalo con un solo fichero primero.

Escribe pruebas para src/facturacion.js que cubran el comportamiento actual, incluidos los casos límite (importes 0, negativos, redondeos). No cambies el código: si encuentras un error, anótalo en un comentario de la prueba.

Quiero pasar este proyecto de Node 18 a Node 22. Revisa qué dependencias y APIs cambian, propón el plan por pasos pequeños con las pruebas que validan cada uno y empieza solo cuando lo apruebe.

Te pego la traza del error y el log. Encuentra la causa, escribe una prueba que lo reproduzca y propón la corrección mínima. Explícame por qué no lo detectaban las pruebas actuales.

Revisa mis cambios respecto a main con atención especial a seguridad, gestión de errores y rendimiento. Prioriza los problemas y dime cuáles bloquearían la PR.

Crea mi web personal de una sola página con mi presentación, tres proyectos con imagen y enlace, y un formulario de contacto que abra el correo. HTML y CSS sin librerías, adaptable al móvil. Después prepara el workflow para publicarla en GitHub Pages.

Escribe un script que lea los CSV de extractos de la carpeta banco/, clasifique cada movimiento en categorías que yo pueda editar en un fichero JSON y genere un informe mensual con un gráfico por categoría. Los datos no salen de mi ordenador.

Quiero una aplicación web para planificar los menús de la semana y generar la lista de la compra. Escribe primero un SPEC.md con lo mínimo que tiene que hacer y pregúntame lo que necesites. Guarda los datos en el navegador.

Quiero aprender Python haciendo un proyecto: un script que descargue el tiempo de mi ciudad cada mañana y me lo resuma. Ve paso a paso, explícame cada concepto nuevo cuando aparezca y déjame escribir yo algunas partes.

Hoy gestionamos las reservas de salas con una hoja de cálculo. Quiero una aplicación interna sencilla con usuarios, reservas y avisos de solapamiento. Hazme las preguntas necesarias y escribe el SPEC.md antes de proponer tecnología.

Crea una skill informe-semanal que lea los CSV de ventas/, calcule los indicadores que te detallo y genere un informe en Markdown. Después prepara una tarea programada para cada lunes a las 8:00.

Genera la documentación para desarrolladores de este repositorio: README con instalación y arranque, arquitectura con un diagrama Mermaid, y un AGENTS.md con las normas que deduces del código. Marca lo que no puedas confirmar.

Escribe en AGENTS.md una sección «Code Review Rules» con nuestras normas: [tus normas]. Prepara un workflow con la GitHub Action de Codex que revise cada PR con esas reglas y deje un comentario.