Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Pro Workflow

Stars npm License SkillKit Docs

Your Claude Code gets smarter every session.

Self-correcting memory + persistent FTS5-indexed wikis + auto-research loop, all on one SQLite store.
Correct Claude once — it never repeats the mistake. Build a wiki on a topic — it grows itself overnight.
34 skills8 agents22 commands37 hook scripts across 24 events
Works with Claude Code, Cursor, and 32+ agents via SkillKit.


The Problem

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.

The Solution

Pro Workflow puts a single SQLite store underneath every session.

  • Self-correction memory — every correction becomes a rule, FTS5-searchable, auto-loaded on session start.
  • Knowledge plane — persistent research wikis on disk + FTS5 shadow index, queryable from any session, optionally grown by an auto-research loop.
  • Quality gates — LLM-powered hooks, deterministic git/secret guards, compaction-aware state, cost tracking.

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.

Self-Correction Loop

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.

Install

/plugin marketplace add rohitg00/pro-workflow /plugin install pro-workflow@pro-workflow
Other install methods
# Cursor /add-plugin pro-workflow # Any agent via SkillKit npx skillkit install pro-workflow # Manual git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw cp -r /tmp/pw/templates/split-claude-md/* ./.claude/ # Build SQLite-backed components cd ~/.claude/plugins/*/pro-workflow && npm install && npm run build

60-second tour

# 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.


What's new in v3.3

Persistent knowledge plane on top of self-correction memory.

SkillPurpose
wiki-builderPersistent FTS5-indexed research wikis. 9 flavors: research, paper, domain, product, person, organization, project, codebase, incident. Path-traversal-guarded.
wiki-queryBM25 retrieval with snippets. ask, related, show. Auto-injects on UserPromptSubmit.
wiki-research-loopBudget-capped BFS. Pluggable source fetchers (web/arXiv/GitHub + custom). Convergence detection, kill-switch, atomic seed claim, try/finally state guards.
llm-councilProvider-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-generatorProvider-agnostic literature survey. Output target = wiki markdown page. Bibliography validation (uniqueness + section-paper refs), citation IDs aligned with sources.md rows.
wiki-viewerSingle-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.


Comparison

FeaturePro WorkflowSuperpowersECCgstackGSD
Self-correcting memory (SQLite + FTS5)YesNoNoNoNo
Persistent research wikis (FTS5)YesNoNoNoNo
Auto-research loop (budget-capped BFS)YesNoNoNoNo
Hybrid retrieval (BM25 + vector + RRF)YesNoNoNoNo
Multi-provider LLM councilYesNoNoNoNo
LLM-powered hooks (type: "prompt")YesNoNoNoNo
Permission denial analysisYesNoNoNoNo
Compaction-aware state preservationYesNoNoNoNo
Cost tracking and budget alertsYesNoNoNoNo
MCP overhead auditingYesNoNoNoNo
Cross-agent (32+ agents via SkillKit)YesNoSomeNoNo
Skills3414140+18+0
Agents8536018
Commands22360+5+57
Hook events2481800

What's inside

34 skills

Knowledge plane (new in v3.3)

SkillWhat it does
wiki-builderScaffold + register FTS5-indexed research wikis
wiki-queryBM25 retrieval, snippets, related, show
wiki-research-loopBudget-capped BFS over web/arXiv/GitHub fetchers
llm-councilProvider-agnostic 3-phase multi-LLM deliberation
survey-generatorLiterature survey artifact, output to a wiki page
wiki-viewerSingle-file HTML viewer (pages, sources, seeds, link graph, search)

Quality gates and observability

SkillWhat it does
smart-commitQuality gates, staged review, conventional commits
llm-gateAI-powered commit and secret hooks (type: "prompt")
permission-tunerAnalyze denials, generate allow/deny rules
compact-guardState preservation through compaction cycles
cost-trackerSession cost awareness with budget benchmarks
mcp-auditMCP server token-overhead analysis
token-efficiencyAnti-sycophancy + tool-call budgets + read-before-write
safe-modeGuardrails for destructive operations
insightsSession analytics, correction trends, productivity
thoroughness-scoringRate completeness of implementations
deslopRemove AI-generated code slop from a diff

Memory and learning

