Loading plugin...
Claude Code learns from your corrections: self-correcting memory that compounds over 50+ sessions. Context engineering, parallel worktrees, agent teams, and 17 battle-tested skills.
What's inside
You correct Claude the same way 50 times. You explain conventions every new session. Context compacts, learnings vanish, mistakes repeat. You research the same topic in three different sessions because there is nowhere durable for the answers to land.
Every Claude Code user hits this wall.
Pro Workflow puts a single SQLite store underneath every session.
After 50 sessions you barely correct anything. After a week of auto-research, your wiki on a topic is denser than the curated lists you started from.
Session 1: You → "Don't mock the database in tests"
Claude → Proposes rule → You approve → Saved to SQLite
Session 2: SessionStart loads all learnings + lists your wikis
UserPromptSubmit auto-injects top wiki hits when relevant
Claude writes integration tests, cites the right wiki page
Session 50: Correction rate near zero. Wiki has 200 cited claims.
Pro Workflow is published in two places: the Claude Code plugin marketplace (native), and skills add (cross-agent installer). Other agents do not have first-class plugins yet — skills add installs the skill bundle into each agent's native skill directory.
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
skills add installs the 41 skills + 23 commands into each agent's native skill directory.
npx skills add rohitg00/pro-workflow
Notes:
rohitg00/pro-workflow (the GitHub form), not the bare name — skills add resolves providers from owner/repo, not marketplace slugs.Works with these agents: cursor, codex, gemini-cli, opencode, github-copilot, droid (factory), antigravity, amp, clawdbot, cline, codebuddy, commandcode, continue, crush, goose, kilo, kiro-cli, mcpjam, mux, neovate, openhands, pi, qoder, qwen, roo, trae, universal, vercel, windsurf, zencoder.
Roster notes (2026): windsurf relaunched as Devin Desktop, which speaks the Agent Client Protocol (ACP); gemini-cli was superseded by the Antigravity CLI for consumers. The adapter names above still resolve, but target the current product. MCP works across every agent in this list with the same setup. See references/modern-workflows-2026.md for the interop picture.
After install, run skills sync to register the skills with the target agent's config.
If neither path works for your setup, clone and copy the bundle directly. Adjust the destination to your agent's skill directory (e.g. ~/.cursor/rules/, ~/.gemini/extensions/, etc.).
git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw
cd /tmp/pw && npm install && npm run build
cp -r /tmp/pw/templates/split-claude-md/* ./.claude/
cp -r /tmp/pw/skills ~/.claude/skills/
cp -r /tmp/pw/commands ~/.claude/commands/
cp /tmp/pw/hooks/hooks.json ~/.claude/hooks.json
/doctor # confirms SQLite store, hooks, skills load
/wrap-up # runs the end-of-session ritual (no-op on fresh install)
If /doctor reports KB: missing, run cd ~/.claude/plugins/*/pro-workflow && npm install && npm run build — the SQLite components need a build step a handful of marketplaces skip.
After install you have 41 skills and 23 slash commands. You don't need to memorize them; the agent picks the right skill from your prompt. The five commands below cover 80% of daily use:
| When | Command | What it does |
|---|---|---|
| Wrong correction repeats | /learn-rule | Capture the correction as a rule. Loaded on every future SessionStart. |
| End of a coding session | /wrap-up | Audit changes, persist learnings, write a handoff doc. |
| Researching a topic | /wiki init <slug> | Spin up a persistent FTS5 wiki. Auto-injected when you mention the topic later. |
| Stuck on a hard bug | /develop | Research → Plan → Implement phases with validation gates. |
| Before a PR | /smart-commit | Quality gates, staged review, conventional commit message. |
Full list: commands/ · skills/ · /list inside any session.
# 1. Self-correction (existing)
/learn-rule # capture a correction
/wrap-up # end session, persist learnings, audit changes
/insights # heatmaps, trends, productivity
# 2. Knowledge plane (v3.3, new)
/wiki init agent-memory --title "Agent Memory" --flavor research
/wiki page agent-memory wiki/concepts/episodic-memory.md --type concept
/wiki ask "what is episodic memory" --wiki agent-memory
# 3. Auto-research (budget-capped, opt-in)
/wiki seed agent-memory "memory consolidation in agents"
/wiki research agent-memory --max-pages 5 --budget-usd 0.50
# 4. Hybrid retrieval (BM25 + vector RRF, optional)
/wiki embed agent-memory # OPENAI_API_KEY or VOYAGE_API_KEY
/wiki hybrid "consolidation patterns" --wiki agent-memory
# 5. Multi-LLM deliberation (transcript persists as a wiki page)
/wiki council "should we adopt episodic memory?" --wiki agent-memory
# 6. Browse the wiki visually (single-file HTML, S3-shareable)
/wiki view agent-memory
open ~/.pro-workflow/wikis/agent-memory/derived/viewer.html
# Kill switch for any auto loop
touch ~/.pro-workflow/STOP
UserPromptSubmit auto-loads top-3 wiki hits when prompts mention indexed topics. SessionStart lists registered wikis and recent learnings.
Persistent knowledge plane on top of self-correction memory.
| Skill | Purpose |
|---|---|
| wiki-builder | Persistent FTS5-indexed research wikis. 9 flavors: research, paper, domain, product, person, organization, project, codebase, incident. Path-traversal-guarded. |
| wiki-query | BM25 retrieval with snippets. ask, related, show. Auto-injects on UserPromptSubmit. |
| wiki-research-loop | Budget-capped BFS. Pluggable source fetchers (web/arXiv/GitHub + custom). Convergence detection, kill-switch, atomic seed claim, try/finally state guards. |
| llm-council | Provider-agnostic 3-phase deliberation (Anthropic/OpenAI/OpenRouter/Fireworks/custom). Promise.allSettled so one provider failure doesn't abort the run. Transcript persists as a wiki page. |
| survey-generator | Provider-agnostic literature survey. Output target = wiki markdown page. Bibliography validation (uniqueness + section-paper refs), citation IDs aligned with sources.md rows. |
| wiki-viewer | Single-file HTML viewer for any wiki: pages + sources + seeds + link graph + in-browser search + "copy as seed" CTAs. S3-shareable. Applied lessons from Thariq Shihipar's HTML-as-output thesis. |
Plus: /wiki command (now with view), learn-rule Wiki: <slug> scoping, schema additions (wikis, wiki_pages + FTS5, wiki_sources, wiki_claims, wiki_seeds, wiki_embeddings, learnings_wiki), reactive file-watcher seed enqueue, cron-tick driver, /doctor extended with KB + provider sections.
| Feature | Pro Workflow | Superpowers | ECC | gstack | GSD |
|---|---|---|---|---|---|
| Self-correcting memory (SQLite + FTS5) | Yes | No | No | No | No |
| Persistent research wikis (FTS5) | Yes | No | No | No | No |
| Auto-research loop (budget-capped BFS) | Yes | No | No | No | No |
| Hybrid retrieval (BM25 + vector + RRF) | Yes | No | No | No | No |
| Multi-provider LLM council | Yes | No | No | No | No |
LLM-powered hooks (type: "prompt") | Yes | No | No | No | No |
| Permission denial analysis | Yes | No | No | No | No |
| Compaction-aware state preservation | Yes | No | No | No | No |
| Cost tracking and budget alerts |
Knowledge plane (new in v3.3)
| Skill | What it does |
|---|---|
| wiki-builder | Scaffold + register FTS5-indexed research wikis |
| wiki-query | BM25 retrieval, snippets, related, show |
| wiki-research-loop | Budget-capped BFS over web/arXiv/GitHub fetchers |
| llm-council | Provider-agnostic 3-phase multi-LLM deliberation |
| survey-generator | Literature survey artifact, output to a wiki page |
| wiki-viewer | Single-file HTML viewer (pages, sources, seeds, link graph, search) |
Quality gates and observability
| Skill | What it does |
|---|---|
| smart-commit | Quality gates, staged review, conventional commits |
| llm-gate | AI-powered commit and secret hooks (type: "prompt") |
| permission-tuner | Analyze denials, generate allow/deny rules |
| compact-guard | State preservation through compaction cycles |
| cost-tracker | Session cost awareness with budget benchmarks |
| mcp-audit | MCP server token-overhead analysis |
| token-efficiency | Anti-sycophancy + tool-call budgets + read-before-write |
| safe-mode | Guardrails for destructive operations |
| insights | Session analytics, correction trends, productivity |
| thoroughness-scoring | Rate completeness of implementations |
| deslop | Remove AI-generated code slop from a diff |
Memory and learning
| Skill | What it does |
|---|---|
| pro-workflow | Core 8 patterns |
| learn-rule | Capture corrections (now wiki-scopeable) |
| replay-learnings | Surface past learnings for the current task |
| wrap-up | End-of-session ritual |
| session-handoff | Resume documents for the next session |
Orchestration and engineering loop
| Skill | What it does |
|---|---|
| orchestrate | Multi-phase Research → Plan → Implement → Review |
| agent-teams | Multi-instance coordination, shared task list |
| batch-orchestration | Parallel worktree agents for large changes |
| parallel-worktrees | Git worktree setup for zero dead time |
| context-engineering | Write/Select/Compress/Isolate framework |
| context-optimizer | Token management, context budget, MCP audit |
| auto-setup | Auto-detect project type, configure quality gates |
| file-watcher | Reactive workflows on config and dependency changes |
| bug-capture | Capture defects as durable issues without leaking paths |
| module-map | One-screen map of an unfamiliar codebase area |
| plan-interrogate | Stress-test a plan by walking its decision tree |
| sprint-status | Track multi-session progress |
| Agent | Purpose |
|---|---|
| planner | Break down complex tasks (read-only, approval-gated) |
| reviewer | Code review and security audit (checklist-based) |
| scout | Confidence-gated exploration (background, worktree-isolated) |
| orchestrator | Multi-phase feature development |
| debugger | Systematic, hypothesis-driven bug investigation |
| context-engineer | Context-window analysis (lightweight, read-only) |
| permission-analyst | Denial-pattern analysis, rule-optimization recommendations |
| cost-analyst | Token-usage analysis, identify expensive operations |
| Command | What it does |
|---|---|
/wiki | Knowledge-plane entry: init, page, ask, hybrid, seed, research, council, survey, embed, status |
/develop | Multi-phase feature build with validation gates |
/commit | Smart commit with quality gates |
/wrap-up | End-of-session checklist and learning capture |
/learn-rule / /learn | Extract correction or learn Claude Code best practices |
/doctor | Setup health check (now includes wiki KB + council providers) |
/insights | Session analytics and correction heatmap |
/replay | Surface past learnings for the current task |
/handoff | Session handoff document |
/search / /list | Search and list stored learnings |
/deslop | Remove AI-generated code slop |
/context-optimizer | Audit and optimize context-window usage |
/parallel | Set up git worktrees for parallel sessions |
/safe-mode | Toggle destructive-operation guardrails |
/sprint-status | Track multi-session progress |
/auto-setup | Auto-detect project type, configure quality gates |
/compact-guard | Protected compaction with state preservation |
/cost-tracker | Track session costs and optimization tips |
/mcp-audit | Audit MCP servers for token overhead |
/permission-tuner | Generate allow/deny rules from denial patterns |
SessionStart, SessionEnd, UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact, PostCompact, SubagentStart, SubagentStop, TaskCreated, TaskCompleted, PermissionRequest, PermissionDenied, PostToolUseFailure, TeammateIdle, StopFailure, FileChanged, ConfigChange, Notification, Setup, WorktreeCreate, WorktreeRemove, CwdChanged.
Selected high-leverage hooks:
| Hook | Script | Effect |
|---|---|---|
SessionStart | session-start.js | Loads learnings; lists registered wikis |
UserPromptSubmit | prompt-submit.js | Auto-injects top-3 wiki hits when prompts match the index |
Stop | learn-capture.js | Auto-captures [LEARN] blocks (now parses Wiki: <slug>) |
FileChanged | file-changed.js | Edits inside a wiki tree enqueue verify-seeds |
PreToolUse(Bash) | commit-validate.js, git-blast-radius.js, pre-push-check.js | Conventional commit + destructive op + push guardrails |
PreToolUse(Write) | secret-scan.js | LLM-powered secret detection |
PreCompact / PostCompact | pre-compact.js, post-compact.js | Save and re-inject critical context summary |
| Guide | What's covered |
|---|---|
modern-workflows-2026.md | Multi-agent orchestration, Agent Teams, checkpoints, ACP/MCP interop, skills-commands merger |
../references/models-2026.md | Current model tiers, effort routing, task budgets |
settings-guide.md | Settings keys, permission modes, hierarchy |
cli-cheatsheet.md | CLI flags, keyboard shortcuts, slash commands |
orchestration-patterns.md | Command → Agent → Skill architecture, agent teams |
context-engineering.md | Write/Select/Compress/Isolate, memory taxonomy, compaction |
agent-teams.md | Setup, decomposition, teams vs sub-agents |
context-loading.md | CLAUDE.md loading, agent memory, skills discovery |
cross-agent-workflows.md | Claude Code + Cursor together, skills add cross-agent |
decision-framework.md | When to use which pattern |
daily-habits.md |
/develop flowResearch before planning. Plan before implementing. Review before committing. Validation gates between every phase.
Command → Agent → Skill, layered over a single SQLite store. The knowledge plane (v3.3) plugs into the same store as the learning rules.
~/.pro-workflow/
├── data.db # learnings, sessions, wikis (registry), wiki_pages (+FTS5),
│ # wiki_sources, wiki_claims, wiki_seeds, wiki_embeddings,
│ # learnings_wiki
├── wikis/<slug>/ # global-scope wikis (default location)
├── council/<session-id>/ # llm-council transcripts
├── fetchers/ # user-supplied custom source fetchers
├── tick.log # cron-driven research-tick log
└── STOP # touch this file to halt every research loop
Project-scope wikis live at <project>/.claude/wikis/<slug>/ and are committable.
| Pattern | What it does |
|---|---|
| Self-Correction Loop | Claude learns from corrections automatically |
| Knowledge Plane | Wiki + auto-research loop on the same SQLite store |
| Multi-Phase Dev | Research → Plan → Implement → Review with gates |
| Parallel Worktrees | Zero dead time with native claude -w |
| Wrap-Up Ritual | End sessions with intention, capture learnings |
| Split Memory | Modular CLAUDE.md for complex projects |
| 80/20 Review | Batch reviews at checkpoints |
| Context Engineering | Write/Select/Compress/Isolate for token management |
| Agent Teams | Multi-instance coordination with shared task list |
| Batch Orchestration | Parallel worktree agents for large-scale changes |
| LLM Gates | AI-powered verification before destructive operations |
| Permission Tuning | Denial-pattern analysis to reduce prompt fatigue |
| Token Efficiency | Anti-sycophancy + tool-call budgets + read-before-write |
| Multi-LLM Council | Provider-agnostic 3-phase deliberation for high-stakes calls |
Works across 32+ AI coding agents via skills add:
npx skills add rohitg00/pro-workflow
Supported: Claude Code, Cursor, Codex CLI, Gemini CLI, Windsurf, OpenCode, Kiro, Amp, Goose, Roo, and 27 more.
See settings.example.json for production-ready configuration: permission rules, output style, auto-compaction, custom spinner verbs.
Rule: start with three MCPs, add only for concrete needs.
| Env | When |
|---|---|
WIKI_ROOT | Override default ~/.pro-workflow/wikis |
OPENAI_API_KEY / VOYAGE_API_KEY | Enable hybrid retrieval (embeddings) |
ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY / FIREWORKS_API_KEY / LLM_COUNCIL_BASE_URL+LLM_COUNCIL_API_KEY | Pick a council provider (first match wins) |
WIKI_LOOP_BUDGET_USD / WIKI_LOOP_MAX_PAGES / WIKI_LOOP_MAX_DEPTH | Per-run loop overrides |
GH_TOKEN / GITHUB_TOKEN | Lifts GitHub-fetcher rate limit |
pro-workflow/
├── skills/ # 41 skills
├── agents/ # 8 agents
├── commands/ # 23 slash commands
├── scripts/ # 37 hook scripts (24 events)
├── references/ # workflow, model, and skill reference guides
├── docs/ # GitHub Pages infographic
├── rules/ # rule packs (Cursor + universal)
├── contexts/ # context modes
├── templates/ # split CLAUDE.md + AGENTS.md
├── src/ # TypeScript source (SQLite + embeddings)
└── config.json
"80% of my code is written by AI, 20% is spent reviewing and correcting it." — Andrej Karpathy
"Use subagents to throw more compute at a problem — offload tasks to keep your main context clean." — Boris Cherny
"If you do something more than once a day, turn it into a skill or command." — Boris Cherny
"Write detailed specs and reduce ambiguity before handing work off." — Boris Cherny
"Skill description field is a trigger, not a summary — write it for the model." — Thariq Shihipar
| Project | Description |
|---|---|
| everything-claude-code | 140+ skills, 36 agents — the comprehensive collection |
| claude-code-best-practice | Curated tips, comparisons, community best practices |
| skills | Registry and CLI to add skills across 32+ agents |
| awesome-claude-code-toolkit | 850+ files, 135 agents, 176 plugins — curated directory |
.claude-plugin/
marketplace.json
plugin.json
README.md
settings.json
.cursor-plugin/
plugin.json
.gitattributes
.github/
dependabot.yml
FUNDING.yml
workflows/
ci.yml
npm-publish.yml
release.yml
.gitignore
agents/
context-engineer.md
cost-analyst.md
debugger.md
orchestrator.md
permission-analyst.md
planner.md
reviewer.md
scout.md
assets/
architecture.svg
banner.svg
logo.svg
self-correction-demo.svg
terminal-demo.svg
workflow-flow.svg
commands/
auto-setup.md
commit.md
compact-guard.md
context-optimizer.md
cost-tracker.md
deslop.md
develop.md
doctor.md
handoff.md
insights.md
learn-rule.md
learn.md
list.md
mcp-audit.md
parallel.md
permission-tuner.md
replay.md
safe-mode.md
search.md
skill-optimize.md
sprint-status.md
wiki.md
wrap-up.md
config.json
contexts/
dev.md
research.md
review.md
docs/
index.html
infographic.html
hooks/
hooks.json
mcp-config.example.json
package-lock.json
package.json
README.md
references/
agent-teams.md
claude-code-resources.md
cli-cheatsheet.md
context-engineering.md
context-loading.md
cross-agent-workflows.md
daily-habits.md
decision-framework.md
models-2026.md
modern-workflows-2026.md
new-features.md
orchestration-patterns.md
settings-guide.md
rules/
atomic-commits.mdc
communication-style.mdc
context-discipline.mdc
core-rules.md
incremental-verify.mdc
module-shape.mdc
no-debug-statements.mdc
pre-flight-discipline.mdc
quality-gates.mdc
self-correction.mdc
skill-conventions.mdc
token-efficiency.mdc
scripts/
commit-validate.js
config-watcher.js
cwd-changed.js
drift-detector.js
embed-wiki.js
file-changed.js
git-blast-radius.js
learn-capture.js
notification-handler.js
optimize-skill.js
permission-denied.js
permission-request.js
post-compact.js
post-edit-check.js
pre-commit-check.js
pre-compact.js
pre-push-check.js
prompt-submit.js
quality-gate.js
read-before-write.js
reread-tracker.js
research-tick.js
secret-scan.js
session-check.js
session-end.js
session-start.js
setup-hook.js
stop-failure.js
subagent-start.js
subagent-stop.js
task-completed.js
task-created.js
teammate-idle.js
test-failure-check.js
tool-call-budget.js
tool-failure.js
worktree-create.js
worktree-remove.js
settings.example.json
skills/
agent-teams/
SKILL.md
auto-setup/
SKILL.md
batch-orchestration/
SKILL.md
bug-capture/
SKILL.md
compact-guard/
SKILL.md
context-engineering/
SKILL.md
context-optimizer/
SKILL.md
cost-tracker/
SKILL.md
design-engineering/
SKILL.md
deslop/
SKILL.md
domain-modeling/
SKILL.md
file-watcher/
SKILL.md
improve-architecture/
SKILL.md
insights/
SKILL.md
learn-rule/
SKILL.md
llm-council/
scripts/
council.js
SKILL.md
llm-gate/
SKILL.md
mcp-audit/
SKILL.md
module-map/
SKILL.md
orchestrate/
SKILL.md
parallel-worktrees/
SKILL.md
permission-tuner/
SKILL.md
plan-interrogate/
SKILL.md
pro-workflow/
SKILL.md
replay-learnings/
SKILL.md
safe-mode/
SKILL.md
session-handoff/
SKILL.md
skill-optimizer/
SKILL.md
skill-router/
SKILL.md
smart-commit/
SKILL.md
sprint-status/
SKILL.md
survey-generator/
scripts/
build-survey.js
SKILL.md
templates/
research_bundle.template.json
tdd/
SKILL.md
thoroughness-scoring/
SKILL.md
token-efficiency/
SKILL.md
wiki-builder/
agents/
openai.yaml
references/
wiki-flavors.md
scripts/
init_wiki.sh
wiki-cli.js
SKILL.md
templates/
index.md
maintenance-log.md
prompts/
compile-concept-page.md
compile-index.md
compile-source-page.md
lint-wiki.md
query-and-file.md
sources.md
wiki.config.md
wiki-query/
scripts/
query.js
SKILL.md
wiki-research-loop/
scripts/
research-loop.js
source-fetchers/
arxiv.js
github.js
web.js
SKILL.md
wiki-viewer/
scripts/
render.js
SKILL.md
wrap-up/
SKILL.md
writing-guidelines/
SKILL.md
src/
db/
index.ts
schema.sql
store.ts
index.ts
optimizer/
__tests__/
apply.test.ts
aggregate.ts
apply.ts
clip.ts
hash.ts
llm.ts
parse.ts
reflect.ts
slow.ts
store.ts
trainer.ts
types.ts
validate.ts
search/
embeddings.ts
fts.ts
templates/
AGENTS.md
split-claude-md/
AGENTS.md
CLAUDE.md
COMMANDS.md
LEARNED.md
SOUL.md
VOICE.md
tsconfig.json© 2026 Flowy · Free and open source
Built for Claude Code · Not affiliated with Anthropic
| Yes |
| No |
| No |
| No |
| No |
| MCP overhead auditing | Yes | No | No | No | No |
| Cross-agent (32+ agents via skills add) | Yes | No | Some | No | No |
| Skills | 34 | 14 | 140+ | 18+ | 0 |
| Agents | 8 | 5 | 36 | 0 | 18 |
| Commands | 22 | 3 | 60+ | 5+ | 57 |
| Hook events | 24 | 8 | 18 | 0 | 0 |
| Session habits, debugging tips, anti-patterns |
new-features.md | Checkpoints, remote sessions, agent and prompt hooks |
claude-code-resources.md | Official docs map and resource index |