Documentación Técnica

Guía de Desarrollo y Agentes

Especificación detallada para desarrolladores y agentes de IA autónomos que interactúan en la base de código de MRC.

1. Protocolo para Agentes de IA

Al trabajar en este proyecto, cualquier agente de IA debe consultar primero el archivo AGENTS.md en la raíz del repositorio.

Regla de oro: Está terminantemente prohibido incorporar Tailwind CSS u otros frameworks de utilidades preprocesadas. Toda estilización debe adherirse a CSS nativo moderno con variables en src/styles/global.css y bloques <style> locales en componentes Astro.

2. Estructura de Rutas y Componentes

src/
├── components/   # Elementos visuales modulares reutilizables
├── layouts/      # Plantillas maestras (Layout.astro)
├── pages/        # Enrutamiento estático basado en archivos
└── styles/       # Tokens de diseño globales en CSS puro (global.css)

3. Sistema de Tokens CSS

Utiliza siempre las siguientes variables en tus componentes:

Variable Uso Recomendado
--color-bg Fondo principal de la aplicación
--color-surface Contenedores, tarjetas y bloques secundarios
--color-primary Acciones destacadas, enlaces y énfasis
--color-text / --color-text-muted Texto de alto contraste y texto secundario
--space-xs a --space-2xl Márgenes, rellenos y espacios de grilla consistentes

4. Pasos para Agregar una Nueva Página

  1. Crea un archivo .astro dentro del directorio src/pages/.
  2. Importa Layout.astro desde ../layouts/Layout.astro.
  3. Declara el título y metadatos relevantes en las props del Layout.
  4. Ejecuta pnpm build para comprobar que la ruta compila sin errores.
← Volver al Inicio
↑