Paquetes

Los paquetes almacenan información que debe reutilizarse. No son listas de tareas ni notas puntuales. Un buen paquete es algo que una persona o agente puede descubrir más adelante y utilizar como contexto, procedimiento o plantilla para trabajos futuros.

Tipos de paquetes

Utilice workflow cuando el orden sea importante. Utilice context cuando el contenido sea material de referencia que se pueda leer en secciones.

Flujos de trabajo

Los flujos de trabajo describen cómo hacer algo. Cada paso tiene un title requerido y un content, dependsOn y assignee opcionales. Los pasos del flujo de trabajo no tienen dueDate o parentId; esos son campos de ejecución en pistas de tareas. Utilice dependsOn para expresar el flujo entre pasos.

{
	"type": "workflow",
	"title": "Release review",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"steps": [
		{ "title": "Summarize changes", "content": "List merged PRs." },
		{ "title": "Check migrations", "content": "Confirm database impact." }
	]
}

Los asignados a los pasos del flujo de trabajo son human o un ID de agente. Los ID de usuario del espacio de trabajo no son asignatarios válidos de pasos del flujo de trabajo. Si el sistema no puede resolver el nombre de un asignado o el nombre es ambiguo, se guarda como vacío.

Ejecutando un flujo de trabajo

Los paquetes son reutilizables; Las pistas son ejecutables. Una ejecución de paquete conecta los dos: expande un flujo de trabajo en pistas (un objetivo raíz más una tarea todo por paso) en una sola operación (CLI epismo pack run, MCP epismo_pack_run, API POST /v1/packs/run).

La ejecución resuelve todo lo que requeriría una conversión manual:

• La meta raíz es el objetivo de la carrera y el ancla de recuperación. Su título/contenido proviene de la solicitud de ejecución, de forma predeterminada es el del paquete. Cada tarea se vincula a ella a través de goalId, por lo que toda la ejecución se puede recuperar más tarde con una búsqueda de pistas filtrada por la identificación del objetivo.
• Los ID del paso dependsOn se resuelven en los UUID de pista creados.
• Los tokens de los asignados del flujo de trabajo se asignan para realizar un seguimiento de los asignados (human necesita una asignación de ID de usuario; los ID de los agentes se resuelven tal cual).
• Cada pista creada lleva una fuente workflow:<pack-id> y los contextos referenciados se registran como fuentes context: en el objetivo; la procedencia sigue siendo consultable y el paquete en sí nunca se modifica con una ejecución.

Contextos

Los contextos son colecciones de bloques con nombre. Funcionan bien para incorporar material, políticas e investigaciones reutilizables: cualquier cosa que un agente o compañero de equipo deba leer como antecedente antes de actuar.

{
	"type": "context",
	"title": "Team onboarding",
	"scope": { "type": "personal" },
	"blocks": [
		{
			"title": "Where things live",
			"content": "Docs in Notion, code in GitHub, designs in Figma."
		},
		{
			"title": "How we work",
			"content": "Weekly planning on Mondays; ship behind feature flags."
		}
	]
}

Para contextos grandes, lea primero el esquema y luego busque el blockIds seleccionado. Esto mantiene el contexto del agente más pequeño y evita hidratar el contenido que el cliente no necesita.

Contenido general

Tanto el flujo de trabajo como los tipos de contexto tienen content de nivel superior. Úselo para obtener una breve descripción general de para qué sirve el paquete, no para ver el material reutilizable completo. Coloque material paso a paso reutilizable en el flujo de trabajo steps y material de referencia reutilizable en contexto blocks.

Operaciones de actualización

El contenido del paquete anidado se actualiza con matrices de operaciones. Utilice move con beforeId o afterId para reordenar artículos sin cambiar dependsOn. Omitir steps o blocks los mantiene sin cambios. Pasar una matriz vacía no es una operación. Para eliminar todos los elementos anidados, envíe una operación remove para cada ID.

Referencias

Se puede hacer referencia a los paquetes mediante UUID, alias, URL compartida o URL central. Los alias son la forma más legible para humanos y agentes:

epismo alias upsert @repo-onboarding --reference $PACK_REFERENCE
epismo pack get @repo-onboarding --full

Visibilidad y categorías

visibility controla el descubrimiento público. scope controla quién puede ver un paquete privado.

Mantenga los paquetes enfocados. Un paquete que combina procesos, antecedentes y estado actual de la tarea generalmente resulta difícil de reutilizar.