ores.compass Product Backlog — next and deferred listing

Table of Contents

Deferred from Sprint 18 on 2026-05-29 — not started; carried forward to product backlog. This page documents a story in Sprint 18. It captures the goal, current status, acceptance criteria, and the tasks that compose it.

Goal

compass backlog lists the next and deferred product-backlog captures in the same style that compass where shows in-flight sprint work: a count summary followed by titled entries per bucket. An operator (human or LLM) can see at a glance what is queued for the next version and what is on the longer-term wishlist without opening any files.

Status

Field Value
State BACKLOG
Parent sprint Sprint 18
Now Not yet started.
Waiting on Nothing.
Next Implement cmd_backlog in compass.py.
Last touched 2026-05-24

Acceptance

  • compass.sh backlog (or compass.sh backlog --next / --deferred) prints next and deferred captures, one per line, with title and path.
  • Output includes a count summary line per bucket (e.g. Next: 12 Deferred: 7).
  • --json flag emits machine-readable output with the same structure as the where command's in-flight list.
  • The command works correctly from any working directory (the CWD bug that caused generated files to land in projects/ores.compass/ is fixed as part of this story).
  • The How do I add a doc with compass? recipe is updated to include the new command.

Tasks

Task State Start End Description
Task: Implement product backlog next/deferred listing in compass DONE 2026-05-24 2026-05-24 Add compass backlog command to list next and deferred captures with counts and titles, mirroring the sprint in-flight display.
Add compass remember command DISCOVERED 2026-05-25   Implement compass remember –what X –why Y to scaffold and register a new project memory from the command line.

Decisions

  • Implement as a new backlog subcommand rather than extending where, so the two concerns remain separable and the output format can differ.

Out of scope

  • Filtering captures by tag or regex — that is already covered by compass list.
  • Editing or moving captures between buckets from the CLI.

Emacs 29.1 (Org mode 9.6.6)