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
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
instruction init support-agent --template agent Ese comando crea la plantilla support-agent.md. Un documento mínimo tiene este aspecto:
---
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
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
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
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
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
- Conecta un agente real.
- Conceptos: referencias, versiones, visibilidad, propuestas.
- El lenguaje: qué más puede decir una instrucción.
- Firma tus versiones para que los consumidores puedan verificarlas.