Project Tracking

Project tracking

Where work lives

Place	What it holds	Authority
docs/open-residuals.md	Every deliberately deferred item, as a stable RES-* record with a closure contract	Authoritative
Issues	Bug reports, feature requests, and one [RES-…] issue mirroring each residual	Tracking
Project board	All open issues and pending Dependabot PRs, with Status and Priority	Tracking
docs/current-status.md	What shipped last, baseline counts, CI topology	Dated snapshot
docs/slice-history.md	Evidence for every shipped slice	History

The board

• Status: Todo → In progress → In review (PR open) → Done. Blocked means waiting on an owner decision, an upstream release, or another slice. The blocked:* label says which.
• Priority (triage proposal; the owner adjusts it): P1 gates production readiness or security, P2 is a real defect or a flaky gate, P3 is polish or debt.
• Ledger record names the RES-* id an item belongs to.

Labels

Family	Labels
Type	bug, enhancement, documentation, security, tech-debt, ci, dependencies, accessibility
Area	area:api, area:web, area:infra, area:audit, area:recovery, area:ingestion, area:authz, area:identity, area:workflow, area:records, area:docs, area:tooling
Blocked	blocked:owner-decision, blocked:upstream, blocked:sequencing
Other	residual (mirrors a ledger record), good first issue

Closing a residual

Ship the closure contract with linked evidence, remove the record from open-residuals.md in the same slice (/finish-slice), and close the mirrored issue with a link to that evidence.

Keeping tracking accurate

At triage, compare the board with all open issues and PRs, backfill missing items, and reconcile closed items. Preserve priorities and blocked reasons. A closed, unmerged PR can be Done because triage is complete; that does not mean its code shipped. The issue and ledger closure evidence decide whether a residual is resolved.

Native workflows now auto-add open EasySynQ issues and PRs, set new items to Todo, set closed items and merged PRs to Done, and return reopened items to Todo. Auto-close issue is disabled: moving a card never substitutes for residual closure evidence. The lifecycle was verified with acceptance issue #603.

At triage, move ready-for-review PRs to In review and restore Blocked on reopened items when their retained blocked label still applies. Priorities and ledger mappings remain manual. See the GitHub setup runbook for the maintenance procedure and #601 for closure evidence.