# AGENTS.md

## Contexto del proyecto

`hu-rooms` es un PoC/demo. La prioridad principal es mostrar valor de producto rapido.

## Prioridades de desarrollo

1. Shippear features y flujos demo end-to-end.
2. Mantener persistencia de datos funcional.
3. Optimizar velocidad de entrega por sobre arquitectura ideal.

## Trade-offs permitidos (solo demo)

- Se acepta deuda tecnica si acelera la entrega.
- Se permiten soluciones pragmaticas y simplificadas.
- Seguridad y hardening no son prioridad en esta etapa.
- Correccion perfecta no bloquea si el flujo de demo funciona.

## Limites minimos

- No commitear secretos (`keys`, `.env`, credenciales).
- No romper flujos principales de demo.
- Evitar cambios innecesarios fuera del alcance.

## Reglas operativas

- Cualquier cambio de traducciones se hace en el repo hermano `hu-translations`.
- En cualquier cambio de UI/UX (pantallas, componentes, estilos o elementos visuales), consultar y aplicar siempre la skill `design-system-foundations` ubicada en `.cursor/skills/design-system-foundations/SKILL.md` antes de implementar.
- Antes de empezar cualquier feature/fix, sincronizar `main` con `origin/main` usando `git pull --ff-only`.
- Al terminar cualquier feature/fix, hacer push a `origin/main` para testear en produccion con iteracion rapida (CD).
- Mantener una configuracion colaborativa y tolerante de entorno para Supabase:
  - usar `.env.example` como contrato compartido del equipo;
  - nunca commitear `.env*` con secretos reales;
  - soportar en codigo ambos nombres de key publishable (`NEXT_PUBLIC_SUPABASE_ANON_KEY` y `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY`) solo para local/dev, manteniendo `NEXT_PUBLIC_SUPABASE_ANON_KEY` como canon en produccion.
- Para queries/mutations y cambios de schema:
  - no editar scripts SQL ya aplicados;
  - crear siempre scripts incrementales nuevos en `scripts/`;
  - actualizar `README.md` y `PLAN.md` cuando cambie el workflow de colaboracion.
- Actualizar `PLAN.md` siempre que se implementen cambios o avances relevantes del proyecto.
- Actualizar `PLAN.md` siempre que se implementen cambios o avances relevantes del proyecto.