pro-workflow

Pro Workflow

Battle-tested Claude Code workflows from power users. Self-correcting memory, parallel worktrees, wrap-up rituals, and the 80/20 AI coding ratio.

v0.1.0: Now with persistent SQLite storage and searchable learnings!

If this helps your workflow, please give it a star!

What's New in v0.1.0

• Persistent Storage: Learnings survive reboots in ~/.pro-workflow/data.db
• Full-Text Search: Find past learnings instantly with BM25-powered FTS5
• Session Analytics: Track edits, corrections, and prompts per session
• New Commands: /learn, /search, /list for database operations

The Core Idea

"80% of my code is written by AI, 20% is spent reviewing and correcting it." — Karpathy

This skill optimizes for that ratio. Every pattern reduces correction cycles.

Patterns

Pattern	What It Does
Self-Correction Loop	Claude learns from your corrections automatically
Parallel Worktrees	Zero dead time - work while Claude thinks
Wrap-Up Ritual	End sessions with intention, capture learnings
Split Memory	Modular CLAUDE.md for complex projects
80/20 Review	Batch reviews at checkpoints
Model Selection	Opus+Thinking for one-shot accuracy
Context Discipline	Manage your 200k token budget
Learning Log	Auto-document insights

Installation

One-Click Plugin Install (Recommended)

# Add marketplace
/plugin marketplace add rohitg00/pro-workflow

# Install plugin
/plugin install pro-workflow@pro-workflow

Or via CLI:

claude plugin marketplace add rohitg00/pro-workflow
claude plugin install pro-workflow@pro-workflow

Build with SQLite Support

After installation, build the TypeScript for persistent storage:

cd ~/.claude/plugins/*/pro-workflow  # Navigate to plugin directory
npm install && npm run build

This creates the SQLite database at ~/.pro-workflow/data.db.

Or load directly

claude --plugin-dir /path/to/pro-workflow

Manual Setup

git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw
cp -r /tmp/pw/templates/split-claude-md/* ./.claude/
cp -r /tmp/pw/commands/* ~/.claude/commands/
cp -r /tmp/pw/hooks/* ~/.claude/

Minimal (Just add to CLAUDE.md)

## Pro Workflow

### Self-Correction
When corrected, propose rule → add to LEARNED after approval.

### Planning
Multi-file: plan first, wait for "proceed".

### Quality
After edits: lint, typecheck, test.

### LEARNED

Commands

After plugin install, commands are namespaced:

Command	Purpose
/pro-workflow:wrap-up	End-of-session checklist
/pro-workflow:learn-rule	Extract correction to memory (file-based)
/pro-workflow:parallel	Worktree setup guide
/pro-workflow:learn	NEW Save learning to SQLite database
/pro-workflow:search	NEW Search learnings by keyword
/pro-workflow:list	NEW List all stored learnings

Database Features

Persistent Learnings

Learnings are stored in SQLite with FTS5 full-text search:

~/.pro-workflow/
└── data.db    # SQLite database with learnings and sessions

Search Examples

/search testing           # Find all testing-related learnings
/search "file paths"      # Exact phrase search
/search git commit        # Multiple terms

Learning Categories

• Navigation (file paths, finding code)
• Editing (code changes, patterns)
• Testing (test approaches)
• Git (commits, branches)
• Quality (lint, types, style)
• Context (when to clarify)
• Architecture (design decisions)
• Performance (optimization)

Hooks

Automated enforcement of workflow patterns.

Hook	When	What
PreToolUse	Before edits	Track edit count, quality gate reminders
PreToolUse	Before git commit/push	Remind about quality gates, wrap-up
PostToolUse	After code edits	Check for console.log, TODOs, secrets
PostToolUse	After tests	Suggest [LEARN] from failures
SessionStart	New session	Load learnings from database
Stop	Each response	Periodic wrap-up reminders
SessionEnd	Session close	Save session stats to database

Install Hooks

# Full setup with hooks
git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw
cp -r /tmp/pw/hooks/* ~/.claude/
cp -r /tmp/pw/scripts ~/.claude/scripts/pro-workflow/
cp -r /tmp/pw/commands/* ~/.claude/commands/

Contexts & Agents

Context	When	Behavior
dev	Building	Code first, iterate
review	PRs	Read-only, security focus
research	Exploring	Summarize, plan

Agent	Purpose
planner	Break down complex tasks
reviewer	Code review, security audit

Structure

pro-workflow/
├── .claude-plugin/
│   ├── plugin.json           # Plugin manifest
│   ├── marketplace.json      # Marketplace config
│   └── README.md
├── src/                      # TypeScript source (NEW)
│   ├── db/
│   │   ├── index.ts          # Database initialization
│   │   ├── store.ts          # Stateless store factory
│   │   └── schema.sql        # SQLite schema with FTS5
│   ├── search/
│   │   └── fts.ts            # BM25 search helpers
│   └── index.ts
├── dist/                     # Compiled JavaScript
├── skills/
│   └── pro-workflow/
│       └── SKILL.md          # Main skill
├── agents/
│   ├── planner.md
│   └── reviewer.md
├── commands/
│   ├── wrap-up.md
│   ├── learn-rule.md
│   ├── parallel.md
│   ├── learn.md              # NEW
│   ├── search.md             # NEW
│   └── list.md               # NEW
├── hooks/
│   └── hooks.json
├── scripts/                  # Hook scripts
├── contexts/
│   ├── dev.md
│   ├── review.md
│   └── research.md
├── rules/
│   └── core-rules.md
├── templates/
│   └── split-claude-md/
├── package.json              # NEW
├── tsconfig.json             # NEW
└── README.md

SkillKit - Universal AI Skills

One skill. 32+ AI coding agents. Install pro-workflow across Claude Code, Cursor, Codex, Gemini CLI, and more with SkillKit.

# Install this skill
npx skillkit install pro-workflow

# Translate to any agent format
npx skillkit translate pro-workflow --agent cursor

# Get AI-powered skill recommendations
npx skillkit primer

Why SkillKit?

• Install once, use everywhere
• 15,000+ skills in the marketplace
• Works with Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and 27+ more agents

Explore the marketplace at agenstskills.com

Philosophy

• Compound improvements - Small corrections → big gains over time
• Trust but verify - Let AI work, review at checkpoints
• Zero dead time - Parallel sessions keep momentum
• Memory is precious - Both yours and Claude's

Support

If you find this useful:

• Star this repo to help others discover it
• Check out SkillKit for more AI coding skills
• Report issues or suggest improvements

Distilled from Claude Code power users and real production use.