chore(specs): backlog grooming — archive 6, gate 1#255
Conversation
Backlog grooming pass approved by Patrick after the velocity
push that produced 24+ PRs in two days. Reduces active
docs/specs/ from 15 entries to 9 by archiving completed,
obsolete, or superseded specs.
Archived to docs/specs/archive/:
- telemetry — complete since v3.8.2
- ci-debt — complete 2026-05-10 across Phases A/B/C
- probe-c-memory-investigation — resolved same-day with
one-line patch("threading.Thread") fix
- ops-specs-features — shipped in three phases (#236/#239/#240)
- ops-security-hardening — implemented in PR #254 (a5c50bd);
status flipped to "complete" before the move
- larger-runners — closed; Probe-C resolved the OOM concern,
spec itself admits the case is smaller
Gated:
- redis-decoupling — Phase 3A done but no production trigger.
Added explicit gate decision: don't implement until memory-
backend abstraction shows real friction; revisit by 2026-11-12
if no trigger fires.
Discovery safety: spec_orient.py walks docs/specs/ one level
deep and uses _phase_for_dir() to filter non-spec directories.
archive/ has no spec files at its top level → returns None →
silently skipped. Archived specs do not appear in session
orientation. README.md in archive/ explains the convention.
Active backlog after this pass:
coverage-canonical-pattern, coverage-exclusion-policy,
ignored-tests, ops-runner-tier2, redis-decoupling (gated),
test-infrastructure, website-update-dashboard-and-fold,
windows-memory-detection, windows-xdist-honor
github-actions
Bot
added
the
documentation
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
|
Closing — superseded by 36 hours of velocity push (25+ PRs landed since this was opened). What this PR still gets right: the 6 spec-archive moves ( What's now stale: the What's missing: ~4 specs that closed today aren't in this PR's archive list: Defer to a fresh grooming PR. Cruft in |
1 participant
Backlog grooming pass approved by Patrick after the recent velocity push (24+ PRs in two days). Reduces active `docs/specs/` from 15 entries to 9 by archiving completed/obsolete/superseded specs and explicitly gating one approved-but-not-triggered spec.
What moved
Archived to `docs/specs/archive/`:
Gated:
Active backlog after this pass
`coverage-canonical-pattern`, `coverage-exclusion-policy`, `ignored-tests`, `ops-runner-tier2`, `redis-decoupling` (gated), `test-infrastructure`, `website-update-dashboard-and-fold`, `windows-memory-detection`, `windows-xdist-honor`.
Discovery safety
`plugin/hooks/spec_orient.py` walks `docs/specs/` one level deep and uses `_phase_for_dir()` to filter non-spec directories. `archive/` has no spec files at its top level → returns `None` → silently skipped. Archived specs do NOT appear in session orientation. `docs/specs/archive/README.md` documents the convention.
Test plan
Rollback
`git revert` this commit. The `mv` is a pure rename so revert restores the original layout cleanly.
🤖 Generated with Claude Code