Aprende instruction.md
Un agente de IA hace lo que dicen sus instrucciones. instruction.md es una forma de poner esas instrucciones por escrito para que las personas puedan leerlas, ponerse de acuerdo sobre ellas y cambiarlas con seguridad, y para que cada agente siga la versión que su gente aprobó.
Una instrucción es un archivo Markdown: texto normal, con unas pocas palabras claras para lo que más importa, como
MUST y NEVER. Puedes escribir una en el editor sin instalar nada.
Empieza con una guía
Un vídeo corto, una tarea para seguir paso a paso y una lectura rápida. Unos minutos cada una. Todas las guías
-
Vídeo · 2 min Escribe tu primera instrucción Mira cómo se escribe una instrucción en el editor, desde una página en blanco hasta las reglas que sigue un agente. No hace falta cuenta. -
Paso a paso · 5 min Publícala y conecta un agente Inicia sesión, publica tu instrucción y dirige un agente de IA hacia ella para que siga lo que escribiste. -
Lectura rápida · 3 min Cómo funcionan las versiones Por qué tu borrador nunca sorprende a un agente: borradores, versiones y qué significa que una versión esté activa.
Por dónde seguir
- Tienes cinco minutos. Sigue el inicio rápido: escribe una instrucción, publícala y léela tal como lo hace un agente.
- Prefieres empezar por las ideas. Lee los conceptos: versiones, referencias (refs), quién puede leer qué y cómo se proponen los cambios.
- Quieres ver lo que puede decir una instrucción. Haz el recorrido por el lenguaje: reglas, políticas, herramientas, habilidades y personas, de una en una.
- Tu trabajo tiene pasos y aprobaciones. Mira los flujos de trabajo: un proceso escrito como pasos con nombre, con una persona que decide donde importa.
Cuando necesites los detalles
La documentación es la referencia: conectar un agente, la línea de comandos, la incrustación, las firmas y cómo gestionar tu propio registro. La especificación (en inglés) define exactamente qué significa cada parte de una instrucción, de modo que cualquier herramienta que la siga lee tu instrucción de la misma manera.