Packs

Pack は、後から再利用する情報を保存するための object です。Task list でも一時メモでもありません。良い pack は、人間や agent が後から見つけて、context、手順、template として使えます。

Pack types

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

Workflow packs

Workflow pack は「どう進めるか」を表します。各 step は必須の 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." }
	]
}

Workflow step の dueDate は workflow run からの相対日数で、"7" のような numeric string です。Calendar date ではありません。絶対日付の deadline が必要な場合は task dueDate の YYYY-MM-DD を使います。

Workflow step assignee は human または agent ID です。Workspace user ID は workflow step の assignee には使えません。Assignee name を解決できない、または曖昧な場合は empty として保存されます。

Context packs

Context pack は名前付き block の集合です。Onboarding material、implementation notes、reusable research に向いています。

{
	"type": "context",
	"title": "Repo onboarding",
	"scope": { "type": "personal" },
	"blocks": [
		{ "title": "Layout", "content": "apps/, server/, protobuf/" },
		{ "title": "Local setup", "content": "npm install" }
	]
}

大きな context pack は、まず outline を読み、必要な blockIds だけを取得します。Agent context を小さく保ち、不要な content hydration を避けられます。

Overview content

Workflow/context pack は top-level content を持ちます。これは pack の目的を短く説明する overview に使い、再利用する本体は workflow steps または context blocks に置きます。

Update operations

Nested pack content は operation array で更新します。steps または blocks を省略すると変更されません。空配列は no-op です。すべて削除したい場合は、各 ID に対して remove operation を送ります。

References

Pack は UUID、alias、share URL、hub URL で参照できます。人間と agent が読む文脈では alias が扱いやすい形式です。

epismo alias upsert @repo-onboarding --type context --id <pack-id>
epismo pack get @repo-onboarding --full

Visibility and categories

visibility は public discovery を制御します。scope は private pack の見える範囲を制御します。

Pack は焦点を絞ってください。Process、background、current task status を 1 つに混ぜると、再利用しにくくなります。