# Pensieve

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

- Skill: `kingkongshot/pensieve-2` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add kingkongshot/pensieve-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kingkongshot/pensieve-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: kingkongshot (https://skillmd.com/u/kingkongshot)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kingkongshot/pensieve-2

---


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