Commands Reference
Complete reference for all 45 Pivota Spec slash commands. These commands orchestrate the entire SDLC workflow from project initialization to milestone completion.
Core Workflow
/pivota_spec:new-project Initialize project: questions → research → requirements → roadmap /pivota_spec:discuss-phase [N] Capture implementation decisions before planning /pivota_spec:plan-phase [N] Research + plan + verify for a phase /pivota_spec:execute-phase <N> Execute all plans in parallel waves /pivota_spec:verify-work [N] User acceptance testing against requirements /pivota_spec:audit-milestone Verify milestone against definition of done /pivota_spec:complete-milestone Archive milestone, tag release /pivota_spec:new-milestone [name] Start next version cycle
Spec Document Generation
/pivota_spec:generate-spec-docs Generate full spec suite (PRD, FRD, TechArch, UserStories, Personas, Journeys, JTBD, StoryMap, UX-Mockup) /pivota_spec:validate-specs Validate spec documents for clarity /pivota_spec:validate-techarch Stress-test architecture across 6 dimensions /pivota_spec:validate-phase Validate phase plans before execution
Navigation & Status
/pivota_spec:progress Show current status and next steps /pivota_spec:help Show all commands /pivota_spec:stats Project statistics /pivota_spec:health System health check /pivota_spec:update Update Pivota Spec
Phase Management
/pivota_spec:add-phase Append phase to roadmap /pivota_spec:insert-phase [N] Insert urgent work between phases /pivota_spec:remove-phase [N] Remove future phase /pivota_spec:list-phase-assumptions Preview AI approach before planning /pivota_spec:plan-milestone-gaps Create phases to close audit gaps /pivota_spec:roadmapper Create or regenerate roadmap /pivota_spec:research-phase Research domain for specific phase
Session Management
/pivota_spec:pause-work Create handoff when stopping mid-phase /pivota_spec:resume-work Restore from last session
Utilities
/pivota_spec:settings Configure model profile and agents /pivota_spec:set-profile <name> Switch model profile (quality/balanced/budget) /pivota_spec:quick Execute ad-hoc task with guarantees /pivota_spec:debug [desc] Scientific debugging with persistent state /pivota_spec:add-todo [desc] Capture idea for later /pivota_spec:check-todos List pending todos /pivota_spec:note Add planning note /pivota_spec:cleanup Clean up planning artifacts /pivota_spec:autonomous Autonomous execution mode /pivota_spec:do Direct execution command /pivota_spec:add-tests Add tests for existing code
UX & Design
/pivota_spec:ui-phase Design UX for a phase /pivota_spec:ui-review 6-pillar UI audit /pivota_spec:design-ux UX design session /pivota_spec:profile-user Profile user personas /pivota_spec:map-codebase Analyze existing codebase (brownfield)