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

Shell
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

Shell
instruction init support-agent --template agent

Cette commande crée un modèle, support-agent.md. Un document minimal ressemble à ceci :

support-agent.md
---
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

Shell
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

Shell
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

Shell
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

Shell
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