Conceptos centrales

El primer concepto Epismo es la diferencia entre información reutilizable y trabajo activo. La información reutilizable se almacena en forma de paquetes. El trabajo activo se almacena como pistas. Esta división mantiene el contexto del agente fácil de recuperar y mantiene el estado de ejecución fácil de actualizar para las personas y la automatización.

Paquetes vs pistas

Si preguntas "¿será útil más adelante?" y la respuesta es sí, crea un pack. Si pregunta "¿esto avanza hacia su finalización?" y la respuesta es sí, crea una pista.

Paquetes

Los paquetes son artefactos reutilizables. Epismo admite dos tipos de paquetes.

Un flujo de trabajo describe cómo hacer algo. Los ejemplos incluyen un proceso de revisión de versiones, un flujo de clasificación de errores o una lista de verificación de creación de habilidades. Cada paso puede tener title, content, dependsOn y assignee. No tiene dueDate ni parentId; esos pertenecen a las pistas de tareas. Los asignados a los pasos del flujo de trabajo son human o ID de agente. Los ID de usuario del espacio de trabajo no son asignatarios válidos de pasos del flujo de trabajo.

Un contexto describe lo que alguien o un agente debe saber. Los ejemplos incluyen una guía de incorporación de equipos, los antecedentes detrás de una política o un resumen de investigación de clientes. Para contextos grandes, lea primero el esquema y luego busque solo los bloques que el agente necesita.

Pistas

Las pistas representan trabajo activo. Epismo admite dos tipos de vías.

Las tareas son unidades concretas de trabajo. Pueden tener asignatarios, fechas de vencimiento, dependencias, tareas principales y objetivos vinculados. Las metas representan resultados. progress es un número entero de 0 a 100.

Para planificar muchas tareas a la vez, utilice la aplicación masiva. Los identificadores que no son UUID crean nuevos registros y otros upserts pueden hacer referencia a ellos en la misma solicitud a través de dependsOn, parentId y goalId. El servidor resuelve esas etiquetas en UUID reales.

También puede generar revisiones de solo lectura para extraer el aprendizaje de tareas/metas completadas o pospuestas. Una revisión lee pistas de destino, tareas/objetivos relacionados, registros y paquetes de origen, luego devuelve estadísticas más contenido de Markdown generado. Las reseñas no guardan nada por sí solas: utilícelas como apoyo para tomar decisiones antes de crear un nuevo paquete, actualizar un paquete de su propiedad o enviar una sugerencia a otro propietario de paquete.

Alias

Los alias son referencias a paquetes legibles por humanos.

Los alias apuntan únicamente a paquetes. Las pistas están referenciadas por UUID o por una URL que contiene un UUID. Utilice alias en solicitudes, runbooks y scripts de CI cuando una referencia estable y legible por humanos sea más fácil que un UUID sin formato.

Sugerencias

Las sugerencias son propuestas de mejora para paquetes basadas en texto. Cualquiera que pueda leer un paquete puede sugerir un cambio; el propietario del paquete lo revisa y lo resuelve (open → applied, declined o archived). Una sugerencia nunca edita el paquete directamente: captura una instantánea del paquete en el momento del envío y el propietario aplica los cambios aceptados mediante una actualización normal del paquete. Crear una sugerencia cuesta 5 créditos (la lista cuesta 2, otras operaciones cuestan 1) y tiene un límite de 20 por cuenta por día. Consulte Sugerencias para ver el modelo completo.

Espacio de trabajo, proyectos y espacio personal

Un espacio de trabajo es el límite de la organización. Sin un espacio de trabajo, los datos viven en el espacio personal. Los proyectos son contenedores dentro de un espacio de trabajo y se usan comúnmente como ámbitos de uso compartido privado.

El CLI resuelve el contexto de ejecución en este orden:

1. Si EPISMO_TOKEN incorpora un espacio de trabajo, utilice ese espacio de trabajo.
2. De lo contrario, utilice el valor predeterminado guardado de epismo workspace use $WORKSPACE_ID.
3. Si no se selecciona ningún espacio de trabajo, utilice el espacio personal.

API acepta un parámetro de consulta workspaceId en puntos finales compatibles. MCP deriva el contexto del espacio de trabajo del token de portador.

Alcance y uso compartido

Los registros privados viven en espacios personales o proyectos de espacios de trabajo. Para crear y actualizar llamadas utilice scope.

{ "scope": { "type": "personal" } }

{ "scope": { "type": "projects", "ids": ["project-id"] } }

Las llamadas de búsqueda utilizan scopes, porque una búsqueda puede incluir varias ubicaciones privadas.

{
	"scopes": [{ "type": "personal" }, { "type": "projects", "ids": ["project-id"] }]
}

Utilice sharedWith cuando un registro privado también deba ser visible para ID de usuario o correos electrónicos específicos. Durante la actualización, omitir scope o sharedWith conserva la configuración de acceso actual.

Visibilidad y créditos

Los paquetes tienen visibility. private sigue la configuración de alcance y uso compartido; public hace que el paquete sea reconocible. category puede estar vacío o ser uno de productivity, learning, programming, design, marketing, operations o life.

Los créditos son cuotas para las operaciones API, MCP y CLI. Los puntos finales API, las herramientas MCP y los comandos CLI enumeran su costo de crédito en sus tablas de referencia. Obtenga el contenido completo o seleccionado del paquete solo cuando se necesiten detalles; Verificar primero los resultados de búsqueda o los esquemas mantiene más pequeño el contexto del agente posterior. Las operaciones controladas por crédito pueden devolver 402 Payment Required cuando el saldo es insuficiente.

Opciones comunes