The /backlog workflow manages the entire backlog lifecycle of a project: viewing summaries, adding features/bugs, evaluating ICE priorities, updating status, and syncing with the implementation plan. Version v1.5.3 introduces Auto-Sync features based on the Hybrid 3-file mechanism.
Commands List
/backlog [project-name] [action]| Action | Description |
|---|---|
review | See overview with stats and phase context. |
add | Add a new Epic, feature, or bug. |
evaluate | Grade tasks via ICE framework priority. |
update | Update status + automate 3-File sync. |
sync | Cross-reference backlog against Plan. |
clean | Move ✅ Done tasks to done.md. |
Detailed Sub-Commands
0. Rules Pre-flight (v1.5.4)
Before any action executes, the agent re-reads .agent/rules.md from disk to restore rule context. This is part of the Defense-in-Depth Layer 3 protection — ensuring rules survive context truncation in long sessions.
1. review — Overview and Summaries
- Reads
artifacts/tasks/backlog.mdand loads content. - Cross-references the deployment plan loaded from
project.md. - Displays the Summary table and extracts Top 3 Actionable Items (high priority task list).
- Warns the Agent/User if attempting to fulfill future phase tasks while the current phase remains incomplete.
2. add — Create New Tasks
- Rapidly categorizes standard tasks under Epic, Feature, or Bug taxonomy.
- Automatically initializes incremental IDs with appropriate namespaces (e.g.,
FEAT-02,BUG-01). - Appends to the relevant sections inside
backlog.md. If a Phase is active, maps the new task directly onto it.
3. evaluate — ICE Prioritization Framework
- Filters tasks currently set to the ⏳ Pending status.
- Evaluates them through a 3-pillar criteria system (1-10 scale): Impact, Confidence, and Ease.
- Computes overall ICE index = I × C × E.
- Items crossing the default threshold (>500) automatically escalate to the
🚀 High Prioritysection.
4. update — Status Mutation & Auto-Sync (v1.5.3 Feature)
- Cycles item states:
⏳ Pending,🚀 ToDo,🔨 In Progress,✅ Done. - Informs about Phase Completion events.
- Hybrid Auto-Sync Integrations:
- Instantly overwrites the
sprint-current.mdvolatile state file with only🚀 ToDoand🔨 In Progressitems to optimize massive token loads for the subsequent/opencommand. - Mitigates tracking noise without disrupting agent intelligence chains.
- Instantly overwrites the
5. sync — Plan Synchronizer
- Projects the Backlog list onto the defined Architecture/Plan phase map.
- Highlights Missing tasks or incorrect allocations, and provides an orchestrated repair flow to bridge disparities.
6. clean — Compress-Not-Delete (v1.5.3)
- Compress, never delete. Completed tasks are moved to
done.md, not removed from history. - Scans all
✅ Doneor✅ Fixedtasks inbacklog.md. - Moves them to
done.mdwith origin tags (#backlog) and timestamps. - Preserves a lookup chain:
backlog.md(active) →done.md(archive) — complete project history is always recoverable. - Recalibrates summary ratios ensuring task completion charts remain accurate.
→ Workflow /plan — Strategic planning → Learn: Hybrid 3-File Architecture