Guia de criação
Este guia é o complemento prático dos capítulos de arquitetura e da referência da linguagem. Enquanto a arquitetura explica porque o Aggrega tem a forma que tem e a referência especifica o que cada campo significa, este guia ensina como pôr mãos à obra e escrever — que entidade usar, por que ordem, e como a CLI e um assistente de IA ajudam a obter um ficheiro correto com o mínimo de atrito.
O guia foi escrito para dois públicos ao mesmo tempo: uma pessoa que escreve à mão num editor e um assistente de IA que escreve em nome de uma pessoa através do servidor Model Context Protocol. Ambos seguem o mesmo ciclo e leem as mesmas superfícies de referência, pelo que as páginas abaixo servem ambos.
Ler por esta ordem
- Escrever ficheiros do Aggrega — o ciclo de autoria de ponta a ponta: escolher o papel, aprender a forma, criar o esqueleto, preencher, validar, compilar. Comece aqui.
- Personas — os quatro papéis de autoria colaborativos (programador, arquiteto, operações, operador) e o enquadramento de orientação, não de imposição, por trás deles.
- Entidades por papel — cada tipo de entidade associado ao papel que normalmente o detém, para saber a que ficheiro pertence cada preocupação.
- Instalação — instalar o binário
aggrega, com os comandos primeiro; a secção de ligação remete para Ligar o servidor MCP. - Usar o Aggrega no Visual Studio Code — a extensão do Aggrega para o Visual Studio Code: o que necessita, a página de boas-vindas, os seus painéis e o grafo da topologia, e cada definição e comando.
Importação parte de um projeto que já tem noutro formato e gera a partir dele rascunhos destes ficheiros, para os rever e compilar.
Aprender o Aggrega situa este guia num percurso por toda a documentação.
Trabalhar com um assistente de IA
- Configurar o Aggrega com o seu assistente de IA — um único prompt para colar num assistente que consiga executar comandos, para que instale o Aggrega, adicione a skill do Aggrega e se ligue sozinho ao servidor.
- Ligar o servidor MCP — a entrada do servidor cliente a cliente, onde cada cliente a guarda, um servidor acedido por HTTPS e como verificar a ligação.
- A skill do Aggrega — as instruções que um assistente carrega para o Aggrega: como instalá-las e mantê-las atualizadas.
- O que o seu assistente pode fazer com o Aggrega — o que o servidor ligado permite a um assistente ler, verificar, compilar e publicar.
Como as superfícies do assistente se relacionam com este guia
O servidor aggrega mcp expõe este guia, a referência da linguagem e os JSON Schemas como recursos que um assistente lê antes de escrever YAML, além de ferramentas que criam o esqueleto de entidades e as validam. Os prompts de autoria integrados do assistente remetem para estas páginas em vez de as repetirem, pelo que este guia é o único lugar em prosa do método de autoria. Consulte Escrever ficheiros do Aggrega para o ciclo e Ligar o servidor MCP para a ligação.