pensieve

name

pensieve

description

Project knowledge base and workflow router. knowledge/ caches explored file locations, module boundaries, and call chains for reuse; decisions/maxims are established architecture decisions and coding standards to follow, not relitigate; pipelines are reusable workflows; short-term/ stages new conclusions until promotion or deletion. Use self-improve after completing work to capture new insights. Provides seven tools: init, upgrade, migrate, doctor, self-improve, refine, and sync-instructions.

Pensieve

Route user requests to the correct tool. When in doubt, confirm first.

Routing

• Init: Initialize the current project user-data directory and seed files. Tool spec: .src/tools/init.md.
• Upgrade: Refresh Pensieve skill source code in the global git clone. Tool spec: .src/tools/upgrade.md.
• Migrate: Run structural migration and legacy cleanup. Tool spec: .src/tools/migrate.md.
• Doctor: Read-only scan of the current project user-data directory. Tool spec: .src/tools/doctor.md.
• Self-Improve: Extract reusable conclusions and write them into user data. Tool spec: .src/tools/self-improve.md.
• Refine: Refine the knowledge base with triage review and compression. Tool spec: .src/tools/refine.md.
• Sync Instructions: Write existing pipeline short routes into CLAUDE.md / AGENTS.md. Tool spec: .src/tools/sync-instructions.md.
• Graph View: Read <project-root>/.pensieve/.state/pensieve-user-data-graph.md.

Project Data

Project-level user data is stored in <project-root>/.pensieve/. See .pensieve/state.md for the current project's lifecycle state; see .pensieve/.state/pensieve-user-data-graph.md for the knowledge graph (read on demand).