Project Commands
Project commands manage the lifecycle around phases: starting and closing milestones, auditing and summarizing them, editing the roadmap, pausing and resuming sessions, and inspecting overall project health and statistics.
/pp-new-milestone
Starts a new version cycle on an existing project, updating PROJECT.md and routing into requirements gathering.
/pp-new-milestone
/pp-new-milestone "v1.1 Notifications"
/pp-new-milestone "v2.0 Payments" --reset-phase-numbers
| Flag / Argument | Behavior |
|---|---|
[name] | Optional milestone name, e.g. "v1.1 Notifications". |
--reset-phase-numbers | Restarts phase numbering at 1 rather than continuing from the previous milestone. |
/pp-milestone-summary
Produces a comprehensive milestone report suited to onboarding and review.
/pp-milestone-summary
/pp-milestone-summary v1.0
| Argument | Behavior |
|---|---|
[version] | Optional version identifier; defaults to the current or latest milestone. |
/pp-complete-milestone
Archives a finished milestone and prepares the project for its next version.
/pp-complete-milestone
/pp-audit-milestone
Checks that a milestone met its definition of done before it is archived.
/pp-audit-milestone
/pp-audit-milestone v1.2
| Argument | Behavior |
|---|---|
[version] | Optional version to audit; defaults to the current milestone. |
/pp-phase
Performs CRUD on phases in ROADMAP.md — adding, inserting, removing, or editing them.
/pp-phase "Add payment provider integration"
/pp-phase --insert 3 "Urgent security patch"
/pp-phase --remove 7
/pp-phase --edit 4
/pp-phase --edit 4 --force
| Flag / Argument | Behavior |
|---|---|
[description] | Name or goal for a phase being added. |
--insert N | Inserts an urgent phase as a decimal immediately after phase N. |
--remove N | Deletes future phase N and renumbers those that follow. |
--edit N | Updates fields on existing phase N. |
--force | Skips the confirmation prompt when editing. |
/pp-mvp-phase
Guides vertical MVP-slice planning for an existing phase.
/pp-mvp-phase 2
/pp-mvp-phase 2.1
| Argument | Behavior |
|---|---|
N | Phase number (required); supports decimals such as 2.1. |
/pp-resume-work
Restores full context from the previous session and picks work back up where it stopped.
/pp-resume-work
/pp-pause-work
Writes a complete context handoff before you end a session.
/pp-pause-work
/pp-pause-work --report
| Flag | Behavior |
|---|---|
--report | Also produces a session report summarizing what was accomplished. |
/pp-manager
Opens an interactive command center for coordinating and parallelizing work across multiple phases.
/pp-manager
/pp-manager --analyze-deps
| Flag | Behavior |
|---|---|
--analyze-deps | Runs dependency analysis and recommends an optimal execution order. |
/pp-health
Validates the integrity of the .planning/ directory and diagnoses problems.
/pp-health
/pp-health --repair
/pp-health --context
| Flag | Behavior |
|---|---|
--repair | Automatically resolves issues that are safe to fix. |
--context | Reports the current session's context utilization. |
/pp-stats
Displays a project statistics dashboard covering phases, plans, requirements, git metrics, and timeline.
/pp-stats