By sfw
Adaptive Learning Memory — Claude learns from corrections to get better at your recurring tasks
Export ALM playbooks as standalone markdown for sharing, version control, or manual editing.
Hard reset for a specific task type. Deletes playbook, confidence entry, evaluations, and classifier data.
Temporarily disable ALM evaluation and playbook injection.
Analyze ALM outcomes and corrections to update playbooks and retrain classifier. Use when asked to reflect, improve, learn from past sessions, or when correction rates are high.
Nuclear option — clear all ALM learning data and start fresh. Requires explicit user confirmation.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
ALM is a Claude Code plugin that helps Claude get better at your recurring tasks over time. It silently tracks session outcomes, detects when you correct Claude, and synthesizes what it learns into actionable playbooks that get injected into future sessions.
No API calls. No external services. All data stays local in ~/.claude/alm/.
Claude starts every session from zero. If you correct the same mistake across sessions — say, Claude keeps writing verbose commit messages when you want terse ones — it has no way to remember that. ALM closes that loop:
/alm:reflect. A dedicated subagent analyzes your correction history and writes concise playbooks capturing what Claude should do differently.# Load ALM for one session (development mode)
claude --plugin-dir /path/to/alm
# ALM activates automatically — you'll see a welcome message
# Check it's working:
/alm:status
See INSTALL.md for persistent installation.
| Phase | Sessions | What Happens |
|---|---|---|
| Seed | 1 | ALM ships with curated best-practice playbooks for 8 common task types. Claude gets guidance immediately. |
| Learning | 2-14 | ALM silently evaluates each session — classifying tasks, detecting corrections, recording outcomes. You see progress messages. |
| Personalization | 15+ | Run /alm:reflect to generate playbooks derived from your actual correction patterns. Seed advice is replaced with learned strategies. |
| Precision | 30+ | The TF-IDF classifier activates, matching each prompt to the most relevant playbook. Confidence scores calibrate injection — high-confidence types are skipped (Claude already knows). |
| Command | Description |
|---|---|
/alm:status | Dashboard showing sessions tracked, confidence scores, classifier status, and stale playbook warnings |
/alm:reflect | Analyze correction patterns and generate/update personalized playbooks |
/alm:review | View recent evaluations and override misclassifications |
/alm:pause | Temporarily disable ALM evaluation and injection |
/alm:resume | Re-enable ALM after pausing |
/alm:forget <type> | Hard reset a specific task type — deletes its playbook, evaluations, and confidence data |
/alm:export | Export playbooks as standalone markdown for sharing or version control |
/alm:reset | Delete all ALM data and start fresh (requires confirmation) |
ALM works with zero configuration. To customize, create ~/.claude/alm/config.json:
{
"maxPlaybooksInjected": 3,
"confidenceThresholdForSkip": 0.90,
"dataRetentionDays": 180,
"showProgressMessages": true,
"enableProjectOverrides": true
}
All keys are optional — missing keys use defaults. See INSTALL.md for the full list.
Teams can share playbooks that override user-level playbooks for a specific project:
your-project/.claude/alm/playbooks/api-design.md
When ALM detects a project-level playbook matching the classified task type, it injects that instead of the user-level one. The session output notes [project override]. Disable with "enableProjectOverrides": false in config.
This section covers ALM's internals for contributors and technical reviewers.
npx claudepluginhub sfw/alm --plugin almSelf-improving Claude Code plugin — learns from corrections across sessions via reflexio
Self-learning system for Claude Code that captures corrections and updates CLAUDE.md automatically
Persistent memory across sessions. Learns preferences, conventions, and corrections automatically.
Local-first personal AI identity layer for MCP-compatible coding tools. Stores your lessons, decisions, playbooks, and project context as local JSON. AI proposes; high-risk items wait for your review, and everything stays visible and reversible. Local-first, no cloud, no account.
Self-evolving Claude Code system that learns from corrections, manages context, and improves every session
A continuous, zero-friction learning layer: the agent learns about you and improves its own skills across every session, and can share anonymized, provenance-verified learnings to a global pool. Inspired by Hermes Agent.