MNQ-Catering-y-Evento/AGENTS.md

AGENTS.md

Stack

• Framework: Astro 5
• Adapter: @astrojs/node
• Rendering mode: SSR
• Runtime target: Node standalone en VPS con Dokploy
• Styling: CSS custom con variables CSS
• Responsive approach: mobile-first

Arquitectura del producto

Sitio institucional multipágina enfocado en captación de leads por WhatsApp.

Páginas aprobadas:

• Home
• Nosotros
• Bodas Reales
• Corporativo & Business
• Reuniones Familiares
• Contacto

Comandos

Comandos esperados para la implementación del proyecto:

Acción	Comando
Instalar dependencias	npm install
Desarrollo	npm run dev
Build	npm run build
Preview / ejecución standalone	node ./dist/server/entry.mjs

Convenciones

1. Priorizar claridad comercial y conversión por WhatsApp.
2. Mantener arquitectura mobile-first desde el CSS base.
3. Usar variables CSS para tokens de color, spacing, tipografía, radios y sombras.
4. Evitar frameworks de utilidades si no aportan valor claro al sistema visual.
5. Mantener consistencia estructural entre páginas de servicio.
6. Las galerías deben vivir dentro de cada servicio, no como página independiente.
7. El formulario de contacto debe ser secundario respecto a WhatsApp.

Don'ts

• No usar @astrojs/cloudflare para este proyecto: el deployment objetivo es Dokploy sobre VPS.
• No diseñar desktop-first.
• No mezclar estilos premium editoriales con componentes visualmente ruidosos.
• No usar dorado como color masivo de relleno; usarlo como acento.
• No construir páginas de servicio genéricas copiadas una de otra sin adaptar copy, CTA y galería.

Estructura CSS recomendada

• src/styles/tokens.css
• src/styles/base.css
• src/styles/layout.css
• src/styles/components.css
• src/styles/utilities.css

Skills

Habilidades especialmente relevantes para este proyecto:

• project-docs
• brainstorming
• responsive-design
• visual-design-foundations
• interface-design
• accessibility-compliance

Nota para futuros agentes

Antes de implementar:

1. Leer README.md
2. Leer este AGENTS.md
3. Leer DESIGN.md
4. Respetar el enfoque comercial: WhatsApp primero
5. Respetar el enfoque visual: claro editorial premium