OpenParable
Skip to content
← Back to skills

Pensieve

Development
pensieve

Pensieve is an Agent Skill for development published in the kingkongshot/Pensieve repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/kingkongshot/Pensieve/blob/HEAD/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pensieve, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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