Démarrage rapide
Publiez une instruction, puis relisez-la comme le fait un agent. Environ cinq minutes, dans un terminal. (Vous préférez vous en passer ? Écrivez et publiez plutôt dans l’éditeur.)
1. Installez la CLI
npm install -g instruction.md
instruction --version Tout ce qui fonctionne hors ligne (validate, format, deliver, digest) est utilisable sans compte.
2. Écrivez un document
instruction init support-agent --template agent Cette commande crée un modèle, support-agent.md. Un document minimal ressemble à ceci :
---
spec: "1"
title: Support agent
---
# Support agent
You answer billing questions for Acme.
MUST[verify-identity]: verify the customer's identity before discussing an account.
BECAUSE: an account holds another person's data. 3. Voyez ce qu’un agent recevra
instruction validate support-agent.md
instruction deliver support-agent.md environment=staging
C’est tout l’intérêt de la spécification : les octets sont définis, donc ce que vous voyez ici est ce que reçoit
chaque lecteur conforme. instruction validate liste tout ce qui, dans le document, ferait refuser la
publication. Le modèle agent déclare un paramètre obligatoire, environment ; deliver
prend sa valeur sous la forme name=value et l’écrit dans le texte.
4. Connectez-vous et publiez
instruction login
instruction push support-agent.md --visibility public --publish --message "first version"
Vous avez maintenant une version immuable et une référence (ref) @latest qui pointe vers elle. Le
document a un identifiant canonique et une adresse que suivent les agents,
instruction://<you>/support-agent.
5. Relisez-la comme un agent
instruction watch instruction://<you>/support-agent@latest --out AGENT.md
Cette commande suit la référence : elle écrit le document délivré et le réécrit chaque fois que vous publiez.
Arrêtez-la avec Ctrl-C. Un agent fait la même chose via MCP, sans interroger le serveur à intervalles réguliers,
en s’abonnant (un flux subscriptions/listen, et c’est aussi ainsi que watch en est
averti).
6. Publiez une modification
instruction push support-agent.md --to <id> --publish --message "tighten the refund rule"
Tout ce qui suit @latest la récupère. Si vous voulez une référence qui ne bouge que sur décision,
publiez vers @stable et faites suivre celle-ci à vos agents.
Ensuite
- Connectez un vrai agent.
- Concepts : références, versions, visibilité, propositions.
- Le langage : ce qu’une instruction peut dire d’autre.
- Signez vos versions pour que ceux qui les utilisent puissent les vérifier.