Qué es una guía
Una guía es un resultado más el camino exacto hacia él. Eliges un resultado, cargas el contexto que el equipo ya registró, inspeccionas el estado actual, actúas y dejas el workspace un poco más capaz de lo que lo encontraste. Responde las preguntas que una referencia no puede: cuándo correr esto, qué objetos participan, qué leer primero, qué esperar después de cada paso y qué debería (y qué no debería) convertirse en Knowledge del equipo.Guía, Concepto o Referencia
Tres tipos de página, tres trabajos:- Un Concepto explica qué es una primitiva y por qué funciona como funciona. Léelo para construir el modelo mental.
- Una Referencia (CLI, API, MCP) lista cada comando, flag y endpoint. Léela para buscar un parámetro exacto.
- Una Guía combina primitivas en un workflow que alcanza un resultado. Léela para lograr algo.
El loop compartido
Cada guía es una variación del mismo loop de seis pasos. Apréndelo una vez y cada workflow se lee como una especialización suya:- Resolve. Encuentra o crea el objeto que estás trabajando: una Collection, un Record, una Entity o una Connection.
- Read governed context. Tira del Knowledge durable que debe guiar la acción, entregado con el trabajo, no buscado a ciegas.
- Inspect live state. Lee el estado operacional actual: fields del record o salud de la connection.
- Act. Haz el único cambio que el paso pide.
- Write back. Registra el nuevo estado en la primitiva correcta.
- Preserve learning. Deja una Nota limpia cuando aprendiste algo durable, para que el próximo agente empiece adelantado.
Topics informan cada workflow
Cada workflow está informado por los Topics relevantes, pero no todo empieza con una búsqueda global, y no todo lo que aprendes se convierte en Topic. La regla que lo mantiene en orden:Los Topics contienen el contexto durable que debe guiar acciones futuras. Collections, Records, Entities y Connections contienen estado operacional. Skills y Guías enseñan cómo combinarlos.Por eso cada guía lleva dos secciones obligatorias que aplican la regla: Context preflight explica qué contexto durable leer antes de actuar, y cómo llega hasta ti: mediante el criterion de una Collection, el criterion de una Connection o una búsqueda dirigida. El contexto se entrega con el objeto operacional siempre que se puede, así rara vez necesitas cargar el workspace entero. Knowledge write-back explica dónde pertenece cada tipo de aprendizaje, para que la actividad transitoria nunca se haga pasar por verdad institucional:
El output de una ejecución, un snapshot tirado de una herramienta externa o un valor de una sola vez no es Knowledge. Se queda como estado operacional o Nota hasta que una persona lo revisa. Ver Gobernanza.
Elige tu workflow
Elige por intención:Operate a Collection
Trabaja un lead, cliente, ítem de contenido o señal de producto con los criterios del equipo cargados, no como una tabla aislada.
Govern agent learning
Convierte una observación de agente en una Nota, una Edición sugerida o Knowledge revisado, con un humano decidiendo qué se vuelve verdad.
Clean workspace context
Audita el vault y prepara una limpieza segura que nunca destruye Knowledge por su cuenta.
External context with Broker
Tira evidencia de una herramienta conectada hacia el trabajo operacional, sin confundirla con Knowledge.
Referencia relacionada
- El loop de Driftless - Knowledge, Operations y el loop entre ambos.
- Colecciones - el primitivo operacional.
- Gobernanza - Nota, Edición sugerida y Knowledge.
- Integraciones y Broker - acceso gobernado a sistemas externos.
- CLI, API y MCP - las superficies completas de comandos, endpoints y tools.