pensieve

Category: Tools & Productivity | Uploader: kingkongshot | Downloads: 0 | Version: v1.0（Latest）

Changelog: Source: GitHub https://github.com/kingkongshot/Pensieve

Directory Structure

Current level: Root

📁 .src/
- 📁 core/
  - 📄 doctor_engine.py 13.1 KB
  - 📄 pensieve_core.py 4.3 KB
  - 📄 schema.json 1.5 KB
- 📁 loop/
  - 📄 DESIGN.template.md 86 B
  - 📄 REQUIREMENTS.template.md 95 B
- 📁 references/
  - 📄 decisions.md 1.4 KB
  - 📄 directory-layout.md 2.2 KB
  - 📄 knowledge.md 1.7 KB
  - 📄 maxims.md 1.3 KB
  - 📄 pipelines.md 2.7 KB
  - 📄 shared-rules.md 1.6 KB
  - 📄 skill-lifecycle.md 3.8 KB
  - 📄 tool-boundaries.md 1.2 KB
- 📁 scripts/
  - 📄 check-frontmatter.sh 11.7 KB
  - 📄 explore-prehook.sh 3.3 KB
  - 📄 generate-user-data-graph.sh 8.4 KB
  - 📄 init-project-data.sh 3.5 KB
  - 📄 install-hooks.sh 3.8 KB
  - 📄 lib.sh 9.1 KB
  - 📄 maintain-auto-memory.sh 3.8 KB
  - 📄 maintain-project-state.sh 5.1 KB
  - 📄 pensieve-session-marker.sh 8.2 KB
  - 📄 run-doctor.sh 5.9 KB
  - 📄 run-hook.sh 1.8 KB
  - 📄 run-migrate.sh 19.2 KB
  - 📄 run-upgrade.sh 6.1 KB
  - 📄 scan-structure.sh 14.2 KB
  - 📄 sync-project-skill-graph.sh 2.1 KB
- 📁 templates/
  - 📁 knowledge/
    
    📁 taste-review/
    
    📄 content.md 5.6 KB
  - 📁 maxims/
    
    📄 eliminate-special-cases-by-redesigning-data-flow.md 1018 B
    
    📄 prefer-pragmatic-solutions-over-theoretical-completeness.md 930 B
    
    📄 preserve-user-visible-behavior-as-a-hard-rule.md 913 B
    
    📄 reduce-complexity-before-adding-branches.md 911 B
  - 📄 pipeline.run-when-committing.md 5.2 KB
  - 📄 pipeline.run-when-reviewing-code.md 5.7 KB
  - 📄 pipeline.run-when-syncing-to-main.md 4.7 KB
- 📁 tools/
  - 📄 doctor.md 1.1 KB
  - 📄 init.md 1.6 KB
  - 📄 migrate.md 931 B
  - 📄 self-improve.md 1.2 KB
  - 📄 upgrade.md 1.3 KB
- 📄 manifest.json 81 B
📁 agents/
- 📄 openai.yaml 108 B
📁 docs/
- 📄 architecture-v2.md 19.1 KB
- 📄 four-layer-memory-analysis.md 7.1 KB
- 📄 graph-detail.png 199.0 KB
- 📄 graph-overview.png 205.2 KB
- 📄 QRCode.png 343.5 KB
📄 .gitignore 147 B
📄 CHANGELOG.md 6.9 KB
📄 LICENSE 1.0 KB
📄 README.md 13.4 KB
📄 SKILL.md 1.4 KB

SKILL.md

---
name: pensieve
description: >-
  Project knowledge base and workflow router.
  knowledge/ caches previously explored file locations, module boundaries, and call chains for direct reuse;
  decisions/maxims are established architectural decisions and coding standards to follow, not re-debate;
  pipelines are reusable workflows.
  Use self-improve after completing tasks to capture new insights.
  Provides five tools: init, upgrade, migrate, doctor, and self-improve.
---

# Pensieve

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

## Routing
- Init: Initialize the current project's user data directory and populate 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: Structural migration and legacy cleanup. Tool spec: `.src/tools/migrate.md`.
- Doctor: Read-only scan of the current project's user data directory. Tool spec: `.src/tools/doctor.md`.
- Self-Improve: Extract reusable conclusions and write them to user data. Tool spec: `.src/tools/self-improve.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).

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

pensieve

Directory Structure

SKILL.md

Report

Notice