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/
├── config/             # Rutas y enlaces del sitio
├── components/shared/  # Elementos comunes
├── features/           # Módulos humanidades/ y mrc/
├── layouts/            # BaseLayout, HumanidadesLayout y MrcLayout
├── pages/              # Rutas landing/ y mrc/
└── styles/             # Variables de diseño compartidas

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 MrcLayout.astro para una página del torneo o HumanidadesLayout.astro para una página de la organización.
  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
↑