notepad-system
Use this skill when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks. Provides a durable notepad that survives compaction and lets any agent pick up exactly where the previous context left off.
Profile →npx skills add vibeeval/vibecosystem --skill notepad-system --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Notepad System — Compaction-Resistant State Preservation Structured storage for decisions, task state, and critical context that must survive context window compression. Extends pre-compact-state.md from manual discipline to a concrete file-based protocol. ## The Problem When context compresses, the following is lost: - Why a specific approach was chosen over alternatives - Which files were edited and what changed - Where in a multi-step task execution was paused - Constraints and requirements the user stated earlier in the session Without this, the recovered context either restarts from scratch or makes assumptions that contradict earlier decisions. --- ## Note Types | Type | Persistence | When to Use | |------|-------------|-------------| | **Priority** | Permanent until explicitly deleted | Architectural decisions, user confirmed preferences, hard constraints | | **Working** | Session-scoped, cleared at session end | Current task state, WIP progress, in-flight findings | | **Scratch** | Cleared after use (one-time calc) | Quick calculations, temp values used once | --- ## Storage Location ``` ~/.claude/projects/<project-hash>/notepad.md ``` The project hash is derived from the
- The Problem
- Note Types
- Storage Location
- File Format
- Pre-Compact Protocol
- Post-Compact Recovery
- Note Writing Rules
- CLI Operations (manual use)
- Integration
- Example Scenarios
- Scenario 1: Mid-refactor compression
- Scenario 2: Decision under uncertainty
- Scenario 3: Hard constraint from early conversation
cat ~/.claude/projects/<hash>/notepad.md Remove the Working Notes section content, keep the headers Remove individual scratch entries after they have been applied
What does the notepad-system skill do?
Use this skill when context compression is imminent, when resuming a session, or when preserving critical decisions across long tasks. Provides a durable notepad that survives compaction and lets any agent pick up exactly where the previous context left off.
How do I install it?
Run `npx skills add vibeeval/vibecosystem --skill notepad-system --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From vibeeval/vibecosystem, a repository with 521 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.