claude-prism 1.5.0 → 1.6.0-beta.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "1.5.0",
+  "version": "1.6.0-beta.1",
   "description": "AI agent harness implementing the EUDEC methodology",
   "author": { "name": "lazysaturday91" },
   "repository": "https://github.com/lazysaturday91/claude-prism",

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.6.0-beta.1] — 2026-03-04
+
+### Added
+- **Lean Router** — `rulesMode: "lean"` in `.prism/config.json` injects ~80-line behavioral modifiers instead of the full ~500-line methodology
+  - Core principle, Adaptive Weight routing, Bugfix Fast Path, Scope Guard, Verification Fallback Ladder, Self-correction triggers, Rationalization Defense, Completion Declaration
+  - Standard/Full tasks routed to `/claude-prism:prism` slash command for full EUDEC guidance
+  - Fallback: if `rules-lean.md` missing, automatically uses `rules.md`
+- `getRulesMode()` export in `lib/config.mjs`
+- 5 new lean mode tests
+
 ## [1.5.0] — 2026-03-04
 
 ### Changed

package/README.md

@@ -246,11 +246,28 @@ Edit `.prism/config.json`:
 | Setting | Default | Description |
 |---------|---------|-------------|
 | `version` | 1 | Config schema version (for future migrations) |
+| `rulesMode` | `"full"` | `"full"` injects the complete ~500-line EUDEC methodology; `"lean"` injects ~80-line behavioral modifiers and routes to `/claude-prism:prism` for full guidance |
 | `commit-guard.maxTestAge` | 300 | Seconds before test run is considered stale |
 | `plan-enforcement.warnAt` | 6 | Unique source file count that triggers plan warning |
 | `task-plan-sync.matchThreshold` | 0.3 | Keyword overlap ratio for fuzzy task matching |
 | `webhooks` | `[]` | HTTP endpoints for event notifications |
 
