トラック

進行中の作業を表すタスクとゴールです。

トラックは、完了に向かって進む作業を表します。ステータス、担当者、期限、依存関係、進捗を持つものはトラックにします。

トラックの種類

種別	用途	ステータスの値
`task`	具体的な作業単位	`backlog`, `todo`, `in_progress`, `done`
`goal`	進捗を持つ成果目標	`not_started`, `on_track`, `at_risk`, `postponed`, `completed`

タスクは実務的な作業です。ゴールは成果を志向した目標です。タスクは goalId でゴールに紐づけられます。

タスクとゴールの dueDate は YYYY-MM-DD です。更新で空文字を渡すと、任意の日付項目をクリアできます。タスクの status, parentId, goalId も、対応箇所では空文字でクリアできます。

タスクの項目

タスクは次の項目を持てます。

項目	意味
`status`	現在のタスクの状態
`dueDate`	`YYYY-MM-DD` 形式の日付
`assignee`	ワークスペースのユーザー ID またはインストール済みエージェント ID
`parentId`	親タスクの ID
`dependsOn`	先に完了すべきタスクの ID
`goalId`	このタスクが貢献するゴール

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

ゴールの項目

ゴールは status, dueDate, progress を持ちます。進捗は0から100の整数です。

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

まとめて計画する

エージェントやスクリプトがゼロから複数の関連トラックを作る場合は一括適用を使います。構造がすでにワークフロー・パックとして存在するなら、代わりに[パックの実行](/ja/docs/concepts/packs# ワークフロー・パックの実行)を使います。非 UUID の id は新規作成として扱われ、同じリクエスト内の他の作成・更新から参照できます。

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

サーバーは作成後に t001 や t002 を実際の UUID に解決します。

一括適用での型推論

upserts では、task または goal の存在からサーバーがトラックの種別を推論します。タスクなら task を含め goal を省略します。ゴールなら goal を含め task を省略します。同じ作成・更新に両方を渡すと不正です。

新規トラックには title が必要です。既存トラック（UUID の id）は PATCH 方式で、省略した項目は維持されます。

レビュー

レビュー（学習レビュー/Learning Review とも呼ばれます）は、1件以上のタスクまたはゴールに対する読み取り専用の分析結果です。対象トラック、関連するゴール/タスク、ログ、元になったワークフロー/コンテキストパックなどを集約し、再利用可能な学びの抽出や次のアクション（パックの作成・更新や改善案の作成など）を提案します。

レビューが出るタイミング

トラックがレビューしやすい特定のステータスに到達すると、ステータス更新時に基本的な統計情報（stats）を含む軽量な review オブジェクトが返されることがあります。

トラック種別	発火するステータス	意味
`task`	`done`	完了した作業から実行メモや再利用可能な手順を取り出す
`goal`	`completed`	達成した成果から、次回も使えるプロセスや判断基準を取り出す
`goal`	`postponed`	延期・方向転換から、前提条件、リスク、注意点を取り出す

生成された Markdown の本文（content）を含む詳細なレビューが必要な場合は、API（POST /v1/tracks/review）または CLI（epismo track review）から手動で実行します。詳細レビューは AI token usage に応じてクレジットを消費しますが、ステータス更新時の軽量レビューは無料です。

トラックに紐づくコメント/活動のタイムラインについてはログを参照してください。