Cómo usar esta referencia
La referencia del lenguaje especifica la superficie de redacción de Aggrega — los esquemas YAML, el vocabulario de palabras clave compartido, el sistema de plantillas de Go, los contratos de los providers, los comandos de la CLI, el catálogo de errores del compilador y ejemplos desarrollados de principio a fin. Lee los capítulos siguientes en orden para una primera orientación, o ve directamente a un subdirectorio cuando busques una entidad, palabra clave, provider, comando de la CLI o error concretos.
Para instalar primero el binario aggrega, sigue Instalar el binario; para que un asistente de IA lo instale y lo configure por ti, pega el prompt de Configurar Aggrega con tu asistente de IA. Antes de construir scripts o un catálogo sobre Aggrega, lee Compatibilidad para saber qué puede cambiar una actualización y qué no.
Antes de leer la referencia, familiarízate con el modelo mental que establecen los capítulos de arquitectura. El capítulo Los cuatro dominios y Team Topologies explica cómo Aggrega separa las preocupaciones de Developer Intent, Platform Catalog, Platform Ops y Platform Operator en superficies de redacción distintas; el capítulo Taxonomía de entidades nombra las entidades (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) y sus roles en esos dominios. Cada capítulo de la referencia posterior a este supone que el lector tiene esa visión.
Usa esta referencia de dos maneras. Para la incorporación, léela en orden: empieza por Convenciones de nomenclatura para el patrón de los nombres de instancia y las reglas de mayúsculas y minúsculas, y después recorre los capítulos de entidades y vocabulario para construir el contrato de redacción completo. Para la consulta, ve directamente al subdirectorio que corresponda a la pregunta — entities/ para la semántica de los campos de cada entidad, vocabulary/ para las palabras clave comunes a varias entidades, templates/ para la superficie de plantillas de Go disponible para los autores de Recipe, providers/ para los contratos de despacho de cada provider, plugins/ para los sockets de plugins y la redacción de plugins, schema/ para el JSON Schema de cada tipo, cli/ para el uso de la línea de comandos, errors/ para los diagnósticos y examples/ para los patrones desarrollados.