SkillWhat it does
pro-workflowCore 8 patterns
learn-ruleCapture corrections (now wiki-scopeable)
replay-learningsSurface past learnings for the current task
wrap-upEnd-of-session ritual
session-handoffResume documents for the next session

Orchestration and engineering loop

SkillWhat it does
orchestrateMulti-phase Research → Plan → Implement → Review
agent-teamsMulti-instance coordination, shared task list
batch-orchestrationParallel worktree agents for large changes
parallel-worktreesGit worktree setup for zero dead time
context-engineeringWrite/Select/Compress/Isolate framework
context-optimizerToken management, context budget, MCP audit
auto-setupAuto-detect project type, configure quality gates
file-watcherReactive workflows on config and dependency changes
bug-captureCapture defects as durable issues without leaking paths
module-mapOne-screen map of an unfamiliar codebase area
plan-interrogateStress-test a plan by walking its decision tree
sprint-statusTrack multi-session progress

8 agents

AgentPurpose
plannerBreak down complex tasks (read-only, approval-gated)
reviewerCode review and security audit (checklist-based)
scoutConfidence-gated exploration (background, worktree-isolated)
orchestratorMulti-phase feature development
debuggerSystematic, hypothesis-driven bug investigation
context-engineerContext-window analysis (lightweight, read-only)
permission-analystDenial-pattern analysis, rule-optimization recommendations
cost-analystToken-usage analysis, identify expensive operations

22 commands

CommandWhat it does
/wikiKnowledge-plane entry: init, page, ask, hybrid, seed, research, council, survey, embed, status
/developMulti-phase feature build with validation gates
/commitSmart commit with quality gates
/wrap-upEnd-of-session checklist and learning capture
/learn-rule / /learnExtract correction or learn Claude Code best practices
/doctorSetup health check (now includes wiki KB + council providers)
/insightsSession analytics and correction heatmap
/replaySurface past learnings for the current task
/handoffSession handoff document
/search / /listSearch and list stored learnings
/deslopRemove AI-generated code slop
/context-optimizerAudit and optimize context-window usage
/parallelSet up git worktrees for parallel sessions
/safe-modeToggle destructive-operation guardrails
/sprint-statusTrack multi-session progress
/auto-setupAuto-detect project type, configure quality gates
/compact-guardProtected compaction with state preservation
/cost-trackerTrack session costs and optimization tips
/mcp-auditAudit MCP servers for token overhead
/permission-tunerGenerate allow/deny rules from denial patterns

37 hook scripts across 24 events

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:

HookScriptEffect
SessionStartsession-start.jsLoads learnings; lists registered wikis
UserPromptSubmitprompt-submit.jsAuto-injects top-3 wiki hits when prompts match the index
Stoplearn-capture.jsAuto-captures [LEARN] blocks (now parses Wiki: <slug>)
FileChangedfile-changed.jsEdits inside a wiki tree enqueue verify-seeds
PreToolUse(Bash)commit-validate.js, git-blast-radius.js, pre-push-check.jsConventional commit + destructive op + push guardrails
PreToolUse(Write)secret-scan.jsLLM-powered secret detection
PreCompact / PostCompactpre-compact.js, post-compact.jsSave and re-inject critical context summary

9 reference guides

GuideWhat's covered
settings-guide.mdSettings keys, permission modes, hierarchy
cli-cheatsheet.mdCLI flags, keyboard shortcuts, slash commands
orchestration-patterns.mdCommand → Agent → Skill architecture, agent teams
context-engineering.mdWrite/Select/Compress/Isolate, memory taxonomy, compaction
agent-teams.mdSetup, decomposition, teams vs sub-agents
context-loading.mdCLAUDE.md loading, agent memory, skills discovery
cross-agent-workflows.mdClaude Code + Cursor together, SkillKit translation
decision-framework.mdWhen to use which pattern
daily-habits.mdSession habits, debugging tips, anti-patterns

How it works

/develop flow

Development Flow

Research before planning. Plan before implementing. Review before committing. Validation gates between every phase.

Architecture

Architecture Diagram

Command → Agent → Skill, layered over a single SQLite store. The knowledge plane (v3.3) plugs into the same store as the learning rules.

