backlog-guide.md

backlog-guide.md

backlog-guide.md

Tasks live on main. Metadata, not features.

Rules

• main is source of truth: no task branches; rebase to inherit
• Updates: direct to main or in related PR
• Work pivots → update/close task; don't leave stale
• Priority: high = blocking/critical, medium = default, low = nice-to-have
• Never edit task files directly → use CLI only

Task Loop

• Mode: mvp = in-session only | backlog = full loop
• Scope grows → create task; ask if unclear

SDD → BDD → TDD → DoD (contextual)

Phase	Produces
SDD	AC: outcomes, edges, non-goals
BDD	Given/When/Then (in AC)
TDD	RED→GREEN→REFACTOR
DoD	CI green + PR ref

Lifecycle

• task → branch → PR → CI green → merge → close task

CI Stages (glossary)

Stage	Checks
Local	lint, unit
CI	unit, int, api
Staging	e2e
Release	DoD

CLI

Action	Command
Init	backlog init --defaults
List	backlog task list --plain
View	backlog task N --plain
Create	backlog task create "title" -d "desc" --priority {low|medium|high}
Update	backlog task edit N -s Done --notes "outcome"
Search	backlog search "topic" --plain

--plain: machine-readable output for agents

Commit

• Message: 📋 chore(backlog): {add|close|update} task-N
• Flow: git checkout main && git pull → CLI → git add backlog/tasks && git commit && git push

References

• For Acceptance Criteria, Definition of Done, implementation workflow, and full CLI reference: backlog/AGENTS.md