Plan Tasks from PRD Skill

Plan Tasks from PRD

Create implementation tasks from PRD documents.

Workflow

1. List available PRDs

~/.claude/skills/plan-tasks/scripts/list-prds.sh

Or manually, use Glob to check for PRDs:

Glob("dev/local/prds/wip/*.md")
Glob("dev/local/prds/backlog/*.md")

If no PRDs found, inform user and stop.

2. Select PRD

1 PRD in wip → auto-select it, don't ask
0 PRDs in wip → present backlog list, ask user to pick
2+ PRDs in wip → present list (wip + backlog), ask user to pick

3. Analyze PRD

Read the full PRD. Also load existing codebase architecture context (AGENTS.md, agent_docs/, dev/local/ architecture notes) to cross-reference. Identify reusable existing code before creating tasks.

Extract:

Capabilities and features
Module structure
Dependency graph
Implementation phases
Existing patterns/utilities that implementers should reuse

4. Create tasks

Use TaskCreate for each task. Follow these rules:

Task qualities:

Atomic: Single focused change
Self-contained: All context in description
Sequenced: Dependencies explicit
Unambiguous: No decisions left to implementer

Task description format:

{What to do}

Location: {file paths or how to find them}

Reuse: {existing patterns, utilities, or modules to build on — if any}

Details:
- {specific requirement 1}
- {specific requirement 2}

Verify: {how to confirm it's done}

5. Set dependencies

Use TaskUpdate with addBlockedBy to link dependent tasks.

Follow PRD's dependency graph:

Phase 0 tasks: no blockers
Phase 1 tasks: blocked by Phase 0
etc.

6. Report summary

Output:

Total tasks created
Execution order (phases)
Any PRD ambiguities needing clarification

Granularity Guide

| Too coarse | Properly granular | |------------|-------------------| | "Add user authentication" | "Create User model with email, passwordHash in src/models/" | | "Build the API" | "Add POST /users endpoint accepting {email, password}, return 201" | | "Handle errors" | "Add try/catch in UserService.create(), throw ServiceError on failure" |

See references/task-examples.md for more examples.

Reference Files

references/task-examples.md - Good vs bad task examples

Agent Skills: Plan Tasks from PRD

Install this agent skill to your local

Skill Files