Para agentes

✅ Estable

Esta documentación sirve tanto a personas como a agentes de IA. Esta página describe las convenciones que un agente puede aprovechar de forma fiable.

---

Endpoints /llms.txt

El plugin starlight-llms-txt genera automáticamente tres archivos al compilar el sitio:

URL	Contenido	Uso recomendado
/llms.txt	Índice curado con títulos, descripciones y fragmentos de cada página	Punto de entrada general; cargarlo primero
/llms-small.txt	Versión compacta sin fragmentos extendidos	Contextos con presupuesto de tokens reducido
/llms-full.txt	Corpus completo concatenado de todo el sitio	Búsqueda exhaustiva o indexación offline

Estos archivos son texto plano y siguen el estándar llms.txt. No son páginas de documentación navegables: son artefactos de máquina.

---

Cómo navegar el sitio

La documentación está organizada en cuatro secciones con propósitos distintos:

Sección	Propósito	Cuándo usarla
Tutoriales	Aprender haciendo, paso a paso	Primera exposición a sei
Metodología RDD	Entender los conceptos y el bucle completo	Antes de leer la Referencia
Referencia	Consultar flags, artefactos y citas normativas de sei y sei.yaml	Durante la implementación
Conceptos	Marco regulatorio y estado del proyecto	Para auditoría y validación

---

Convenciones que un agente puede asumir

1. Todo bloque de código es ejecutable y está rotulado. El rótulo del bloque indica el destino (sei.yaml, bash, etc.). Un agente puede copiar y ejecutar sin modificar.

2. La madurez del área se muestra con la insignia <Status> al inicio de la página (también existe un campo status en el frontmatter para herramientas). Los valores posibles son:

   Valor	Significado
   estable	Implementado y cubierto por tests
   parcial	Funciona, falta algo; ver nota
   planificado	Diseñado, sin implementar
   experimental	Prototipo, puede cambiar

   Precaución

   Un área con estado planificado no tiene implementación. Un agente no debe asumir que los comandos o artefactos descritos en esa área funcionan en la versión actual de sei.

3. Los enlaces internos resuelven. Todos los slugs del sidebar existen como páginas con contenido. El estado planificado aparece en asides <Status> dentro de páginas para marcar funcionalidades concretas aún no construidas (p.ej. la modalidad de prompt). Un agente puede seguir enlaces de página sin riesgo de 404, pero debe comprobar la insignia <Status> antes de asumir que una funcionalidad está disponible.

4. Las citas normativas son por cláusula. Las referencias a ISO 23894, prEN 18228 y al EU AI Act incluyen siempre el número de cláusula o artículo (ej. ISO 23894 §6.4.3, EU AI Act Art. 9). Estas citas son precisas; el texto completo de los estándares no se reproduce.

---

Línea futura

🚧 Planificado — Servidor MCP de documentación: contexto vivo desde el plano de nube de Venturalítica, accesible via MCP en lugar de /llms.txt estático.