Manage QualCoder v2 tasks using the backlog.md CLI tool. Create, edit, and refine tasks following DDD architecture and agent-first conventions. **Invoke when:** - Creating new tasks or features for QualCoder v2 - Breaking down features by DDD layer (Domain → Infrastructure → Application → Presentation) - Editing or refining existing tasks - Managing task status and priorities **Provides:** - CLI commands for task management - DDD-aware task structure (by bounded context and layer) - Agent-first task conventions (MCP tool schemas alongside domain) - QualCoder-specific labels and bounded contexts
Manage QualCoder v2 tasks using the backlog CLI tool. Tasks follow DDD architecture with agent-first design.
task_prefix: qc # Tasks are qc-001, qc-002, etc.
zero_padded_ids: 3 # qc-001, not qc-1
# List all tasks
backlog task list --plain
# Create a task (always include layer and bounded context)
backlog task create "Coding Domain" -d "Define domain entities" -l domain,coding,P0
# View task details
backlog task qc-004 --plain
# Edit task status
backlog task edit qc-004 -s "In Progress"
# Create subtask
backlog task create -p qc-004 "Unit Tests"
backlog/
├── config.yml # Project config (labels, bounded contexts)
├── milestones/ # Epics by bounded context (m-001, m-002...)
│ ├── m-001 - Foundation.md
│ ├── m-002 - Coding-Context.md
│ ├── m-003 - Source-Management.md
│ └── ...
├── tasks/ # Tasks (qc-NNN - Title.md)
├── completed/ # Archived completed tasks
└── decisions/ # Architecture Decision Records
QualCoder v2 is organized into bounded contexts. Always tag tasks with the appropriate context:
| Context | Label | Description |
|---|---|---|
| Coding | coding | Core: applying codes to text/image/AV/PDF segments |
| Sources | sources | File import and media management |
| Cases | cases | Participant/case groupings and attributes |
| Journals | journals | Research memos, field notes, reflections |
| Analysis | analysis | Reports, visualizations, exports |
| AI Assistant | ai-assistant | AI chat, semantic search, code suggestions |
| Collaboration | collaboration | Multi-coder workflows, inter-rater reliability |
| Projects | projects | Project-level operations |
Tasks are organized by DDD layer. Create tasks in dependency order:
| Layer | Label | Depends On | Contains |
|---|---|---|---|
| Domain | domain | Shared types | Entities, events, invariants, derivers, agent schemas |
| Infrastructure | infrastructure | Domain | Repositories, persistence, external services |
| Application | application | Infrastructure | Use cases, command handlers |
| Presentation | presentation | Application | PyQt6 widgets, screens |
| Design System | design-system | — | Tokens, components, patterns |
Task creation order per bounded context:
qc-XXX Domain (entities, events, derivers, agent tool schemas)qc-XXX Infrastructure (repositories, persistence)qc-XXX Application (use cases)qc-XXX Presentation (UI widgets)IMPORTANT: MCP tool schemas are defined alongside domain entities, not as an afterthought.
Every domain task should include:
# Domain task includes agent schemas
src/domain/coding/entities.py # Entities
src/agent_context/schemas/coding_tools.py # Agent tools for this context
| Action | Command |
|---|---|
| Create task | backlog task create "Title" -d "Desc" -l domain,coding,P0 |
| Create subtask | backlog task create -p qc-004 "Subtask title" |
| List tasks | backlog task list --plain |
| List by status | backlog task list -s "In Progress" --plain |
| List by label | backlog task list -l coding --plain |
| View task | backlog task qc-004 --plain |
| Edit status | backlog task edit qc-004 -s "Done" |
| Add label | backlog task edit qc-004 -l agent-tools |
| Archive | backlog task archive qc-004 |
Always use --plain flag for AI-friendly output.
domain, application, infrastructure, presentation, design-system
coding, sources, cases, journals, analysis, ai-assistant, collaboration, projects
text-coding, image-coding, av-coding, pdf-coding
feature, enhancement, bug, refactor, documentation, testing, security
agent-tools, agent-ui, trust-level
P0 (critical), P1 (high), P2 (medium), P3 (low)
---