Individual skill

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

Read pinned source

Source commit 8731f61b18a65f09eb0d3cd1ffbff7650ef8df48

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 9, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 2,518
Repository last updated: May 8, 2026
License: MIT

Observed agent integration: codex

engineering Derived category
operations Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

.codex/skills/pensieve-sync-to-main/SKILL.mddoc · 4,579 bytes
.codex/skills/pensieve-sync-to-main/agents/openai.yamlasset · 220 bytes
.gitignoreasset · 204 bytes
.src/core/doctor_engine.pyruns · 16,408 bytes
.src/core/pensieve_core.pyruns · 4,400 bytes
.src/core/schema.jsonasset · 2,828 bytes
.src/loop/DESIGN.template.mddoc · 86 bytes
.src/loop/REQUIREMENTS.template.mddoc · 95 bytes
.src/manifest.jsonasset · 81 bytes
.src/references/decisions.mddoc · 1,462 bytes
.src/references/directory-layout.mddoc · 3,568 bytes
.src/references/knowledge.mddoc · 1,739 bytes
.src/references/maxims.mddoc · 1,371 bytes
.src/references/pipelines.mddoc · 2,793 bytes
.src/references/shared-rules.mddoc · 2,124 bytes
.src/references/short-term.mddoc · 1,609 bytes
.src/references/skill-lifecycle.mddoc · 3,919 bytes
.src/references/tool-boundaries.mddoc · 1,674 bytes
.src/scripts/check-frontmatter.shruns · 12,348 bytes
.src/scripts/explore-prehook.shruns · 3,282 bytes
.src/scripts/generate-user-data-graph.shruns · 10,179 bytes
.src/scripts/init-project-data.shruns · 4,863 bytes
.src/scripts/install-hooks.shruns · 3,941 bytes
.src/scripts/lib.shruns · 12,152 bytes
.src/scripts/maintain-auto-memory.shruns · 3,856 bytes
.src/scripts/maintain-project-state.shruns · 6,804 bytes
.src/scripts/pensieve-session-marker.shruns · 9,787 bytes
.src/scripts/run-doctor.shruns · 6,057 bytes
.src/scripts/run-hook.shruns · 2,309 bytes
.src/scripts/run-migrate.shruns · 20,100 bytes
.src/scripts/run-upgrade.shruns · 6,185 bytes
.src/scripts/scan-structure.shruns · 18,845 bytes
.src/scripts/sync-instructions.shruns · 6,974 bytes
.src/scripts/sync-project-skill-graph.shruns · 2,101 bytes
.src/templates/agents/pensieve-wand.mddoc · 8,129 bytes
.src/templates/knowledge/taste-review/content.mddoc · 5,732 bytes
.src/templates/maxims/eliminate-special-cases-by-redesigning-data-flow.mddoc · 1,018 bytes
.src/templates/maxims/prefer-pragmatic-solutions-over-theoretical-completeness.mddoc · 930 bytes
.src/templates/maxims/preserve-user-visible-behavior-as-a-hard-rule.mddoc · 913 bytes
.src/templates/maxims/reduce-complexity-before-adding-branches.mddoc · 911 bytes
.src/templates/pipelines/run-when-committing.mddoc · 5,593 bytes
.src/templates/pipelines/run-when-refactoring.mddoc · 4,417 bytes
.src/templates/pipelines/run-when-reviewing-code.mddoc · 5,865 bytes
.src/tools/doctor.mddoc · 1,409 bytes
.src/tools/init.mddoc · 1,750 bytes
.src/tools/migrate.mddoc · 1,133 bytes
.src/tools/refine.mddoc · 4,838 bytes
.src/tools/self-improve.mddoc · 1,800 bytes
.src/tools/sync-instructions.mddoc · 2,785 bytes
.src/tools/upgrade.mddoc · 1,310 bytes
CHANGELOG.mddoc · 6,953 bytes
LICENSEasset · 1,069 bytes
README.mddoc · 13,976 bytes
SKILL.mdcore · 1,744 bytes
SKILL.mdcore · 1,744 bytes
agents/openai.yamlasset · 108 bytes
docs/QRCode.pngasset · 351,716 bytes
docs/graph-detail.pngasset · 203,794 bytes
docs/graph-overview.pngasset · 210,135 bytes

Read excerpt


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