Pistas

Tareas y objetivos para el trabajo activo.

Las pistas representan el trabajo que avanza hacia su finalización. Utilice seguimientos cuando algo tenga estado, propiedad, fecha de vencimiento, dependencias o progreso.

Tipos de pistas

Tipo	Usar para	Valores de estado
`task`	Unidades de trabajo concretas	`backlog`, `todo`, `in_progress`, `done`
`goal`	Resultados con progreso	`not_started`, `on_track`, `at_risk`, `postponed`, `completed`

Las tareas están operativas. Las metas están orientadas a resultados. Una tarea puede vincularse a un objetivo a través de goalId.

Los valores de tarea y objetivo dueDate utilizan YYYY-MM-DD. Al actualizar, al pasar una cadena vacía se borran los campos de fecha opcionales. Las tareas status, parentId y goalId también se pueden borrar con una cadena vacía cuando sea compatible.

Campos de tareas

Las tareas pueden incluir:

Campo	Significado
`status`	Estado actual de la tarea
`dueDate`	Fecha en formato `YYYY-MM-DD`
`assignee`	ID de usuario del espacio de trabajo o ID del agente instalado
`parentId`	ID de tarea principal
`dependsOn`	ID de tareas que deben realizarse primero
`goalId`	Objetivo al que contribuye esta tarea

{
	"type": "task",
	"title": "Review API docs",
	"scope": { "type": "personal" },
	"task": {
		"status": "todo",
		"dueDate": "2026-06-05"
	}
}

Campos de objetivos

Los objetivos incluyen status, dueDate y progress. El progreso es un número entero de 0 a 100.

{
	"type": "goal",
	"title": "Ship docs v1",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"goal": {
		"status": "on_track",
		"progress": 40
	}
}

Planificación masiva

Utilice la aplicación masiva cuando un agente o script necesite crear múltiples pistas relacionadas desde cero. Si la estructura ya existe como flujo de trabajo, utilice un pack run en su lugar. Los identificadores que no son UUID crean nuevos registros y otros upserts pueden hacer referencia a ellos en la misma solicitud.

{
	"scope": { "type": "personal" },
	"upserts": [
		{ "id": "t001", "title": "Task A", "task": { "status": "todo" } },
		{ "id": "t002", "title": "Task B", "task": { "status": "todo", "dependsOn": ["t001"] } }
	]
}

El servidor resuelve t001 y t002 en UUID reales después de la creación.

Se aplica la inferencia de tipos de forma masiva

En upserts, el servidor infiere el tipo de pista a partir de la presencia de task o goal. Incluya task y omita goal para una tarea. Incluya goal y omita task como objetivo. Pasar ambos en el mismo upsert no es válido.

Las pistas nuevas requieren title. Las pistas existentes (identificación UUID) utilizan la semántica PATCH: los campos omitidos mantienen su valor actual.

Reseñas

Una revisión (también conocida como Revisión de aprendizaje) es un análisis generado de solo lectura de una o más tareas u objetivos. Recopila las pistas de destino, los objetivos/tareas vinculados, las tareas secundarias/de dependencia, los registros y los paquetes de flujo de trabajo/contexto de origen para extraer aprendizaje reutilizable y sugerir las siguientes acciones (por ejemplo, crear/actualizar un paquete o sugerir un cambio).

Cuando aparecen reseñas

Epismo puede devolver un objeto ligero review que contiene estadísticas básicas durante las actualizaciones de estado cuando una pista alcanza un resultado revisable:

Tipo de pista	Estado de activación	Por qué es importante
`task`	`done`	Extraiga notas de ejecución local y pasos reutilizables.
`goal`	`completed`	Captar procesos exitosos y criterios de decisión.
`goal`	`postponed`	Capture suposiciones, riesgos y lecciones de un giro o retraso.

Para obtener una revisión detallada de Markdown que contenga el content generado en profundidad, ejecute una revisión manual utilizando el API (POST /v1/tracks/review) o el CLI (epismo track review). Las revisiones detalladas consumen créditos según el uso del token de IA, mientras que las revisiones ligeras de actualización de estado son gratuitas.

Consulte Logs para ver el cronograma de comentarios/actividades adjunto a una pista.