claude-project-manager

cpr — Claude Project Manager

Session management and project memory for multi-session Claude Code projects.

Replaces ad-hoc docs/ folders with a structured .memory/ system modeled after Claude's auto-memory format: a concise MEMORY.md index loaded every session, plus on-demand topic files with frontmatter.

Skills

Skill	When to use
/init	Start a new project or workspace
/start	Begin a session — loads memory, presents state, asks what to work on
/end	Finish a session — persists state, decisions, lessons, appends to log
/memory	Record something mid-session without running a full /end
/research	Conduct and document research on a topic

Modes

Project mode

For focused work with a clear scope, spec, and phased plan.

.memory/
├── MEMORY.md        ← index (@-imported in CLAUDE.md, always loaded)
├── status.md        ← current state snapshot (<50 lines)
├── spec.md          ← high-level project goal
├── plan.md          ← phases and open questions
├── decisions.md     ← architecture decision records (ADRs)
├── lessons.md       ← workflow friction and process lessons
├── tools.md         ← CLI quirks, missing tools, flag traps
├── diary.md         ← append-only session journal (not in index)
└── features/
    └── <feature>/
        ├── spec.md
        ├── plan.md
        └── decisions.md

research/
├── <topic>.md
└── <feature>/
    └── <topic>.md

Workspace mode

For environments where tasks are largely independent.

.memory/
├── MEMORY.md        ← index (@-imported in CLAUDE.md, always loaded)
├── status.md        ← active tasks overview (<50 lines)
├── lessons.md       ← cross-task workflow lessons only
├── tools.md         ← cross-task tool knowledge only
├── diary.md         ← append-only session journal (not in index)
└── tasks/
    ├── <task>.md    ← small task: inline spec + plan
    └── <task>/      ← larger task: own directory
        ├── spec.md
        ├── plan.md
        └── decisions.md

research/
└── <task>/
    └── <topic>.md

In workspace mode, root-level lessons.md and tools.md hold cross-task knowledge only. Task-specific learnings go inside the task file or task directory.

Memory file semantics

File	Purpose
status.md	Always-loaded snapshot: phase/tasks, blockers, next priorities
spec.md	High-level goal of the project or feature/task
plan.md	Phases and open questions
decisions.md	Architecture Decision Records
lessons.md	Workflow friction — what slowed sessions down (not technical decisions, not tool quirks)
tools.md	CLI syntax gotchas, missing tools and alternatives, flag traps
diary.md	Append-only session journal — audit trail, not working context

Installation

Option 1: Claude Code plugin system (recommended)

Installs as a full plugin. Skills are available as /init, /start, /end, /memory, /research.

/plugin marketplace add torarnv/claude-project-manager
/plugin install cpr@claude-project-manager
/reload-plugins

Or declaratively in ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "claude-project-manager": {
      "source": { "source": "github", "repo": "torarnv/claude-project-manager" }
    }
  },
  "enabledPlugins": {
    "cpr@claude-project-manager": true
  }
}

To uninstall: /plugin uninstall cpr@claude-project-manager

Option 2: skills.sh

Installs only the SKILL.md files — no plugin config, but works across agents (Claude Code, Codex, Gemini CLI, Cursor, etc.).

npx skills add torarnv/claude-project-manager --all