Storage

~/.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.


Patterns

PatternWhat it does
Self-Correction LoopClaude learns from corrections automatically
Knowledge PlaneWiki + auto-research loop on the same SQLite store
Multi-Phase DevResearch → Plan → Implement → Review with gates
Parallel WorktreesZero dead time with native claude -w
Wrap-Up RitualEnd sessions with intention, capture learnings
Split MemoryModular CLAUDE.md for complex projects
80/20 ReviewBatch reviews at checkpoints
Context EngineeringWrite/Select/Compress/Isolate for token management
Agent TeamsMulti-instance coordination with shared task list
Batch OrchestrationParallel worktree agents for large-scale changes
LLM GatesAI-powered verification before destructive operations
Permission TuningDenial-pattern analysis to reduce prompt fatigue
Token EfficiencyAnti-sycophancy + tool-call budgets + read-before-write
Multi-LLM CouncilProvider-agnostic 3-phase deliberation for high-stakes calls

Cross-agent support

Works across 32+ AI coding agents via SkillKit:

npx skillkit install pro-workflow npx skillkit translate pro-workflow --agent cursor npx skillkit translate pro-workflow --agent codex npx skillkit translate pro-workflow --agent gemini-cli

Supported: Claude Code, Cursor, Codex CLI, Gemini CLI, Windsurf, OpenCode, Kiro, Amp, Goose, Roo, and 27 more.


Configuration

Settings

See settings.example.json for production-ready configuration: permission rules, output style, auto-compaction, custom spinner verbs.

MCP

See mcp-config.example.json:

  • context7 — live documentation lookup
  • playwright — browser automation (most token-efficient)
  • GitHub — PRs, issues, code search

Rule: start with three MCPs, add only for concrete needs.

Knowledge plane env

EnvWhen
WIKI_ROOTOverride default ~/.pro-workflow/wikis
OPENAI_API_KEY / VOYAGE_API_KEYEnable hybrid retrieval (embeddings)
ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY / FIREWORKS_API_KEY / LLM_COUNCIL_BASE_URL+LLM_COUNCIL_API_KEYPick a council provider (first match wins)
WIKI_LOOP_BUDGET_USD / WIKI_LOOP_MAX_PAGES / WIKI_LOOP_MAX_DEPTHPer-run loop overrides
GH_TOKEN / GITHUB_TOKENLifts GitHub-fetcher rate limit

Structure

pro-workflow/ ├── skills/ # 34 skills ├── agents/ # 8 agents ├── commands/ # 22 slash commands ├── scripts/ # 37 hook scripts (24 events) ├── docs/ # 9 reference guides + index.html + infographic.html ├── rules/ # rule packs (Cursor + universal) ├── contexts/ # context modes ├── templates/ # split CLAUDE.md + AGENTS.md ├── src/ # TypeScript source (SQLite + embeddings) └── config.json

Tips from the community

"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


Philosophy

  1. Compound improvements — small corrections lead to big gains.
  2. Trust but verify — let AI work, review at checkpoints.
  3. Zero dead time — parallel sessions keep momentum.
  4. Memory is precious — both yours and Claude's.
  5. Persistent over ephemeral — if you'll need it next session, write it down on disk.
  6. Orchestrate, don't micromanage — wire patterns together, let agents execute.

Related projects

ProjectDescription
everything-claude-code140+ skills, 36 agents — the comprehensive collection
claude-code-best-practiceCurated tips, comparisons, community best practices
SkillKitUniversal CLI for managing skills across 32+ agents
awesome-claude-code-toolkit850+ files, 135 agents, 176 plugins — curated directory

Star history

Star History Chart


If pro-workflow saves you time, star the repo so others can find it.

Stars

DocumentationSkillKit MarketplaceReport IssuesReference Guides

关于 About

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.
agent-orchestrationai-agentsai-codingai-workflowclaudeclaude-codeclaude-code-pluginclaude-code-skillsclaude-skillscodexcontext-engineeringcursordeveloper-toolsgemini-clihooksproductivityself-correctionworkflowworktrees

语言 Languages

JavaScript82.8%
TypeScript17.2%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
78
Total Commits
峰值: 26次/周
Less
More

核心贡献者 Contributors