Goal
Turn a project PRD (usually .taskmaster/docs/prd.md) into a high-quality task graph using agent refinement and aoc-task add/edit.
Workflow
- •Verify PRD exists and has actionable sections (goals, stories, requirements, acceptance criteria).
- •Analyze the PRD directly for coverage, duplicates, and scope boundaries.
- •In OpenCode, fan out sub-agents by domain/epic for refinement (parallel where possible).
- •Apply task changes with
aoc-taskprimitives:- •Create:
aoc-task add "<title>" --desc "..." --details "..." --test-strategy "..." --priority <...> --tag <tag> - •Update:
aoc-task edit <id> --title "..." --desc "..." --details "..." --test-strategy "..." --tag <tag> - •Link task PRD:
aoc-task prd set <id> <path> --tag <tag> - •Manage dependencies/status/subtasks with
aoc-task edit --depends,aoc-task status,aoc-task sub ...
- •Create:
- •For explicit replace requests, remove target-tag tasks first using
aoc-task rm <id> --tag <tag>then recreate. - •Run follow-up alignment:
- •
task-breakdownfor large tasks - •
tag-alignfor tags/status/dependencies - •
prd-alignto ensure details and testStrategy match the PRD
- •
Guardrails
- •Never edit
.taskmaster/tasks/tasks.jsondirectly. - •Use a review checkpoint before destructive replacement.
- •PRD links are task-level only; subtasks must not include PRD links.
- •Keep generated tasks actionable and testable.
Notes
- •Default parse source is
.taskmaster/docs/prd.md(fallback.taskmaster/docs/prd.txt). - •Final persistence should go through
aoc-task add/editin this workflow.