claude-prism 0.1.0 → 0.2.0

package/bin/cli.mjs

@@ -11,7 +11,7 @@
  *        prism update
  */
 
-import { init, check, uninstall, update, doctor, stats, reset } from '../lib/installer.mjs';
+import { init, check, uninstall, update, doctor, stats, reset, initGlobal, uninstallGlobal } from '../lib/installer.mjs';
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -37,6 +37,15 @@ const cwd = process.cwd();
 
 switch (command) {
   case 'init': {
+    if (hasFlag('global')) {
+      console.log('🌈 claude-prism init --global\n');
+      initGlobal();
+      console.log('✅ Commands installed → ~/.claude/commands/claude-prism/');
+      console.log('✅ OMC skill installed → ~/.claude/skills/prism/');
+      console.log('\n🌈 Done. /claude-prism:prism available in all projects.');
+      break;
+    }
+
     const language = getFlag('lang') || 'en';
     const hooks = !hasFlag('no-hooks');
 
@@ -117,6 +126,15 @@ switch (command) {
   }
 
   case 'uninstall': {
+    if (hasFlag('global')) {
+      console.log('🌈 claude-prism uninstall --global\n');
+      uninstallGlobal();
+      console.log('✅ Global commands removed');
+      console.log('✅ OMC skill removed');
+      console.log('\n🌈 Global prism uninstalled.');
+      break;
+    }
+
     console.log('🌈 claude-prism uninstall\n');
     uninstall(cwd);
     console.log('✅ Rules removed from CLAUDE.md');
@@ -142,16 +160,19 @@ switch (command) {
 
 Usage:
   prism init [--lang=XX] [--no-hooks]   Install prism in current project
+  prism init --global                    Install globally (~/.claude/) + OMC skill
   prism check [--ci]                     Verify installation
   prism doctor                           Diagnose issues with fix suggestions
   prism stats                            Show installation summary
   prism reset                            Clear hook state (edit counters, etc.)
   prism update                           Re-install using current config
-  prism uninstall                        Remove prism
+  prism uninstall                        Remove prism from current project
+  prism uninstall --global               Remove global commands + OMC skill
 
 Options:
   --lang=XX    Language: en (default), ko, ja, zh
   --no-hooks   Skip enforcement hooks
+  --global     Install/uninstall globally (all projects)
   --ci         Output JSON for CI integration
   --version    Show version`);
   }

package/lib/installer.mjs

@@ -6,7 +6,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, rmSync, readdirSync, renameSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { tmpdir } from 'os';
+import { tmpdir, homedir } from 'os';
 import { detectOmc } from './omc.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -372,6 +372,53 @@ export function reset() {
   return true;
 }
 
+/**
+ * Install prism globally (slash commands + OMC skill)
+ * Target: ~/.claude/commands/claude-prism/ and ~/.claude/skills/prism/
+ * @param {Object} [options]
+ * @param {string} [options.homeDir] - Override home dir (for testing)
+ */
+export function initGlobal(options = {}) {
+  const home = options.homeDir || homedir();
+  const claudeDir = join(home, '.claude');
+
+  // 1. Install slash commands globally
+  const commandsDir = join(claudeDir, 'commands', 'claude-prism');
+  mkdirSync(commandsDir, { recursive: true });
+
+  const commandFiles = ['prism.md', 'checkpoint.md', 'plan.md', 'doctor.md', 'stats.md', 'help.md'];
+  for (const cmd of commandFiles) {
+    copyFileSync(
+      join(TEMPLATES_DIR, 'commands', 'claude-prism', cmd),
+      join(commandsDir, cmd)
+    );
+  }
+
+  // 2. Install OMC skill
+  const skillDir = join(claudeDir, 'skills', 'prism');
+  mkdirSync(skillDir, { recursive: true });
+  copyFileSync(
+    join(TEMPLATES_DIR, 'skills', 'prism', 'SKILL.md'),
+    join(skillDir, 'SKILL.md')
+  );
+}
+
+/**
+ * Uninstall global prism (slash commands + OMC skill)
+ * @param {Object} [options]
+ * @param {string} [options.homeDir] - Override home dir (for testing)
+ */
+export function uninstallGlobal(options = {}) {
+  const home = options.homeDir || homedir();
+  const claudeDir = join(home, '.claude');
+
+  const commandsDir = join(claudeDir, 'commands', 'claude-prism');
+  if (existsSync(commandsDir)) rmSync(commandsDir, { recursive: true });
+
+  const skillDir = join(claudeDir, 'skills', 'prism');
+  if (existsSync(skillDir)) rmSync(skillDir, { recursive: true });
+}
+
 // ─── internal helpers ───
 
 function injectRules(projectDir, language) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI coding problem decomposition tool — Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {

package/templates/skills/prism/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: prism
+description: AI coding problem decomposition tool — UDEC methodology
+triggers:
+  - "prism"
+  - "decompose"
+  - "udec"
+argument-hint: "[task description]"
+---
+
+<Purpose>
+Prism applies the UDEC methodology (Understand, Decompose, Execute, Checkpoint) to any coding task. It prevents the biggest AI coding failure mode: building the wrong thing by skipping understanding and decomposition.
+</Purpose>
+
+<Use_When>
+- User says "prism", "decompose", or "udec"
+- Complex task requiring structured approach (3+ files, unclear scope)
+- Vague request that needs clarification before implementation
+- User wants disciplined, checkpoint-based execution
+</Use_When>
+
+<Do_Not_Use_When>
+- Single-file trivial fix (typo, one-line change)
+- User explicitly says "just do it" for a clearly defined small task
+- Pure research/analysis with no code changes needed
+</Do_Not_Use_When>
+
+<Why_This_Exists>
+AI agents optimize for speed, not correctness. Without structure, they skip understanding, skip decomposition, and run autonomously for 30 minutes producing something nobody wanted. Prism enforces the discipline that makes AI-assisted coding reliable.
+</Why_This_Exists>
+
+<Steps>
+
+## U — UNDERSTAND
+
+1. **Explore first**: Read package.json, project structure, related files before asking anything
+2. **Assess information sufficiency**:
+   - [Sufficient] Specific file, function, symptom mentioned → skip to DECOMPOSE
+   - [Partial] Direction clear but details missing → explore then ask 1-2 questions
+   - [Insufficient] Abstract, vague, multiple interpretations → must ask questions first
+3. **Check for hidden assumptions** (Red Flag Detection):
+
+   | Red Flag | Question to Ask Yourself |
+   |----------|-------------------------|
+   | "Obviously they want X" | Did they actually say X? Or is it my inference? |
+   | "Similar to Y" | What are the differences? Similar ≠ identical |
+   | "Standard approach is..." | Is this what the user wants, or my default? |
+   | "Simple fix" | Did I read surrounding code? What could break? |
+   | Request < 2 sentences | Likely missing context. Explore first. |
+   | No file/function names | [Insufficient]. Must ask. |
+   | "just", "simply" | Complexity being underestimated |
+
+4. **Question rules** (if questions needed):
+   - One question at a time
+   - Multiple choice with 2-3 options + recommendation
+   - Include reasoning based on code exploration
+   - Maximum 3 rounds of questions
+5. **Confirm alignment**: Summarize goal in one sentence, get user approval
+6. **Analysis-only requests**: If no code change is needed, report findings and ask: "Further action needed?" Do NOT proceed to D/E/C unless the user requests implementation.
+
+## D — DECOMPOSE
+
+7. **Assess complexity** (consider BOTH file count AND logic complexity):
+   - [Simple] 1-2 files, minor changes (<50 LOC) → execute directly, no decomposition needed
+   - [Medium] 3-5 files, OR 1-2 files with significant logic changes (50-150 LOC) → 2-3 batches
+   - [Complex] 6+ files, OR substantial architectural changes → 5+ batches, must create plan file
+   - [Complex system] Unclear scope → reduce scope first, then decompose
+8. **Create batches** following the 5 principles:
+   - Unit size: 2-5 minutes each (test/implement/verify as separate steps)
+   - Test first: test before implementation in each unit
+   - Independent verification: each unit has a pass criterion
+   - Files specified: list files to create/modify per unit
+   - Dependencies noted: mark if unit depends on a previous one
+9. **Save plan** to `docs/plans/YYYY-MM-DD-<topic>.md`
+10. **Get approval**: "Proceed with this plan?"
+
+## E — EXECUTE
+
+11. Execute one batch at a time (3-4 tasks per batch)
+12. Follow TDD: write failing test → implement → verify → commit
+13. **Scope Guard**: Before each change, ask: "Was this requested?" If no → don't do it
+14. **Self-correction triggers**:
+    - Same file edited 3+ times on the same region/logic → stop, investigate root cause
+    - File not in plan → pause, ask about scope change
+    - 3 consecutive test failures → stop, reconsider approach
+    - New package needed → ask user first
+    - Adding workarounds on workarounds → design problem, step back
+15. **Verification scoping**: When running build checks, filter output to only changed files.
+16. **Agent failure recovery**: If a delegated agent partially fails:
+    1. Verify actual file state (read the file, not just the agent's report)
+    2. If partially correct → complete the remaining work directly
+    3. If fully wrong → retry with clearer instructions or execute directly
+
+## C — CHECKPOINT
+
+17. After each batch, report using this format:
+
+    | Item | Before | After |
+    |------|--------|-------|
+    | [what changed] | [old behavior] | [new behavior] |
+
+18. Include: verification results, files modified, tests status
+19. Ask: "Continue to next batch?"
+20. User can redirect, adjust scope, or stop at any checkpoint
+
+## OMC Integration
+
+If oh-my-claudecode is detected in this environment:
+- Use `explore` agent for codebase exploration in the UNDERSTAND phase
+- Use `architect` agent for complex decomposition decisions
+- Use `executor` agents for parallel batch execution when tasks are independent
+- Use `verifier` agent for checkpoint verification
+
+</Steps>