Documentation / L’agent
Mémoire, skills et règles
Comment donner un contexte durable à l’agent avec la mémoire du projet, les skills, les prompts, les hooks et les règles, et comment il apprend de ses erreurs.
L’agent ne repart pas de zéro à chaque conversation. Il se souvient de l’essentiel du projet, charge des procédures selon la tâche et suit les règles de votre équipe.
Tout se gère dans le panneau du projet, onglet Agent, avec les sous-onglets Skills, Prompts, Hooks, Règles et Installer. En haut, vous choisissez la portée : Platform (l’agent de Yuli) ou Abonnements (Claude Code, Kiro, Codex et Antigravity).
Mémoire du projet
Ce dont l’agent doit se souvenir : instructions, décisions, conventions et données du projet.
- Enregistrer : dites « souviens-toi que… » dans le chat, ou ajoutez-le à la main.
- Consulter et modifier : en-tête du chat → Plus d'actions → Mémoire du projet.
- Emplacement :
.ai/memory/, versionnable avec le projet.
| Groupe | Exemple |
|---|---|
| Instructions | « Réponds toujours avec des exemples en Java 17. » |
| Décisions | « Nous utilisons une architecture hexagonale dans le module de paiements. » |
| Conventions | « Les DTO se terminent par Dto et se trouvent dans api/dto. » |
| Données du projet | « Le profil local utilise la base orders_dev. » |
Les entrées qui arrivent avec le dépôt apparaissent comme « du dépôt — non confirmé » et ne sont pas envoyées au modèle tant que vous ne les avez pas confirmées. Ainsi, un dépôt tiers ne peut pas donner d’instructions à l’agent.
Mémoire de l’équipe
La mémoire partagée de l’équipe se trouve dans .ai/team.json, versionnée avec le projet. Elle est visible dans Options globales → Équipe.
Skills
Une skill est une procédure que l’agent ne charge que lorsque la tâche en a besoin. Yuli en inclut 19 :
| Domaine | Skills |
|---|---|
| Code | Expliquer le code, Implémenter une fonctionnalité, Refactorisation sûre, refactor-or-evolve |
| Tests | Écrire des tests unitaires, Stratégie de test |
| Qualité et revue | Revue de code, Revue de sécurité, Revue d'intégration |
| Diagnostic | Déboguer jusqu'à la cause racine, Corriger les erreurs de build, gradle-java-build |
| Conception | Analyse des exigences, Conception d'architecture, ui-ux-design |
| Données | Explorateur de base de données |
| Documentation | document-system (documenter le système à la demande), sdlc-documentation |
| Git | Message de commit |
Les skills incluses sont en Lecture seule et se mettent à jour avec l’application. Pour en adapter une, utilisez Dupliquer pour personnaliser.
Vos propres skills
Créez les vôtres dans le sous-onglet Skills ou importez-les avec Importer des skills, prompts et hooks. Yuli accepte SKILL.md, PROMPT.md, les commandes de Claude Code, les .prompt.md de Copilot et hooks.json.
Vos skills, prompts et hooks sont enregistrés dans votre dossier utilisateur (sous Windows, %APPDATA%\.yulicode\) : ils vous suivent ainsi dans tous vos projets.
Comment elles se combinent
Dans Configuration de l’agent :
| Mode | Ce qu’il utilise |
|---|---|
| Automatique | Uniquement ce que fournit Yuli. |
| Personnalisée | Uniquement vos éléments. |
| Recommandée + les miennes (par défaut) | Les deux. Si un nom coïncide, le vôtre l’emporte. |
Prompts
Les prompts sont les instructions de base de l’agent : identité, cycle de vie des grandes tâches, chef d’équipe, sous-agent… Yuli les fournit calibrés. Vous pouvez les dupliquer et les ajuster.
Les prompts internes sont en anglais, pour plus de précision et moins de tokens. La réponse est toujours rédigée dans la langue de la personne qui écrit.
Hooks
Un hook intercepte une action de l’agent : par exemple, formater ce qui a été modifié ou valider une proposition avant de l’appliquer. Les scripts sont en Node.js, reçoivent l’événement en JSON, et un code de sortie différent de zéro bloque l’action. Le motif du blocage est transmis à l’agent pour qu’il ajuste son plan.
| Événement | Quand |
|---|---|
| Avant l'utilisation d'un outil | Avant chaque outil. |
| Après l'utilisation d'un outil | Après chaque outil. |
| À la fin d'une proposition | Lorsque l’agent a fini de proposer une modification. |
| Avant l'autorisation | Avant que vous n’approuviez. |
| Après application des modifications | Lorsque la modification a été écrite sur le disque. |
Yuli inclut des hooks prêts à l’emploi : Bloquer les commandes dangereuses, Ne pas lire les secrets, Protéger les fichiers sensibles, Pas de secrets dans le code, Aucun marqueur de conflit et Pas de fichiers géants.
Règles du projet
Les règles sont des instructions que l’agent suit toujours dans ce projet.
| Fichier | Portée |
|---|---|
.agentrules, yuli.md ou .cursorrules à la racine |
Tout le projet. |
.agentrules dans un sous-dossier |
Ce dossier. Le fichier le plus proche l’emporte. |
.ai/rules/*.md |
Règles de l’équipe. |
Dans le sous-onglet Règles : + Créer .agentrules, Règles recommandées et Importer un paquet (.zip).
Règles apprises
Yuli apprend des erreurs répétées. Lorsqu’un même constat apparaît 3 fois ou plus dans au moins 2 tâches en 30 jours, il devient une règle dans .ai/rules/learned.md.
Consultez-les dans le Centre de gouvernance → Agents → Apprentissage. Vous pouvez refuser une candidate ; elle n’est proposée à nouveau que si ses preuves doublent.
Pour votre agent d’abonnement
Dans la portée Abonnements, chaque agent dispose de sa section avec le fichier de règles que Yuli lui fournit, son état et « Ce que Yuli lui fournit » : les règles de la session et chaque skill de Yuli avec son coût en tokens.