Pro Workflow
Persistent correction memory, research wikis, and quality gates for coding assistants that need to improve across sessions.
What does this agent do, and when should you use it?
Pro Workflow is a Claude Code workflow plugin and cross-agent skill bundle built around a SQLite store for learning rules, sessions, and wiki data. It provides 41 skills, eight specialized agents, 23 slash commands, and 37 hook scripts spanning 24 event types. Its knowledge plane creates persistent FTS5-indexed wikis with BM25 search, optional vector retrieval, a budget-capped research loop, and multi-provider deliberation. Commands, agents, and skills are layered into workflows for development, commits, session wrap-up, context management, and parallel worktrees. Claude Code has a native plugin path, while Codex, Cursor, and other listed tools use skills add to install the skill and command bundle.
/learn-rule stores a user correction as a searchable rule, while session-start.js loads learnings and registered wikis at SessionStart. /wiki init creates a wiki, /wiki page adds a page, and /wiki ask performs BM25 retrieval; prompt-submit.js injects top wiki hits during UserPromptSubmit when a prompt matches the index. Optionally, /wiki embed builds embeddings with OPENAI_API_KEY or VOYAGE_API_KEY, and /wiki hybrid combines BM25, vectors, and RRF; /wiki research runs a bounded BFS over web, arXiv, GitHub, or custom fetchers. /wiki council performs a three-phase deliberation using Anthropic, OpenAI, OpenRouter, Fireworks, or a custom endpoint and saves the transcript as a wiki page; a single provider failure does not abort the run. /develop runs Research → Plan → Implement → Review with validation gates, while smart commits, secret scanning, destructive Git guards, and PreCompact/PostCompact hooks cover commit and compaction stages.
- A Claude Code user repeatedly correcting the same testing or code-convention mistake can capture it with `/learn-rule` and have it loaded in later sessions.
- An engineer maintaining a long-running research topic can use `/wiki init`, `/wiki seed`, and `/wiki research --max-pages 5 --budget-usd 0.50` to build a searchable local knowledge base.
- A team implementing a complex feature can use `/develop` to sequence research, planning, implementation, and review behind validation gates.
- A Git user with several independent changes can use `/parallel`, `parallel-worktrees`, and `batch-orchestration` to organize concurrent worktree tasks.
- A developer who needs staged review, secret checks, and a conventional commit before pushing can use `/commit` or `/smart-commit`.
What are this agent's strengths and limitations?
- It puts learning rules, session data, and wiki indexes in one SQLite store with FTS5 retrieval across sessions.
- The knowledge plane covers manual wiki pages and queries as well as budget-bounded BFS research, optional embedding retrieval, and a shareable single-file HTML wiki viewer.
- `/develop` links research, planning, implementation, and review with validation gates, while commit, secret-scan, and compaction hooks address concrete development checkpoints.
- It has a native Claude Code path and a documented `skills add` route for Codex, Cursor, and other listed agents.
- The native plugin and many event hooks are designed around Claude Code; other agents depend on skills add writing into their native skill directories, so feature parity should be validated locally.
- The SQLite components require a build step; the documentation notes that some marketplaces skip it, requiring an npm build when `/doctor` reports `KB: missing`.
- Auto-research, embeddings, and council deliberation add network access, API credentials, and possible model costs; the research loop can cap a dollar budget, but provider pricing still determines the cost.
- The README uses differing counts in places, including 41 skills and 34 skills in its comparison table, so the installed inventory should be checked before standardizing on it.
How do you install or deploy this agent?
For native Claude Code installation:/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflow
For listed tools including Cursor, Codex, Copilot CLI, and Gemini CLI:npx skills add rohitg00/pro-workflow
Then run skills sync to register the skills with the target agent configuration. For a first check, run /doctor, then /wrap-up. Manual installation requires cloning the repository, running npm install && npm run build, and copying the skills, commands, templates, and hook configuration; Node.js and npm are therefore required.
How do you use this agent?
Start with /doctor. Use /learn-rule to retain a correction and /wrap-up at the end of a session. For a research topic, run /wiki init <slug>, /wiki page <slug> <path> --type concept, and /wiki ask "<question>" --wiki <slug>. Auto-research is opt-in: run /wiki seed <slug> "<topic>", then /wiki research <slug> --max-pages 5 --budget-usd 0.50; creating ~/.pro-workflow/STOP stops every research loop. Hybrid retrieval needs OPENAI_API_KEY or VOYAGE_API_KEY, and multi-model council runs need a supported provider credential or custom endpoint credential.
How does this agent compare with similar options?
The repository compares Pro Workflow with Superpowers, everything-claude-code (ECC), gstack, and Get Shit Done (GSD). Its table positions the project around SQLite+FTS5 self-correction memory, persistent research wikis, budget-capped research, hybrid retrieval, multi-provider deliberation, and LLM-powered hooks; it also lists different skill, agent, and command counts across the projects.