prd-next

Analyze a PRD to recommend the single highest-priority task to work on next.

Updated Nov 7, 2024
One-click install
npx skills add https://github.com/jeremysball/dotfiles --skill prd-next-jeremysball
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prd-next
Source: https://github.com/jeremysball/dotfiles/tree/main/.pi/skills-archive/prd-next
Command: npx skills add https://github.com/jeremysball/dotfiles --skill prd-next-jeremysball

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Product Requirements Document contains many phases, checkboxes, and milestones, it is hard to decide which task to tackle next. This Skill analyzes the PRD's completion state, dependencies, and strategic value to recommend the one task that should be worked on now. ## Core Features & Use Cases - Smart PRD Detection: Auto-identifies the target PRD from git branch names, recent commits, modified files, or the prds/ directory when conversation context is unclear. - Completion & Dependency Analysis: Counts checkbox states, assesses phase progress, and maps code-level and PRD-level dependencies to find critical-path items. - Execution Plan Awareness: Detects whether a milestone needs a granular execution plan and recommends running /prd-exec before starting work. - Use Case: You return to a project after a week away and ask what to work on next; the Skill reads your PRD, finds the highest-leverage unblocked task, presents its rationale, and waits for your confirmation before diving into design discussion. ## Quick Start Ask the assistant to analyze my current PRD and recommend the single highest-priority task to work on next.

Frequently Asked Questions about prd-next

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide which PRD task to work on next?▼

Run the prd-next workflow, which reads your PRD file, counts completed versus pending checkboxes, analyzes dependencies between tasks, and recommends the single highest-value unblocked task with a clear rationale.

How does PRD auto-detection work with git branches?▼

The Skill checks the current branch name for patterns like feature/prd-<id>-*, then falls back to recent commit messages and modified files in git status. If no confident match exists, it lists available PRDs from the prds/ directory for you to choose.

When should I create an execution plan before starting a task?▼

Create an execution plan when a milestone has more than three implementation steps, touches multiple files, or requires test-first breakdown. The Skill detects these conditions and recommends running /prd-exec before proceeding.

Does prd-next update the PRD file after I finish a task?▼

No, the Skill never edits PRD files directly. After implementation it instructs you to run /prd-update-progress, which handles progress tracking and commits separately to avoid conflicting updates.

What checkbox states does the PRD analysis recognize?▼

The completion assessment recognizes four states: [x] for completed, [ ] for pending, [~] for deferred, and [!] for blocked items. These counts feed into phase-level completion percentages and bottleneck identification.