+### Lean Router (beta)
+
+By default, Prism injects the full EUDEC methodology (~500 lines) into `CLAUDE.md`. This provides passive absorption — the agent always has the complete framework in context.
+
+**Lean mode** injects only ~80 lines of behavioral modifiers (Scope Guard, Verification Ladder, Bugfix Fast Path, etc.) and routes Standard/Full tasks to the `/claude-prism:prism` slash command for on-demand full guidance. This saves context window for code.
+
+```bash
+# Switch to lean mode
+echo '{"version":1,"rulesMode":"lean"}' > .prism/config.json
+prism update
+
+# Switch back to full mode
+echo '{"version":1,"rulesMode":"full"}' > .prism/config.json
+prism update
+```
+
 ## CLI Commands
 
 ```bash

package/lib/config.mjs

@@ -7,6 +7,7 @@ import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
 const DEFAULTS = {
+  rulesMode: 'full',
   sourceExtensions: ['ts', 'tsx', 'js', 'jsx', 'py', 'go', 'rs', 'java', 'c', 'cpp', 'h', 'svelte', 'vue', 'rb', 'kt', 'swift', 'php', 'cs', 'scala', 'ex', 'clj', 'zig', 'lua', 'dart'],
   testPatterns: ['test', 'spec', '_test'],
   customRules: [],
@@ -70,4 +71,9 @@ export function buildTestPattern(patterns) {
   return new RegExp(`\\.(${escaped.join('|')})\\.`);
 }
 
+export function getRulesMode(projectRoot) {
+  const config = loadConfig(projectRoot);
+  return config.rulesMode === 'lean' ? 'lean' : 'full';
+}
+
 export { DEFAULTS };

package/lib/installer.mjs

@@ -8,6 +8,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { tmpdir, homedir } from 'os';
 import { detectOmc } from './omc.mjs';
+import { getRulesMode } from './config.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = join(__dirname, '..', 'templates');
@@ -371,10 +372,12 @@ export async function update(projectDir) {
     }
   }
 
-  // Migrate config: add version field if missing
+  // Migrate config: add version field if missing, preserve rulesMode
+  let preservedRulesMode;
   if (existsSync(configPath)) {
     try {
       const existingConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+      preservedRulesMode = existingConfig.rulesMode;
       if (!existingConfig.version) {
         existingConfig.version = 1;
         writeFileSync(configPath, JSON.stringify(existingConfig, null, 2) + '\n');
@@ -385,10 +388,23 @@ export async function update(projectDir) {
 
   await init(projectDir, { hooks });
 
+  // Restore rulesMode if it was set before migration
+  if (preservedRulesMode && preservedRulesMode !== 'full') {
+    const newConfig = JSON.parse(readFileSync(configPath, 'utf8'));
+    newConfig.rulesMode = preservedRulesMode;
+    writeFileSync(configPath, JSON.stringify(newConfig, null, 2) + '\n');
+    // Re-inject rules with restored mode
+    injectRules(projectDir);
+  }
+
   // Source repo: re-inject rules from local templates (overrides the npx version)
   if (sourceRepo) {
-    const localRulesPath = join(projectDir, 'templates', 'rules.md');
-    injectRules(projectDir, localRulesPath);
+    const mode = getRulesMode(projectDir);
+    const fileName = mode === 'lean' ? 'rules-lean.md' : 'rules.md';
+    const localRulesPath = join(projectDir, 'templates', fileName);
+    if (existsSync(localRulesPath)) {
+      injectRules(projectDir, localRulesPath);
+    }
   }
 
   return sourceRepo ? { sourceRepo: true } : undefined;
@@ -747,7 +763,15 @@ export function hudStatus(options = {}) {
 
 function injectRules(projectDir, overrideRulesPath) {
   const claudeMdPath = join(projectDir, 'CLAUDE.md');
-  const rulesPath = overrideRulesPath || join(TEMPLATES_DIR, 'rules.md');
+  let rulesPath;
+  if (overrideRulesPath) {
+    rulesPath = overrideRulesPath;
+  } else {
+    const mode = getRulesMode(projectDir);
+    const fileName = mode === 'lean' ? 'rules-lean.md' : 'rules.md';
+    rulesPath = join(TEMPLATES_DIR, fileName);
+    if (!existsSync(rulesPath)) rulesPath = join(TEMPLATES_DIR, 'rules.md');
+  }
   if (!existsSync(rulesPath)) return;
 
   const rules = readFileSync(rulesPath, 'utf8');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "1.5.0",
+  "version": "1.6.0-beta.1",
   "description": "AI agent harness implementing the EUDEC methodology — Essence, Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {

package/templates/rules-lean.md

@@ -0,0 +1,92 @@
+
+<!-- PRISM:START -->
+# Prism — EUDEC Methodology (Lean Mode)
+
+**EUDEC = Essence, Understand, Decompose, Execute, Checkpoint** — the core cycle.
+
+> **Never implement what you haven't understood. Never understand what you haven't distilled to its essence.**
+
+For the full methodology, run `/claude-prism:prism`.
+
+---
+
+## Adaptive Weight (Task Size Routing)
+
+| Weight | Criteria | Path |
+|--------|----------|------|
+| **Lightweight** | 1-2 files, <50 LOC, clear scope | Essence (1 line) → Execute → Verify → Done |
+| **Standard** | 3-5 files, 50-200 LOC | Run `/claude-prism:prism` for full EUDEC guidance |
+| **Full** | 6+ files, 200+ LOC, or unclear scope | Run `/claude-prism:prism` for full EUDEC with plan file |
+
+## Task Type Derivation
+
+| Essence Character | Type | Path |
+|-------------------|------|------|
+| "X is broken" | Bugfix | Fast Path (below) |
+| "X should be possible" | Feature | `/claude-prism:prism` |
+| "All X must become Y" | Migration | Pattern → batch apply → verify |
+| "X's structure must change" | Refactor | `/claude-prism:prism` |
+
+## Bugfix Fast Path
+
+1. Reproduce the symptom
+2. Trace to root cause
+3. Minimal fix (smallest change that resolves the cause)
+4. Verify (test/build/diff)
+
+After 3 failed fixes: STOP. Discuss with user.
+
+## Scope Guard
+
+**Only change what was requested. Nothing more, nothing less.**
+
+1. Was this change explicitly requested? → proceed
+2. Is it required to make the requested change work? → proceed
+3. Is it an improvement I noticed while working? → STOP. Note it, don't do it.
+4. Is it "while I'm here" cleanup? → STOP. Not your job right now.
+
+## Verification & Fallback Ladder
+
+| Level | Method | When |
+|-------|--------|------|
+| 1. Tests | Automated tests | Test infrastructure exists |
+| 2. Build | Compiles + lint without new errors | No tests for this area |
+| 3. Diff | `git diff` reviewed for regressions | No build tooling |
+
+**Every change must have SOME verification.** Never claim completion without evidence.
+
+## Self-Correction Triggers
+
+- Same file edited 3+ times → investigate root cause
+- Editing file not in plan → scope change needed?
+- 3 consecutive test failures → back to essence
+- 5 turns autonomous → report progress before continuing
+- Adding workarounds to fix workarounds → design problem, step back
+
+## Rationalization Defense
+
+| Excuse | Reality |
+|--------|---------|
+| "I know what they mean" | Verify. Assumption is the root of all bugs |
+| "While I'm here, let me also..." | Scope creep. Note it for later |
+| "Too simple to decompose" | Check file count and coupling |
+| "I'll add tests later" | High-risk: tests come first |
+
+## Checkpoint Frequency
+
+- **Lightweight**: report completion with evidence, no pause
+- **Standard/Full**: run `/claude-prism:prism` for guided checkpoints
+- **Blocker encountered**: always stop
+
+## Session Handoff
+
+When context is running low or switching tasks, create `docs/HANDOFF.md` with: Status, Current State, Next Steps, Decisions Made, Known Issues.
+
+## Completion Declaration
+
+Before declaring completion:
+1. **IDENTIFY** — What proves completion?
+2. **RUN** — Execute the relevant test/build
+3. **READ** — Check the output directly
+4. **CLAIM** — Only declare based on evidence
+<!-- PRISM:END -->