Backlog items

What a backlog item holds, and what turns one into a feature.

Future work captured before committing to it.

Scope

A backlog item belongs to:

  • A product (required)
  • A focus area (optional) - nil means "unfocused / product-level"

This lets a "Marketing" focus area have its own backlog separate from "Developer tools", while still allowing cross-cutting product-level items.

Fields

  • title - short summary
  • description - longer context
  • priority - low / medium / high
  • source - "session" (added during session), "ui" (added manually)
  • promotedToFeatureId - set when promoted; nil = still pending

Promotion

When promotedToFeatureId is set:

  • The item is considered "not pending"
  • It doesn't appear in pending lists
  • But the record is kept (origin trail)

If the feature is deleted, promotedToFeatureId resets to nil and the item returns to pending.

Managing

In the UI:

  • Type into the field at the top of a product's Backlog in the panel
  • Right-click → Move to (move between focus areas)
  • Right-click → Delete, or click the X button

Via natural language:

  • "Add to backlog: [idea]" - adds to current focus area
  • "Move [item] to Unfocused" - changes scope
  • "Delete [item] from backlog"
  • "What's in the backlog?" - grouped by focus area