Guia de autoria
Este guia é o complemento prático dos capítulos de arquitetura e da referência da linguagem. Onde a arquitetura explica por que o Aggrega tem a forma que tem e a referência especifica o que cada campo significa, este guia ensina como sentar e escrever — a qual entidade recorrer, em que ordem, e como a CLI e um assistente de IA ajudam você a obter um arquivo correto com o mínimo de atrito.
O guia é escrito para dois públicos ao mesmo tempo: uma pessoa que escreve à mão em um editor e um assistente de IA que escreve em nome de uma pessoa por meio do servidor Model Context Protocol. Ambos seguem o mesmo ciclo e leem as mesmas superfícies de referência, então as páginas abaixo servem a ambos.
Leia nesta ordem
- Escrever arquivos do Aggrega — o ciclo de escrita de ponta a ponta: escolha seu papel, aprenda a forma, gere o esqueleto, preencha, valide, construa. Comece aqui.
- Personas — os quatro papéis de escrita que colaboram (desenvolvedor, arquiteto, operações, operador) e a abordagem “orientação, não imposição” por trás deles.
- Entidades por papel — cada tipo de entidade associado ao papel que normalmente é seu dono, para que você saiba em qual arquivo cada preocupação deve ficar.
- Instalação — instale o binário
aggrega, com os comandos primeiro; a seção de conexão aponta para Conecte o servidor MCP. - Usar o Aggrega no Visual Studio Code — a extensão do Aggrega para o Visual Studio Code: o que ela exige, a página de boas-vindas, seus painéis e o grafo de topologia, e cada configuração e comando.
Importação parte de um projeto que você já tem em outro formato e gera a partir dele rascunhos destes arquivos, para você revisar e compilar.
Aprenda o Aggrega situa este guia em um percurso por toda a documentação.
Trabalhar com um assistente de IA
- Configure o Aggrega com o seu assistente de IA — um único prompt para colar em um assistente que pode executar comandos, para que ele instale o Aggrega, adicione a skill do Aggrega e se conecte sozinho ao servidor.
- Conecte o servidor MCP — a entrada do servidor cliente a cliente, onde cada cliente a guarda, um servidor acessado via HTTPS e como verificar a conexã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 conectado 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 geram o esqueleto de entidades e as validam. Os prompts de escrita integrados do assistente remetem a estas páginas em vez de repeti-las, então este guia é o único lugar em prosa do método de escrita. Consulte Escrever arquivos do Aggrega para o ciclo e Conecte o servidor MCP para a conexão.