Inicio rápido

Publica una instrucción y luego léela tal como lo hace un agente. Unos cinco minutos, en una terminal. (¿Prefieres no usar una? Escribe y publica en el editor.)

1. Instala la CLI

Shell
npm install -g instruction.md
instruction --version

Todo lo que funciona sin conexión (validate, format, deliver, digest) está disponible sin cuenta.

2. Escribe un documento

Shell
instruction init support-agent --template agent

Ese comando crea la plantilla support-agent.md. Un documento mínimo tiene este aspecto:

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. Mira lo que recibirá un agente

Shell
instruction validate support-agent.md
instruction deliver support-agent.md environment=staging

Esta es la razón de ser de la especificación: los bytes están definidos, así que lo que ves aquí es lo que recibe cualquier lector que la cumpla. instruction validate enumera todo lo que hay en el documento por lo que se rechazaría la publicación. La plantilla agent declara un parámetro obligatorio, environment; deliver recibe su valor como name=value y lo escribe en el texto.

4. Inicia sesión y publica

Shell
instruction login
instruction push support-agent.md --visibility public --publish --message "first version"

Ahora tienes una versión inmutable y una referencia @latest que apunta a ella. El documento tiene un identificador canónico y una dirección que siguen los agentes, instruction://<you>/support-agent.

5. Léela como un agente

Shell
instruction watch instruction://<you>/support-agent@latest --out AGENT.md

Ese comando sigue la referencia: escribe el documento entregado y lo vuelve a escribir cada vez que publicas. Detenlo con Ctrl-C. Un agente hace lo mismo a través de MCP, sin consultas periódicas, mediante una suscripción (un flujo subscriptions/listen, que es también como se entera watch).

6. Publica un cambio

Shell
instruction push support-agent.md --to <id> --publish --message "tighten the refund rule"

Todo lo que siga a @latest lo recoge. Si quieres una referencia que solo se mueva de forma deliberada, publica en @stable y haz que los agentes sigan esa.

Siguiente