Manuel
82 lines
2.2 KiB
Markdown
82 lines
2.2 KiB
Markdown
# 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
|