Skip to main content

Commands Overview

Pro Workflow provides 11 powerful slash commands for managing your AI coding workflow. Commands are available in Claude Code (with /pro-workflow: prefix) and Cursor (as shortcuts).

All Commands

/develop

Multi-phase feature development with Research > Plan > Implement > Review workflow

/doctor

Health check for your pro-workflow setup and configuration

/commit

Smart commit with quality gates and conventional message format

/wrap-up

End-of-session ritual with change audit and learning capture

/learn-rule

Capture corrections as persistent learning rules

/handoff

Generate session handoff document for continuity

/insights

Session analytics, correction trends, and productivity metrics

/replay

Surface past learnings relevant to current task

/search

Search learnings database with FTS5 full-text search

/list

List all stored learnings from the database

/parallel

Set up parallel worktrees for zero dead time

Command Categories

Development Workflow

Core development commands for building features:
  • /develop — Multi-phase feature builder (Research > Plan > Implement > Review)
  • /commit — Smart commit with quality gates
  • /doctor — Setup health check and diagnostics

Session Management

Commands for managing session state:
  • /wrap-up — End-of-session checklist and audit
  • /handoff — Generate handoff document for next session
  • /parallel — Set up parallel worktrees

Learning System

Commands for the self-correction loop:
  • /learn-rule — Capture correction as persistent rule
  • /replay — Surface relevant past learnings
  • /search — Full-text search of learnings
  • /list — List all learnings
  • /insights — Analytics and correction heatmaps

Usage in Different Tools

Commands use the plugin namespace:
/pro-workflow:develop add user authentication
/pro-workflow:wrap-up
/pro-workflow:doctor
After plugin install, short forms also work:
/develop add user authentication
/wrap-up
/doctor

Command Patterns

Commands That Delegate to Agents

Some commands spawn specialized agents:
  • /develop → Spawns orchestrator agent for multi-phase workflow
  • Complex commands use agent delegation for constrained execution

Commands With Arguments

/develop <feature description>    # Argument required
/search <query>                   # Argument required
/replay <task description>        # Argument optional
/commit                          # No arguments

Commands With Options

/commit --no-verify              # Skip quality gates
/commit --amend                  # Amend previous commit
/handoff --full                  # Include full context
/handoff --compact               # Minimal handoff
/insights session                # Session-specific insights
/insights learnings              # Learning patterns

Quick Reference

CommandWhen to UseOutput
/developBuilding a featureStructured workflow with phases
/doctorChecking setupHealth report with fixes
/commitCommitting changesQuality-checked commit
/wrap-upEnding sessionSession summary + learnings
/learn-ruleAfter correctionLearning saved to database
/handoffEnding sessionHandoff document
/insightsReviewing progressAnalytics and trends
/replayStarting taskRelevant past learnings
/searchFinding learningsSearch results with ranking
/listBrowsing learningsAll learnings listed
/parallelNeed parallel workWorktree setup guide

Best Practices

Before diving into a task, run /replay <task> to surface relevant learnings from past sessions. This primes Claude with context about similar work.
For features touching 3+ files, use /develop instead of implementing directly. The research phase catches edge cases before you write code.
The wrap-up ritual captures learnings and ensures clean git state. Make it habitual.
Check your setup health weekly. Catch config drift, MCP bloat, and context issues early.
When you correct Claude, immediately run /learn-rule to capture the pattern. This compounds over time.

Integration with Hooks

Commands integrate with the hook system:
  • PreToolUse hooks can suggest commands (e.g., remind about /commit before git push)
  • PostToolUse hooks can trigger commands (e.g., run /learn-rule after repeated corrections)
  • SessionEnd hooks can auto-run /wrap-up
See Hooks Overview for details.

Next Steps

Try /develop

Build your first feature with the multi-phase workflow

Command API

Learn how to create custom commands

Build docs developers (and LLMs) love