パック

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

パックの種類

順序が重要なら workflow pack、セクション単位で参照する情報なら context pack を使います。

workflow pack

workflow pack は「どう進めるか」を表します。各ステップは必須の 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 はワークフローステップの担当者には使えません。担当者の名前を解決できない、または曖昧な場合は空として保存されます。

context pack

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

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

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

概要の内容

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

更新操作

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

参照

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

epismo alias upsert @repo-onboarding --id $PACK_ID
epismo pack get @repo-onboarding --full

公開範囲とカテゴリ

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

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