$ recombobulate _
home / tips / use-taskmaster-to-break-down-prds-before-writing-code
137

Use Taskmaster to Break Down PRDs Before Writing Code

recombobulate @recombobulate · Mar 25, 2026 · Workflows
use-taskmaster-to-break-down-prds-before-writing-code

Jumping straight into code from a PRD or feature spec is a great way to miss the big picture. Taskmaster turns your requirements document into a structured, prioritised task list that Claude Code can work through systematically.

Install it globally and initialise your project:

npm install -g task-master-ai
task-master init

Drop your PRD into .taskmaster/docs/prd.txt, then parse it:

task-master parse-prd .taskmaster/docs/prd.txt

Rank every task by complexity first

Before writing a single line of code, run the complexity analyser. It scores every task from 1 to 10 using AI, flags which ones need breaking down, and tells you how many subtasks each complex item should produce:

task-master analyze-complexity
task-master complexity-report

Tasks scoring above your threshold (default is 5) get flagged for expansion. You can then expand them individually or all at once:

task-master expand --id=5
task-master expand --id=5 --num=4 --prompt="Focus on error handling"
task-master expand --all

This gives you a realistic, granular task list before Claude touches any code.

Install the MCP server and skip the CLI entirely

The real power comes from running Taskmaster as an MCP server inside Claude Code. You can even ask Claude to set it up for you — just open a Claude Code session in your project and say:

"Can you please initialize taskmaster-ai into my project?"

Or add it manually in one line:

claude mcp add taskmaster-ai -- npx -y task-master-ai

Once connected, you manage everything through natural conversation. No commands to memorise:

"What's the next task I should work on?" "Break task 5 down into subtasks focused on security" "Mark task 3 as done and show me what's next" "We've switched to Postgres — update all future database tasks" "Run a complexity analysis and expand anything scoring above 7"

Use tags to switch between features cleanly

Tags give each feature branch its own independent task list. Switch tags and you switch context entirely — your task state is exactly where you left it when you come back:

task-master add-tag payments
task-master use-tag payments

Move tasks between tags if priorities shift:

task-master move --from=5 --from-tag=backlog --to-tag=payments

Parse the PRD, score the complexity, expand the hard tasks, then let Claude work through the queue — one task at a time, all in natural language.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Run Claude Code in GitHub Actions to Automatically Review Every Pull Request

Set up Claude Code as an automated reviewer in your CI pipeline — on every pull request, it reads the diff, checks for bugs, security issues, missing tests, and convention violations, then posts its findings as a PR comment. Your human reviewers get a head start because the obvious issues are already flagged before they look.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Build a Deployment Checklist from Your Actual Infrastructure

Before deploying, tell Claude to read your project — migrations, environment variables, queue workers, scheduled tasks, caching, third-party integrations — and generate a deployment checklist that's specific to your app. Not a generic "did you run migrations?" list, but one that knows YOUR infrastructure and catches the things YOUR deploy can break.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Generate a README from Your Actual Codebase — Not a Template

Instead of writing a README from memory or copying a template, tell Claude to read your project and generate one that's actually accurate — real setup instructions from your config, real architecture from your directory structure, real API examples from your routes, and real prerequisites from your dependency files.

recombobulate @recombobulate · 1 month ago