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