Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Guide de rédaction

Ce guide est le compagnon pratique des chapitres d’architecture et de la référence du langage. Là où l’architecture explique pourquoi Aggrega a la forme qu’il a et où la référence précise ce que signifie chaque champ, ce guide enseigne comment s’y mettre et rédiger — vers quelle entité vous tourner, dans quel ordre, et comment la CLI et un assistant IA vous aident à obtenir un fichier correct avec le moins de friction possible.

Le guide s’adresse à deux publics à la fois : une personne qui rédige à la main dans un éditeur, et un assistant IA qui rédige pour le compte d’une personne via le serveur Model Context Protocol. Tous deux suivent la même boucle et lisent les mêmes surfaces de référence, de sorte que les pages ci-dessous servent aux deux.

À lire dans cet ordre

  1. Rédiger des fichiers Aggrega — la boucle de rédaction de bout en bout : choisissez votre rôle, apprenez la forme, générez le squelette, remplissez, validez, construisez. Commencez ici.
  2. Personas — les quatre rôles de rédaction qui collaborent (développeur, architecte, opérations, opérateur) et le principe « orientation, pas contrainte » qui les sous-tend.
  3. Entités par rôle — chaque type d’entité associé au rôle qui en est généralement propriétaire, pour savoir dans quel fichier chaque préoccupation a sa place.
  4. Installation — installer le binaire aggrega, avec les commandes en premier ; sa section sur la connexion renvoie à Connecter le serveur MCP.
  5. Utiliser Aggrega dans Visual Studio Code — l’extension Aggrega pour Visual Studio Code : ce dont elle a besoin, la page d’accueil, ses panneaux et le graphe de topologie, ainsi que chaque paramètre et chaque commande.

Importation part d’un projet que vous avez déjà dans un autre format et en tire des brouillons de ces fichiers, que vous relisez et compilez.

Apprendre Aggrega situe ce guide dans un parcours à travers toute la documentation.

Travailler avec un assistant IA

  1. Configurer Aggrega avec votre assistant IA — une seule invite à coller dans un assistant capable d’exécuter des commandes, pour qu’il installe Aggrega, ajoute le skill Aggrega et se connecte lui-même au serveur.
  2. Connecter le serveur MCP — l’entrée du serveur client par client, où chaque client la conserve, un serveur joint via HTTPS, et comment vérifier la connexion.
  3. Le skill Aggrega — les instructions qu’un assistant charge pour Aggrega : les installer et les tenir à jour.
  4. Ce que votre assistant peut faire avec Aggrega — ce que le serveur connecté permet à un assistant de lire, vérifier, construire et publier.

Comment les surfaces de l’assistant se rapportent à ce guide

Le serveur aggrega mcp expose ce guide, la référence du langage et les JSON Schemas comme des ressources qu’un assistant lit avant d’écrire du YAML, ainsi que des outils qui génèrent le squelette des entités et les valident. Les invites de rédaction intégrées de l’assistant renvoient à ces pages au lieu de les répéter, si bien que ce guide est le seul lieu en prose de la méthode de rédaction. Voir Rédiger des fichiers Aggrega pour la boucle et Connecter le serveur MCP pour la connexion.