rpm

rpm — Relentless Project Manager

A Claude Code plugin that solves the two hardest problems in LLM-assisted development: session resumption and drift.

Why

LLM sessions are stateless. Every new conversation starts cold — no memory of what you shipped yesterday, what you decided, or what's next. You waste time re-explaining context, and the AI wastes tokens rediscovering your codebase.

Meanwhile, your docs quietly rot. README instructions fall behind the code. CLAUDE.md references files that were renamed three commits ago. Nobody notices until something breaks, because nothing is watching.

rpm fixes both problems.

Session resumption: rpm tracks what happened (past), where things stand (present), and what's planned (future). Every session starts with full context — git state, open tasks, recent drift, handoff notes from the last session — and ends with a clean handoff to the next one. No re-explaining.

Drift detection: rpm audits your docs against reality. Quick scans catch broken refs and stale instructions in seconds. Deep scans find contradictions between documentation and code. Full project reviews validate against external sources.

Getting started

Two steps.

1. Install the plugin (once per machine):

/plugins marketplace add https://github.com/dppdppd/rpm
/plugins install rpm@dppdppd-plugins

Or for local development:

claude --plugin-dir /path/to/rpm

2. Run /init-rpm (once per project) inside the project you want to track:

/init-rpm

It scans the codebase, asks a few clarifying questions, scaffolds docs/rpm/ (context, trackers, backlog, past/future/reviews), and creates CLAUDE.md if one doesn't exist. Hooks activate immediately — no restart — and every session after that auto-loads context at session start.

Requirements: Claude Code CLI. No other dependencies — pure markdown and bash.

Using another agent runtime? See the opencode branch or Codex branch.

Codex quick install:

codex plugin marketplace add dppdppd/rpm@codex --enable hooks

Then add this to ~/.codex/config.toml:

[plugins."rpm@dppdppd-rpm"]
enabled = true

The current Codex CLI manages marketplaces only; plugin activation is the [plugins."rpm@dppdppd-rpm"] config entry above.

The workflow

First time: Run /init-rpm. It scans your project, asks a few questions, and scaffolds the tracking infrastructure under docs/rpm/.

Every session after that: Just start working. rpm automatically loads your project context — git state, open tasks, daily log, recent drift — and proposes a task from the backlog. You confirm and work.

Mid-session: rpm quietly captures learnings and checkpoints your progress. Use /backlog to add, list, review, or complete entries in your rpm backlog. If you run /compact, rpm saves your state before compaction and restores it after — so you pick up exactly where you left off without re-explaining anything.

End of session: Run /session-end. It auto-updates all three trackers, surfaces uncommitted work and learnings, and writes a handoff for the next session. Start a new conversation and the cycle repeats.

The result: every session starts informed and ends clean. Nothing falls through the cracks between sessions.

Commands

/init-rpm

First-run setup. Run once per project. Scans the codebase, asks 3 questions, scaffolds docs/rpm/ (trackers, daily logs, task backlog), and creates a CLAUDE.md if one doesn't exist.

/session-end

Wrap up the current session. Auto-updates past/present/future trackers, then scales the wrap-up to fit: clean sessions get a single-message Express handoff; sessions with one or two surfaces (commit, learnings, drift) get an Inline mode with one combined message and one follow-up; only genuinely complex sessions (multi-commit splits, untracked triage, mismatch) escalate to the four-phase ceremony. Encourages short focused sessions by keeping the wrap-up cost proportional to what's there.

/backlog

Manage the rpm backlog (long-term project tasks in docs/rpm/future/tasks.org — distinct from Claude's native TaskCreate list, which is session-scoped and cleared at session-end). Add entries, list them with statuses, review and reorganize, or mark them done. Also auto-triggers when you mention backlog items naturally ("add a task", "what's on my backlog").

/audit quick

Fast mechanical scan. Zero LLM tokens. Checks git state, CLAUDE.md size, broken refs, daily-log gaps, spec inventory drift. Use when you want a quick "anything broken?" check. ~5 seconds.

/audit documents