chore: bootstrap MNQ Astro site

2026-05-07 18:23:50 +02:00
commit 51b0d1fb67
28 changed files with 7543 additions and 0 deletions
@@ -0,0 +1,81 @@
+# 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