パック

パックは、後から再利用する情報を保存するためのオブジェクトです。タスクのリストでも一時メモでもありません。良いパックは、人間やエージェントが後から見つけて、コンテキスト、手順、テンプレートとして使えます。

パックの種類

順序が重要なら ワークフロー・パック、セクション単位で参照する情報なら コンテキスト・パックを使います。

ワークフロー・パック

ワークフロー・パックは「どう進めるか」を表します。各ステップは必須の title と、任意の content, dueDate, dependsOn, parentId, assignee を持ちます。

{
	"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." }
	]
}

ワークフローステップの dueDate はワークフローの実行開始からの相対日数で、"7" のような数値の文字列です。カレンダー上の日付ではありません。絶対日付の期限が必要な場合はタスクの dueDate で YYYY-MM-DD を使います。

ワークフローステップの担当者は human またはエージェント ID です。ワークスペースのユーザー ID はワークフローステップの担当者には使えません。担当者の名前を解決できない、または曖昧な場合は空として保存されます。

ワークフロー・パックの実行

パックは再利用するもの、トラックは実行するものです。パックの実行（pack run）が両者をつなぎます。ワークフロー・パックをトラック（ルート・ゴール 1 件とステップごとの todo タスク）へ 1 回の操作で展開します（CLI epismo pack run、MCP epismo_pack_run、API POST /v1/packs/run）。

手作業での変換に必要だった処理は、実行がすべて解決します。

• ルート・ゴールは今回の実行の目的であり、後から実行全体を取得するためのアンカーです。タイトルと内容はリクエストで指定でき、省略時はパックの値が使われます。すべてのタスクは goalId でゴールに紐づくため、ゴール ID で絞り込んだトラック検索で実行全体を後から取得できます。
• ステップの相対期日（実行開始からの日数）は、実行開始日（省略時は今日）を起点とした YYYY-MM-DD の絶対日付に変換されます。
• ステップの dependsOn / parentId は作成されたトラックの UUID に解決されます。
• パック側の担当トークンはトラックの担当者にマッピングされます（human はユーザー ID へのマッピングが必要。エージェント ID はそのまま解決されます）。
• 作成されるすべてのトラックには workflow:<pack-id> ソースが刻まれ、参照したコンテキスト・パックは context: ソースとしてゴールに記録されます。来歴は検索可能なまま残り、パック本体が実行によって変更されることはありません。

コンテキスト・パック

コンテキスト・パックは名前付きブロックの集合です。オンボーディング資料、ポリシー、再利用する調査結果など、エージェントやチームメンバーが動く前に背景として読むべき情報に向いています。

{
	"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."
		}
	]
}

大きな コンテキスト・パックは、まずアウトラインを読み、必要な blockIds だけを取得します。エージェントに渡すコンテキストを小さく保ち、不要な内容の読み込みを避けられます。

概要の内容

ワークフロー / コンテキスト・パックはトップレベルの content を持ちます。これはパックの目的を短く説明する概要に使い、再利用する本体はワークフローの steps またはコンテキストの blocks に置きます。

更新操作

ネストしたパックの内容は操作の配列で更新します。steps または blocks を省略すると変更されません。空配列は何もしません。すべて削除したい場合は、各 ID に対して remove 操作を送ります。

参照

パックは UUID、エイリアス、共有 URL、ハブ URL で参照できます。人間とエージェントが読む文脈ではエイリアスが扱いやすい形式です。

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

公開範囲とカテゴリ

visibility は公開されたパックが見つけられるかどうかを制御します。scope は非公開パックの見える範囲を制御します。

パックは焦点を絞ってください。手順、背景、現在のタスクの状態を1つに混ぜると、再利用しにくくなります。