Story: Fix product-backlog bucket names in scripts and captures
Table of Contents
This page documents a story in Sprint 18. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
The product-backlog directories were renamed from near/ / far/ to next/ / deferred/,
but the tooling was not updated in sync. regenerate_backlog_indexes.py still writes
near.org and far.org, compass help text still says near|far, and every capture in
next/ carries a stale :near: filetag. This story fixes all tooling and capture metadata
to match the renamed directories.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 18 |
| Now | Nothing. |
| Waiting on | — |
| Next | — |
| Last touched | 2026-05-29 |
Acceptance
regenerate_backlog_indexes.pywrites tonext.organddeferred.org, notnear.org/far.org.near.org,far.org, and the emptynear/andfar/directories are deleted.- All captures under
next/carry:next:filetag, not:near:. - All captures under
deferred/carry:deferred:filetag, not:far:. compass.pyhelp text usesnext|deferred|discarded.doc_generate.pycomment usesnext | deferred.- Running
regenerate_backlog_indexes.pyproduces no diff against committednext.org/deferred.org.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Fix legacy near/far bucket name references | DONE | 2026-05-29 | 2026-05-29 | Update scripts and capture filetags. |
Decisions
near.organdfar.orgare deleted outright — they are stale duplicates ofnext.org/deferred.org(same UUID, wrong filename).- The single file in
near/(extend_validate_docs_frontmatter.org) is moved tonext/as part of the rename cleanup. - This story exists because Per-sprint capture workflow renamed the directories
(
near/→next/,far/→deferred/) and created the new index files, but did not updateregenerate_backlog_indexes.py,compass.py, or the:near:/:far:filetags in existing captures. The script was left pointing at the old filenames.
Out of scope
- The
inbox/,discarded/buckets — names are already current. - Sprint story/task docs that contain "near" or "far" in prose.