Sync progress on a tracked work item¶
Same flow in a coding agent: invoke /work-tracking in
sync mode after an effort or ADR update. Board writes when
possible; --paste-md when not. Plays once — use Replay to watch again.
Situation: Work is already under tracking (## Tracking + board item). You
update effort steps, phase status, or ADR decisions in git while moving between
items, and the board card/issue must stay current. Board is visibility only —
never the source of truth for effort math.
Run: work-tracking — mode sync
Field mapping and scripts live only in the skill. Pair with
plan-effort-estimate whenever a
*.effort.json exists. Prefer sync-from-hoen.mjs for GitHub (issue body +
project fields); format-sync.mjs --map notion + MCP for Notion.
What a good outcome looks like¶
| Layer | Role |
|---|---|
| Git | Plan doc, ADR status, effort sidecar |
| Board | Progress headline, phase, status, plan doc URL, synced-at |
Illustrative board row (Plumbing / plan ID plumbing-auth-migration):
Same-session rule: plan/effort update, ## Tracking if the board item changed,
and every board surface (e.g. GitHub issue body and project fields) refresh
together.
If the external write fails: emit format-sync.mjs --paste-md (remote plan link
from git remote get-url origin) and ask the human to paste into the ticket.