cowork-sync

name	cowork-sync
type	skill
category	instruction
description	Mirror PKB tasks onto the Cowork native task list at claim time and sync completion back to PKB. Cowork-only; ships only in the cowork build of aops-core.
triggers	["mirror task","sync task list","cowork task","native task list","TaskCreate","merge tasks onto cowork"]
modifies_files	false
needs_task	false
mode	procedure
domain	["operations"]
platforms	["cowork"]
permalink	skills/cowork-sync

/cowork-sync: PKB ↔ Native Task List Mirror

Defines procedures for aligning the Personal Knowledge Base (PKB) with the Cowork harness-native task list.

Invariants

• PKB remains the system of record.
• Mirror claimed tasks from PKB onto the native list at /pull claim time.
• Write native task updates (in_progress, completed) to the native list.
• Sync native child completions back to PKB via mcp__pkb__complete_task in real time. Parent task sync is deferred to /end_session's release_task.
• Every native task must store its PKB task ID in its description (e.g. "PKB task-acba1234 — Implement X").
• Only /pull and /end_session drive this mirror; supervisor ticks and ad-hoc PKB writes bypass it and won't appear on the native list until the next /pull.

Bootstrap

Before calling native task tools, ensure schemas are loaded:

ToolSearch(query="select:TaskCreate,TaskUpdate,TaskList,TaskGet", max_results=4)

Mirror Procedure (PKB → Native)

Invoked by /pull claim step.

1. Fetch the PKB task and its children:

   parent = mcp__pkb__get_task(id="<pkb-id>")
   leaves = mcp__pkb__get_task_children(id="<pkb-id>")
   

2. Create the parent native task:

   parent_native = TaskCreate(
     subject="<short-title>",
     description="PKB <pkb-id> — <full-title>",
     activeForm="Implementing <subject>"
   )
   

3. For each child task in leaves, create a native task and block the parent:

   child_native = TaskCreate(
     subject="<child-title>",
     description="PKB <child-id> — <child-title>",
     activeForm="Implementing <child-title>"
   )
   TaskUpdate(taskId=child_native addBlocks=parent_native)