Imported from akproduccioneseventos/app-AK (.agents/AGENTS.md). Install upstream with npx skills add akproduccioneseventos/app-AK --skill .agents. Copyright stays with the author.

Reglas de Trabajo para Antigravity

1. Perfil y Comunicación

• El usuario no es programador. Evitá tecnicismos complejos o explicaciones de bajo nivel. Los planes de trabajo y respuestas deben ser sumamente claros, adaptados a su entendimiento.
• Respuestas directas, cortas y concretas. Al grano, sin palabrerío.
• Idioma y Tono: Hablar SIEMPRE en español rioplatense (uruguayo/argentino) usando modismos naturales ("vos", "bo", "che").
• Prohibido Alucinar: Queda estrictamente prohibido alucinar o inventar código, variables, APIs, archivos o dependencias que no existan. Todo lo programado o reportado debe ser 100% real.

2. Flujo de Trabajo

• Planificación: Armar un plan antes de cambios complejos.
• Uso Obligatorio de Graphify: Antes de empezar una tarea, usá graphify para entender la arquitectura y relaciones entre componentes.
• Autonomía: Escribir y probar en local de forma directa sin pedir autorización para cada paso.
• GitHub: Subir la rama y crear la PR, pero nunca fusionarla (mergear) automáticamente. El usuario la revisa y fusiona a mano.
• Verificación de PR Abierta (OBLIGATORIO): Antes de empezar una tarea, crear una rama o subir commits, es obligatorio verificar en GitHub qué Pull Requests están abiertas y sus estados. Si la PR de la rama actual ya fue cerrada, archivada o fusionada, está estrictamente prohibido seguir subiendo cambios a esa rama. En su lugar, debés sincronizarte localmente con main actualizado, crear una rama nueva y limpia, y generar una nueva PR abierta para la tarea actual, asegurando así un despliegue limpio sin mezclar código viejo.
• Honestidad Absoluta (0 Humo): Los títulos y descripciones de commits y PRs deben describir únicamente los cambios reales y precisos que hiciste. Cero falsas promesas de rediseños o mejoras que no estén realmente implementadas.
• Prevención de Conflictos: Antes de subir la rama y crear la PR, hacé un merge local de la rama principal (main) hacia tu rama de trabajo y resolvé todos los conflictos para asegurar que la PR en GitHub esté limpia y sin conflictos de fusión.

3. Calidad y Estabilidad (Cero Regresiones)

Antes de declarar cualquier tarea como terminada, debés ejecutar localmente los siguientes controles de calidad de forma obligatoria:

1. Compilación de TypeScript: Ejecutá pm run typecheck (o tsc --noEmit) para verificar que no haya errores de tipado.
2. Análisis Estático (Linter): Ejecutá pm run lint para asegurar que el código respete las reglas de estilo y no tenga importaciones rotas o elementos no definidos.
3. Pruebas Unitarias: Ejecutá pm run test (o Jest) para garantizar que los cambios no rompan funcionalidades en otros módulos.
4. Construcción de Producción (Build): Ejecutá pm run build para asegurar que el proceso de build de Next.js/Firebase compile sin errores. Si el build falla en local, corregilo antes de subir los cambios.

• Prolijidad: Limpiá todos los espacios en blanco al final de las líneas antes de guardar y confirmar.

4. Herramientas Locales de Programación (Codex)

Todos los agentes y chats de este proyecto deben utilizar las siguientes herramientas de trabajo configuradas en el entorno local para agilizar el desarrollo sin complicar el código ni el despliegue de la app:

• Graphify: Genera un mapa general de toda la aplicación y analiza relaciones entre archivos. Antes de iniciar cualquier tarea, usá graphify para mapear el codebase y entender perfectamente las relaciones entre archivos para evitar roturas.
• Serena: Búsqueda inteligente por funciones, componentes y referencias cruzadas. Utilizá Serena cuando esté disponible para localizar símbolos o referencias rápidas.
• Repomix: Mide qué archivos consumen más tokens para evitar procesar archivos gigantes de forma innecesaria.

Estas herramientas son de uso local exclusivo para el análisis del código. No deben agregarse al package.json, no deben cambiar el comportamiento del sitio web, no deben desplegarse a Firebase y son invisibles para los clientes e invitados.