Skip to content

ClaudePM v4.0.0

Latest
Latest

Choose a tag to compare

View all tags
@Dammyjay93 Dammyjay93 released this 15 Mar 14:50
· 1 commit to main since this release
v4.0.0
a1be570

Changes

Added

  • Tracker-agnostic task tracking: supports local markdown (default), Linear, GitHub Issues, and external trackers. Set once during setup, all commands adapt automatically.
  • Auto-detection: SessionStart hook matches working directory to project repository paths. No manual switching needed for most projects.
  • First-run setup flow: guided setup that creates the vault, asks about tracker preference, and sets up the first project interactively.
  • Emergency session save: Stop hook detects unsaved work and writes a session stub with git diff when a session ends without /claudepm save.
  • Stale session warning: SessionStart hook warns when the last session was more than 14 days ago.
  • Untracked directory detection: hook notices when you're in a git repo not tracked by ClaudePM and offers to add it.
  • SKILL.md knowledge base: auto-activating skill that teaches decision routing, audit gates, tracker modes, spec tiers, and drift detection.
  • /claudepm help command: contextual help for all concepts (tracker, specs, decisions, audit, drift, vault, memory).
  • /claudepm archive action: archives old sessions and projects, prunes manifest to last 15 entries.
  • Audit gate marker files: .claudepm/.audit-gates persists audit gate completion across context compaction.
  • Configurable vault path: set $CLAUDEPM_VAULT environment variable to use any directory. Default: ~/.claudepm/.
  • Plugin hooks.json: hooks are now self-contained in the plugin, no longer require global settings.json configuration.
  • MEMORY.md boundary documentation: clear guidance on what goes in ClaudePM vs Claude's built-in memory.

Changed

  • BREAKING: Vault default location changed from ~/Vault/ to ~/.claudepm/. Set CLAUDEPM_VAULT=~/Vault to keep using existing vault.
  • BREAKING: Removed /claudepm:setup, /claudepm:start, /claudepm:done, /claudepm:status, /claudepm:switch commands. Functionality consolidated into /claudepm dispatcher and /claudepm save.
  • All commands are now tracker-aware. Linear MCP tools are only called when tracker is set to linear.
  • Save command creates tracker-specific session file sections.
  • Plan command creates tasks in the configured tracker (local table, Linear issues, GitHub issues, or listed for external).
  • Handoff command includes remaining tasks from the configured tracker.
  • Session file naming changed to {YYYY-MM-DD}-{project}.md (includes project name).
  • Manifest schema updated to version 4 with tracker field in frontmatter.
  • README rewritten for plain, clear communication.

Removed

  • Capability matrix as primary planning tool (replaced by spec-first workflow in v3)
  • docs/ directory (PLANNING.md, SETUP.md, COMMANDS.md, FUTURE.md) — outdated v2/v3 documentation
  • Hard dependency on Obsidian and Linear

Installation

/plugin marketplace add Dammyjay93/claudepm
/plugin install claudepm

Updating

/plugin marketplace update claudepm-marketplace

Restart Claude Code after updating.

Assets 2
Loading