tracker-synclisted

Persistent snapshot + bidirectional reconcile between The Bridge tasks and GitHub Project boards. Pulls each board into work/trackers/<provider>/<slug>.json (the local mirror / dump), diffs it against work/tasks|streams/*/STATUS.md sync.github bindings into a delta table (in_sync · remote_ahead · local_ahead · state_mismatch · orphan_local · orphan_remote), and pushes local→remote changes through github-projects-manager — gated, never auto. GitHub is the system of record, The Bridge is the cockpit (remote-authoritative). Trigger: "/tracker-sync", "tracker sync", "sync my tasks", "reconcile tasks", "board reconcile", "snapshot github", "which task is in which state", "github project dump", "sync tasks down", "sync tasks up", "task drift", "sync status".
bks-lab/open-bridge · ★ 8 · AI & Automation · score 74

Install: claude install-skill bks-lab/open-bridge

# Tracker-Sync Keeps The Bridge's task state and the GitHub Project boards aligned, with a **persistent local snapshot** as the pivot. Three deterministic engine subcommands (`scripts/tracker-sync.py` — a shared repo-root utility shipped with the Bridge repo itself, not a file inside this skill's own directory) plus one gated write path. **Provider scope:** GitHub Projects V2 only for now — other trackers (e.g. ADO) are readable via `trackers/*.md` playbooks but are not covered by snapshot/diff/push. **Model — remote-authoritative.** The team works *in* GitHub, so the board owns shared status. The Bridge mirrors it, surfaces drift, and stages *your* pushes. Pull is autonomous (read-only); every cross-write is a proposal: - **never auto-write STATUS.md** (a human decides what a remote change means) - **never auto-push** to GitHub (gated, batch-confirmed, via github-projects-manager) ## When to use - "sync my tasks", "which task is in which state" - "pull the boards", "snapshot the projects", "give me a board dump" - before/after working a board, to see what drifted - `/briefing` calls the pull side automatically (see references/workflow.md) ## Subcommands (verbs) | Verb | What | Gate | |---|---|---| | `pull` | refresh snapshots from all enabled GitHub boards | autonomous (read-only) | | `status` / `diff` | render the delta table (the control surface) | read-only | | `push` | apply `local_ahead` rows to GitHub | **gated**, via github-projects-manager | | `sync` | `pull`