Backlog

Discovered something unrelated to what you're currently working on? backlog captures it without expanding the current task or milestone's scope.

pitway backlog add --title "Short label" --reason "Why this was deferred."

pitway backlog list                 # or --status pending|promoted|archived
pitway backlog show B001

--milestone/--task on add are source annotation only, defaulting to the active milestone with no task -- backlog requires an active milestone; there's no global backlog.

Promoting or closing an entry

# Once the real task/milestone already exists -- promote never creates
# one itself, --task/--milestone here mean the target only:
pitway backlog promote B001 --task T004

# Or close it out without acting on it:
pitway backlog archive B001 --reason "No longer relevant."

State

.pitway/backlog.yaml is the authoritative backlog state. It's committed alongside whatever commit the active milestone's workflow next produces -- never a dedicated commit of its own, and never a reason a task's own clean-tree check fails.