Instructions et mémoire

Fournissez à l’agent des instructions persistantes et le contexte du projet via AGENTS.md, la configuration .maestro/ et une mémoire automatique optionnelle. L’agent lit tout cela au début de chaque session pour rester aligné sur vos normes et objectifs.

AGENTS.md

AGENTS.md est un fichier Markdown à la racine du projet (ou sous .midcore/) que l’agent charge en premier.

Quand utiliser AGENTS.md

Normes de code (style, nommage, exigences de tests)
Décisions d’architecture (p. ex. « les API vont dans apps/api/ »)
Bibliothèques et versions préférées
Listes de revue (p. ex. « Toujours lancer le lint avant commit »)

Court exemple :

markdown

# Project instructions

## Stack
- Backend: Node 20+, TypeScript strict mode
- Tests: Vitest; aim for 80%+ coverage on new code

## Conventions
- Use REST for HTTP APIs; document in OpenAPI.
- Never commit secrets; use env vars and reference the security doc.

## Before committing
- Run `pnpm lint` and `pnpm test`
- Run `midcore gates run` if this repo uses gates

Découverte

L’agent cherche AGENTS.md à la racine et dans .midcore/. Si les deux existent, le comportement dépend de l’environnement ; privilégiez une seule source de vérité.

Configuration .maestro

Le répertoire .maestro/ contient la configuration du compilateur et des barrières :

intent.yaml — Intention produit et palier de livraison (prototype, pilote, production). Le compilateur d’outcomes s’en sert pour le périmètre et le choix des barrières.
gates.yaml — Définit quelles barrières s’exécutent et dans quel ordre. L’evidence de chaque exécution est consignée dans le registre.

L’agent et le CLI lisent ces fichiers pour rester cohérents avec vos exigences de livraison et de preuve. Voir intent.yaml et la référence des barrières pour le schéma et des exemples.

Mémoire automatique (optionnel)

Certains environnements peuvent enregistrer des apprentissages entre sessions (p. ex. commandes de build, correctifs courants) sans éditer de fichier. Une fois activé, l’agent peut s’en souvenir plus tard. Optionnel et configurable ; voir la doc plateforme ou Paramètres pour l’activer ou le désactiver.

Points clés

AGENTS.md et la configuration .maestro donnent à l’agent instructions et contexte projet persistants.
Utilisez AGENTS.md pour les normes, l’architecture et les listes de revue afin que chaque session démarre alignée.
intent.yaml et gates.yaml pilotent le compilateur et la sélection des barrières ; l’agent les lit automatiquement.