Documentation Index Fetch the complete documentation index at: https://mintlify.com/rohitg00/pro-workflow/llms.txt
Use this file to discover all available pages before exploring further.
Pro Workflow works with Cursor through the .cursor plugin system and .mdc rules. Skills, agents, and references are translated to Cursor’s format.
Plugin Manifest Location: .cursor-plugin/plugin.json{ "name" : "pro-workflow" , "version" : "2.0.0" , "description" : "Complete AI coding workflow system. Orchestration patterns, 18 hook events, 5 agents, 7 reference guides, cross-agent support, and searchable learnings." , "author" : { "name" : "Rohit Ghumare" , "url" : "https://github.com/rohitg00" }, "homepage" : "https://github.com/rohitg00/pro-workflow" , "repository" : "https://github.com/rohitg00/pro-workflow" , "license" : "MIT" , "keywords" : [ "claude-code" , "workflow" , "productivity" , "self-correction" , "worktrees" , "hooks" , "agents" , "best-practices" , "sqlite" , "fts5" , "searchable" ], "skills" : [ "./skills/" ], "agents" : [ "./agents/planner.md" , "./agents/reviewer.md" , "./agents/scout.md" , "./agents/orchestrator.md" , "./agents/debugger.md" ] }
Installation Via SkillKit
Manual Setup
From NPM
# Install SkillKit (cross-agent skill translator) npm install -g skillkit # Translate Pro Workflow to Cursor format cd your-project skillkit translate pro-workflow --agent cursor
# Clone Pro Workflow git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw # Copy rules to .cursor/ mkdir -p .cursor cp -r /tmp/pw/rules/ * .md .cursor/ # Copy skills mkdir -p .cursor/skills cp -r /tmp/pw/skills/ * .cursor/skills/ # Install database package npm install pro-workflow
# Install as project dependency npm install pro-workflow # Initialize database npx pro-workflow init
Cursor Rules (.mdc) Cursor uses .mdc (Markdown Context) files for rules. Pro Workflow provides rules in rules/.
# Pro Workflow Rules ## Self-Correction When corrected or when a mistake is made: 1. Acknowledge specifically what went wrong 2. Propose a rule: `[LEARN] Category: Rule` 3. Wait for approval before adding to LEARNED section ## Planning Use multi-step planning when: - Task touches >5 files - Architecture decisions needed - Requirements unclear ## Quality Gates Before marking complete: 1. Run lint 2. Run typecheck 3. Run tests (at least --related) 4. Check for console.log, TODOs, secrets ## Code Review Pause for review at: - Plan completion - Every 5 file edits - Before git operations - Auth/security code ## Learnings Capture learnings in this format:
Skills Translation SkillKit translates Claude Code skills to Cursor-compatible format:
Skill Translation Example
Source (Claude Code): --- name : wrap-up description : End-of-session ritual user-invocable : true allowed-tools : [ "Bash" , "Read" ] --- # Wrap-Up Run these checks: 1. git status 2. Run tests 3. Capture learnings
Translated (Cursor): # Wrap-Up Skill End-of-session ritual. ## Usage Run these checks: 1. git status 2. Run tests 3. Capture learnings ## Available in Cursor Use this skill by asking: "Run wrap-up ritual"
Agents in Cursor Cursor doesn’t have native agent support. Pro Workflow provides agent instructions as .mdc rules:
Planner Mode Add to .cursor/planner.md: # Planner Mode When asked to plan: 1. Explore code (read-only) 2. List files to change 3. Present plan for approval 4. Never edit without approval
Reviewer Mode Add to .cursor/reviewer.md: # Reviewer Mode When asked to review: 1. Check logic, edge cases, errors 2. Security audit 3. Performance analysis 4. Present findings
Database Integration The Pro Workflow database works with Cursor via Node.js scripts:
Add Learning (Cursor)
Search from Cursor
// save-learning.ts import { createStore } from 'pro-workflow' ; const store = createStore (); store . addLearning ({ project: process . env . PROJECT_NAME || 'cursor-project' , category: 'Testing' , rule: 'Run tests before committing' , mistake: 'Pushed broken code' , correction: 'Added pre-commit hook' }); store . close (); console . log ( 'Learning saved' );
Worktree Support Cursor doesn’t have native worktree support. Use git worktrees manually:
# Create worktree for feature git worktree add ../project-feature feature-branch # Open in new Cursor window cursor ../project-feature # When done, remove worktree git worktree remove ../project-feature
Hook Alternatives Cursor doesn’t support hooks like Claude Code. Use git hooks instead:
# .git/hooks/pre-commit #!/bin/bash echo "Running quality gates..." # Lint if ! npm run lint ; then echo "Lint failed. Fix errors before committing." exit 1 fi # Type check if ! npm run typecheck ; then echo "Type check failed. Fix errors before committing." exit 1 fi # Tests if ! npm test -- --changed ; then echo "Tests failed. Fix tests before committing." exit 1 fi echo "Quality gates passed."
# .git/hooks/post-commit #!/bin/bash # Track commit in database node -e " const { createStore } = require('pro-workflow'); const store = createStore(); const sessionId = 'cursor-' + Date.now(); store.updateSessionCounts(sessionId, 1, 0, 0); store.close(); " echo "Commit tracked."
Configuration Files .cursor/settings.json
package.json Scripts
{ "cursor.proWorkflow.enabled" : true , "cursor.proWorkflow.dbPath" : "~/.pro-workflow/data.db" , "cursor.proWorkflow.autoWrapUp" : false , "cursor.proWorkflow.qualityGates" : [ "lint" , "typecheck" , "test" ] }
{ "scripts" : { "pw:search" : "node scripts/search-learnings.js" , "pw:add-learning" : "node scripts/add-learning.js" , "pw:wrap-up" : "node scripts/wrap-up.js" , "pw:init" : "node -e \" require('pro-workflow').initializeDatabase(); \" " } }
Cross-Agent Workflows Use Claude Code for complex tasks, Cursor for quick edits:
Task Tool Why Planning Claude Code Native agent support Quick fixes Cursor Fast tab completions Multi-file refactor Claude Code Better orchestration Single-file edits Cursor Inline editing Code review Claude Code Reviewer agent Exploration Both Parallel sessions
Use the same .mcp.json and ~/.pro-workflow/data.db across both tools. Learnings are shared!
Feature Comparison
Claude Code vs Cursor Features
Feature Claude Code Cursor Native Agents ✅ ❌ (use rules) Skills ✅ ❌ (use rules) Hooks ✅ ❌ (use git hooks) Commands ✅ /command ⚠️ (custom scripts) Worktrees ✅ Native ⚠️ Manual MCP Servers ✅ ✅ Database API ✅ ✅ Tab Completion ❌ ✅ Inline Edit ❌ ✅ Multi-Phase Dev ✅ Native ⚠️ Manual
Next Steps
SkillKit Translate skills to any agent
Claude Code Plugin Full-featured Claude Code setup
Database API Learnings and session tracking
Cross-Agent Guide Use both tools together