Skip to main content
Pro Workflow ships as a native Claude Code plugin with commands, agents, skills, hooks, and reference guides.

Plugin Manifest

Location: .claude-plugin/plugin.json
{
  "name": "pro-workflow",
  "displayName": "Pro Workflow",
  "version": "1.3.0",
  "description": "Battle-tested AI coding workflows from power users. Self-correcting memory, parallel worktrees, wrap-up rituals, quality gates, and the 80/20 AI coding ratio.",
  "author": {
    "name": "Rohit Ghumare",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/rohitg00/pro-workflow",
  "repository": "https://github.com/rohitg00/pro-workflow",
  "logo": "assets/logo.svg",
  "keywords": [
    "pro-workflow",
    "self-correction",
    "quality-gates",
    "worktrees",
    "learning",
    "code-review"
  ],
  "category": "developer-tools",
  "tags": ["productivity", "workflows", "best-practices"],
  "skills": "./skills/",
  "agents": "./agents/",
  "rules": "./rules/"
}

Plugin Structure

pro-workflow/
├── .claude-plugin/
│   ├── plugin.json           # Plugin manifest
│   └── README.md             # Plugin documentation
├── agents/
│   ├── planner.md            # Read-only task planner
│   ├── reviewer.md           # Code review agent
│   ├── scout.md              # Confidence-gated exploration
│   ├── orchestrator.md       # Multi-phase development
│   └── debugger.md           # Systematic bug investigation
├── commands/
│   ├── wrap-up.md            # End-of-session ritual
│   ├── learn.md              # Best practices guide
│   ├── search.md             # Search learnings
│   ├── develop.md            # Multi-phase feature build
│   └── commit.md             # Smart commit with quality gates
├── skills/
│   ├── pro-workflow/         # Complete workflow system
│   ├── wrap-up/              # Wrap-up ritual
│   ├── orchestrate/          # Orchestration patterns
│   ├── replay-learnings/     # Surface past learnings
│   └── session-handoff/      # Session handoff
├── hooks/
│   └── hooks.json            # Pre/Post tool use hooks
├── docs/
│   ├── orchestration-patterns.md
│   ├── settings-guide.md
│   ├── cli-cheatsheet.md
│   └── context-loading.md
├── dist/                     # Compiled TypeScript
│   ├── db/
│   └── search/
└── package.json

Installation

# Install from marketplace (recommended)
claude plugin install pro-workflow

Configuration

Claude Code automatically discovers:
Commands in commands/*.md are available as /command-name.Example: commands/wrap-up.md/wrap-upView all commands:
# Type / in Claude Code to see available commands
/
Agents in agents/*.md are available via delegation.Example: agents/planner.md → “Delegate to planner agent”List agents:
claude agents list
Skills in skills/*/SKILL.md are auto-discovered.Example: skills/pro-workflow/SKILL.md/pro-workflow (if user-invocable)View skills:
# Skills load automatically when agents reference them
# Or invoke directly if user-invocable: true
/skill-name
Hooks in hooks/hooks.json are merged into Claude Code settings.Example: PreToolUse hooks fire before Edit/Write/BashView active hooks:
cat ~/.claude/settings.json | grep -A 10 hooks

Plugin-Specific Settings

CLAUDE_CODE_PRO_WORKFLOW_DB_PATH
string
default:"~/.pro-workflow/data.db"
Custom database location for learnings and sessions.
export CLAUDE_CODE_PRO_WORKFLOW_DB_PATH="/custom/path/data.db"
CLAUDE_CODE_PRO_WORKFLOW_AUTO_WRAP_UP
boolean
default:"false"
Automatically run wrap-up ritual on session end.
export CLAUDE_CODE_PRO_WORKFLOW_AUTO_WRAP_UP=true

Commands

/wrap-up

End-of-session ritual with quality checks and learning capture.

/learn

Topic-by-topic Claude Code best practices guide.

/search

Search learnings database by keyword.

/develop

Multi-phase feature development (Research → Plan → Implement).

/commit

Smart commit with quality gates and conventional messages.

/insights

Session analytics and productivity patterns.

/replay

Surface relevant past learnings for current task.

/handoff

Generate session handoff document.

Agents

planner

Tools: Read, Glob, Grep (read-only)Break down complex tasks into implementation plans. Use when task touches >5 files.

reviewer

Tools: Read, Glob, Grep, BashCode review and security audits. Use before commits or for PR reviews.

scout

Tools: Read, Glob, Grep, Bash Mode: Background, Worktree isolationConfidence-gated exploration. Scores 0-100 and gives GO/HOLD verdict.

orchestrator

Tools: Full access Model: Opus 4.6 Memory: Project-scopedMulti-phase development with Research → Plan → Implement phases.

debugger

Tools: Read, Glob, Grep, Bash Model: Opus 4.6Systematic bug investigation with hypothesis testing.

Skills

pro-workflow

Complete workflow system with 10 battle-tested patterns.

wrap-up

End-of-session ritual checklist.

orchestrate

Command > Agent > Skill orchestration.

replay-learnings

Surface relevant past learnings.

session-handoff

Generate handoff documents.

smart-commit

Quality gates before commits.

Hooks

Pro Workflow installs hooks for:

PreToolUse

  • Edit/Write: Track edit count, remind at 5/10 edits
  • git commit: Remind to run quality gates
  • git push: Remind about wrap-up

PostToolUse

  • Edit/Write (.ts/.js/.py): Check for console.log, TODOs, secrets
  • Bash (test commands): Suggest [LEARN] from failures

Session Lifecycle

  • SessionStart: Load learnings, show worktree count
  • SessionEnd: Check uncommitted changes, prompt for learnings
  • Stop: Context-aware reminders
  • ConfigChange: Detect mid-session config modifications

Database Initialization

The plugin initializes the database on first use:
# Manual initialization
node -e "require('pro-workflow').initializeDatabase(); console.log('Ready')"

# Or via npm script
npm run db:init

Upgrading

1

Pull latest changes

cd ~/.claude/plugins/marketplaces/pro-workflow
git pull origin main
2

Install dependencies

npm install
3

Rebuild

npm run build
4

Restart Claude Code

# Exit and restart Claude Code
exit
claude

Uninstalling

# Remove plugin
rm -rf ~/.claude/plugins/marketplaces/pro-workflow

# Optionally remove database
rm -rf ~/.pro-workflow
Removing ~/.pro-workflow/ deletes all learnings and session data permanently.

Next Steps

Cursor Plugin

Install for Cursor IDE

SkillKit

Cross-agent skill translation

Commands

Build custom commands

Agents

Create custom agents

Build docs developers (and LLMs) love