Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Guía de autoría

Esta guía es el complemento práctico de los capítulos de arquitectura y de la referencia del lenguaje. Donde la arquitectura explica por qué Aggrega tiene la forma que tiene y la referencia especifica qué significa cada campo, esta guía enseña cómo ponerse a escribir — a qué entidad recurrir, en qué orden, y cómo la CLI y un asistente de IA te ayudan a obtener un archivo correcto con la menor fricción.

La guía está escrita para dos públicos a la vez: una persona que escribe a mano en un editor y un asistente de IA que escribe en nombre de una persona a través del servidor Model Context Protocol. Ambos siguen el mismo ciclo y leen las mismas superficies de referencia, de modo que las páginas siguientes sirven a ambos.

Lee en este orden

  1. Escribir archivos de Aggrega — el ciclo de escritura de principio a fin: elige tu rol, aprende la forma, genera el esqueleto, rellena, valida, construye. Empieza aquí.
  2. Personas — los cuatro roles de escritura que colaboran (desarrollador, arquitecto, operaciones, operador) y el enfoque «orientación, no imposición» que los sustenta.
  3. Entidades por rol — cada tipo de entidad asociado al rol que normalmente es su propietario, para que sepas en qué archivo va cada aspecto.
  4. Instalación — instala el binario aggrega, con los comandos primero; su sección de conexión remite a Conecta el servidor MCP.
  5. Usar Aggrega en Visual Studio Code — la extensión de Aggrega para Visual Studio Code: qué necesita, la página de bienvenida, sus paneles y el grafo de topología, y cada ajuste y comando.

Importación parte de un proyecto que ya tienes en otro formato y genera a partir de él borradores de estos archivos, para que los revises y compiles.

Aprende Aggrega sitúa esta guía en un recorrido por toda la documentación.

Trabajar con un asistente de IA

  1. Configura Aggrega con tu asistente de IA — un único prompt para pegar en un asistente que pueda ejecutar comandos, de modo que instale Aggrega, añada la skill de Aggrega y se conecte por sí mismo al servidor.
  2. Conecta el servidor MCP — la entrada del servidor cliente por cliente, dónde la guarda cada cliente, un servidor al que se llega por HTTPS y cómo comprobar la conexión.
  3. La skill de Aggrega — las instrucciones que un asistente carga para Aggrega: cómo instalarlas y mantenerlas al día.
  4. Qué puede hacer tu asistente con Aggrega — lo que el servidor conectado permite a un asistente leer, comprobar, compilar y publicar.

Cómo se relacionan las superficies del asistente con esta guía

El servidor aggrega mcp expone esta guía, la referencia del lenguaje y los JSON Schemas como recursos que un asistente lee antes de escribir YAML, además de herramientas que generan el esqueleto de las entidades y las validan. Los prompts de escritura integrados del asistente remiten a estas páginas en lugar de repetirlas, así que esta guía es el único lugar en prosa del método de escritura. Consulta Escribir archivos de Aggrega para el ciclo y Conecta el servidor MCP para la conexión.