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: un Project, una Card, 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 o de trabajo actual: status de la card, fields del record, 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. Projects, Cards, Collections, Records, Entities y Connections contienen estado y ejecución. 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 contexto de un Project, el context bundle de una Card, el criterion de una Collection, el criterion de una Connection o una búsqueda dirigida. El contexto se entrega con el trabajo siempre que se puede, así rara vez necesitas cargar el workspace entero. Cuando el contexto entregado tiene una brecha, el preflight te dice cómo detectarla y cuándo buscar un Topic adicional. Knowledge write-back explica dónde pertenece cada tipo de aprendizaje, para que la actividad transitoria nunca se haga pasar por verdad institucional:
| Qué aprendiste | Dónde va |
|---|---|
| Estado operacional actual | un Record |
| Trabajo que sigue | una Card |
| Una identidad compartida | una Entity |
| Una observación o aprendizaje sin revisar | una Nota |
| Un cambio a Knowledge existente | una Edición sugerida |
| Feedback sobre un objeto | un Comment |
| Verdad institucional | Knowledge, pero solo tras revisión humana |
Elige tu workflow
Elige por intención:| Quiero… | Guía |
|---|---|
| Continuar un objetivo con otro agente | Project across agents |
| Operar clientes, leads, contenido o señales | Operate a Collection |
| Preservar lo que un agente aprendió | Govern agent learning |
| Auditar y limpiar contexto de forma segura | Clean workspace context |
| Usar evidencia que vive en una herramienta externa | External context with Broker |
Project across agents
Continúa un objetivo aunque cambie el modelo, la sesión o el agente. El Project es dueño del estado, no el modelo.
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 - los tres tipos de estado y el loop entre ellos.
- Proyectos y Colecciones - las primitivas de Work y Operations.
- 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.