evolving-lite

Evolving Lite

Claude Code that learns from you. Install once. Work normally. The system remembers what worked, learns from your corrections, and gets better every session — without you lifting a finger.

"I corrected Claude about checking tsconfig strict mode first. A week later, different project, similar type error — Claude checked strict mode before I said anything. That's when I stopped thinking of it as a plugin."

See It In Action

2 min demo: Claude recalls past decisions, learns from a correction, and applies it automatically — no prompt needed.

Audit + Prevention

Evolving Lite prevents drift in real-time. Claude Health audits your full config on demand. Together they close the loop.

	Evolving Lite	Claude Health
When	Every session (automatic)	On demand (/health)
How	Hooks, pulse checks, correction pipeline	6-layer config audit with parallel diagnostics
Catches	Drift as it happens	Existing gaps and misconfigurations

What Makes This Different

Most Claude Code tools add features. Evolving Lite adds feedback loops.

It learns from corrections. Say "No, check tsconfig first" once. The system detects the correction, stores it, and recalls it automatically when a similar situation comes up — across sessions, across projects.

It activates progressively. Session 1: safety net only. Session 3: learning kicks in. Session 10: deep memory. You're never overwhelmed, and each tier earns trust before the next one activates.

It heals itself. Every hook writes a sentinel file proving it ran. Run the health-monitor agent to check all sentinels — silent failures don't stay silent.

It gets leaner, not fatter. Old experiences decay. Stale sessions get archived. The system prunes itself so it stays fast at month 6 the same way it was at day 1.

Quick Install

# 1. Clone
git clone https://github.com/primeline-ai/evolving-lite ~/.claude-plugins/evolving-lite

# 2. Run setup (configures hook paths for your machine)
cd ~/.claude-plugins/evolving-lite && bash setup.sh

# 3. Register (add to ~/.claude/settings.json under "pluginDirectories")

{
  "pluginDirectories": [
    "~/.claude-plugins/evolving-lite"
  ]
}

# 3. Start Claude Code
claude

On first start:

Evolving Lite v1.0 | Session 1 | Tier 1 (Safety) | 20 experiences loaded
The system learns from your corrections automatically.

Requirements

• Claude Code 2.1.69+
• Python 3.10+
• Bash 3.2+ (macOS stock bash works)

What to Expect

Day 1 — You install it and work normally. Context warnings appear at 70%. Dangerous bash commands get blocked. 20 pre-warmed experiences provide Claude Code best practices from day one. You barely notice it's there.

Week 1 (Session 3+) — The learning tier activates. When you correct Claude, the system captures it. Exploration tasks start routing to cheaper models automatically. Each session ends with an auto-generated summary of what happened and what's next.

Month 1 (Session 10+) — Deep memory kicks in. While Claude thinks, the system searches your stored experiences and injects relevant solutions before you ask. Old data gets archived automatically. Knowledge survives context compaction. It feels less like a tool and more like a colleague who remembers everything.

How It Works

4 Feedback Loops

The system runs on 4 loops that operate in the background. You don't invoke them — they fire on Claude Code events (session start, tool use, prompt submit, session end).

LEARN    You correct Claude → correction stored → recalled automatically next time
CONTEXT  Budget hits 70% → warning → at 93% knowledge is saved → session continues seamlessly
HEAL     Session starts → sentinel check → broken hook? → you see a warning immediately
EVOLVE   Usage tracked → stale data archived → routes refined → system stays lean

Loop	Hooks	What changes
Learn	correction-detector, thinking-recall	Claude stops repeating your corrections
Context	context-warning, precompact-extract	You never lose knowledge to context compaction
Heal	health-sentinel, health-monitor agent	Silent hook failures get caught via sentinel checks
Evolve	usage-tracker, auto-archival	The system prunes itself and stays fast

Tiered Activation