oh-my-claude-sisyphus 3.1.0 → 3.2.0

package/dist/utils/__tests__/paths.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { toForwardSlash, toShellPath, getDataDir, getConfigDir } from '../paths.js';
+describe('cross-platform path utilities', () => {
+    describe('toForwardSlash', () => {
+        it('should convert backslashes to forward slashes', () => {
+            expect(toForwardSlash('C:\\Users\\test\\.claude')).toBe('C:/Users/test/.claude');
+        });
+        it('should leave forward slashes unchanged', () => {
+            expect(toForwardSlash('/home/user/.claude')).toBe('/home/user/.claude');
+        });
+        it('should handle mixed slashes', () => {
+            expect(toForwardSlash('C:\\Users/test\\.claude')).toBe('C:/Users/test/.claude');
+        });
+        it('should handle empty string', () => {
+            expect(toForwardSlash('')).toBe('');
+        });
+        it('should handle UNC paths', () => {
+            expect(toForwardSlash('\\\\server\\share\\path')).toBe('//server/share/path');
+        });
+    });
+    describe('toShellPath', () => {
+        it('should convert backslashes to forward slashes', () => {
+            expect(toShellPath('C:\\Users\\test')).toBe('C:/Users/test');
+        });
+        it('should quote paths with spaces', () => {
+            expect(toShellPath('/path/with spaces/file')).toBe('"/path/with spaces/file"');
+        });
+        it('should quote Windows paths with spaces', () => {
+            expect(toShellPath('C:\\Program Files\\app')).toBe('"C:/Program Files/app"');
+        });
+        it('should not quote paths without spaces', () => {
+            expect(toShellPath('/simple/path')).toBe('/simple/path');
+        });
+        it('should handle empty string', () => {
+            expect(toShellPath('')).toBe('');
+        });
+    });
+    describe('getDataDir', () => {
+        const originalPlatform = process.platform;
+        const originalEnv = { ...process.env };
+        afterEach(() => {
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            process.env = { ...originalEnv };
+        });
+        it('should use LOCALAPPDATA on Windows when set', () => {
+            Object.defineProperty(process, 'platform', { value: 'win32' });
+            process.env.LOCALAPPDATA = 'C:\\Users\\Test\\AppData\\Local';
+            expect(getDataDir()).toBe('C:\\Users\\Test\\AppData\\Local');
+        });
+        it('should use XDG_DATA_HOME on Unix when set', () => {
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+            process.env.XDG_DATA_HOME = '/custom/data';
+            expect(getDataDir()).toBe('/custom/data');
+        });
+        it('should fall back to .local/share on Unix when XDG not set', () => {
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+            delete process.env.XDG_DATA_HOME;
+            const result = getDataDir();
+            expect(result).toContain('.local');
+            expect(result).toContain('share');
+        });
+    });
+    describe('getConfigDir', () => {
+        const originalPlatform = process.platform;
+        const originalEnv = { ...process.env };
+        afterEach(() => {
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+            process.env = { ...originalEnv };
+        });
+        it('should use APPDATA on Windows when set', () => {
+            Object.defineProperty(process, 'platform', { value: 'win32' });
+            process.env.APPDATA = 'C:\\Users\\Test\\AppData\\Roaming';
+            expect(getConfigDir()).toBe('C:\\Users\\Test\\AppData\\Roaming');
+        });
+        it('should use XDG_CONFIG_HOME on Unix when set', () => {
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+            process.env.XDG_CONFIG_HOME = '/custom/config';
+            expect(getConfigDir()).toBe('/custom/config');
+        });
+        it('should fall back to .config on Unix when XDG not set', () => {
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+            delete process.env.XDG_CONFIG_HOME;
+            const result = getConfigDir();
+            expect(result).toContain('.config');
+        });
+    });
+});
+//# sourceMappingURL=paths.test.js.map

package/dist/utils/__tests__/paths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/paths.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YACjC,MAAM,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEvC,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,iCAAiC,CAAC;YAC7D,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,cAAc,CAAC;YAC3C,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YACjC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEvC,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,mCAAmC,CAAC;YAC1D,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,gBAAgB,CAAC;YAC/C,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YACnC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cross-Platform Path Utilities
+ *
+ * Provides utility functions for handling paths across Windows, macOS, and Linux.
+ * These utilities ensure paths in configuration files use forward slashes
+ * (which work universally) and handle platform-specific directory conventions.
+ */
+/**
+ * Convert a path to use forward slashes (for JSON/config files)
+ * This is necessary because settings.json commands are executed
+ * by shells that expect forward slashes even on Windows
+ */
+export declare function toForwardSlash(path: string): string;
+/**
+ * Get Claude config directory path
+ */
+export declare function getClaudeConfigDir(): string;
+/**
+ * Get a path suitable for use in shell commands
+ * Converts backslashes to forward slashes for cross-platform compatibility
+ */
+export declare function toShellPath(path: string): string;
+/**
+ * Get Windows-appropriate data directory
+ * Falls back to sensible locations instead of XDG paths
+ */
+export declare function getDataDir(): string;
+/**
+ * Get Windows-appropriate config directory
+ */
+export declare function getConfigDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAKrC"}

package/dist/utils/paths.js

@@ -0,0 +1,55 @@
+/**
+ * Cross-Platform Path Utilities
+ *
+ * Provides utility functions for handling paths across Windows, macOS, and Linux.
+ * These utilities ensure paths in configuration files use forward slashes
+ * (which work universally) and handle platform-specific directory conventions.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Convert a path to use forward slashes (for JSON/config files)
+ * This is necessary because settings.json commands are executed
+ * by shells that expect forward slashes even on Windows
+ */
+export function toForwardSlash(path) {
+    return path.replace(/\\/g, '/');
+}
+/**
+ * Get Claude config directory path
+ */
+export function getClaudeConfigDir() {
+    return join(homedir(), '.claude');
+}
+/**
+ * Get a path suitable for use in shell commands
+ * Converts backslashes to forward slashes for cross-platform compatibility
+ */
+export function toShellPath(path) {
+    const normalized = toForwardSlash(path);
+    // Windows paths with spaces need quoting
+    if (normalized.includes(' ')) {
+        return `"${normalized}"`;
+    }
+    return normalized;
+}
+/**
+ * Get Windows-appropriate data directory
+ * Falls back to sensible locations instead of XDG paths
+ */
+export function getDataDir() {
+    if (process.platform === 'win32') {
+        return process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
+    }
+    return process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share');
+}
+/**
+ * Get Windows-appropriate config directory
+ */
+export function getConfigDir() {
+    if (process.platform === 'win32') {
+        return process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
+    }
+    return process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,yCAAyC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,UAAU,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC"}

package/docs/ARCHITECTURE.md

@@ -383,4 +383,83 @@ The skill layer architecture transforms a constraint into a feature, providing a
 
 - [Oh-My-OpenCode](https://github.com/code-yeongyu/oh-my-opencode) - Original multi-agent system
 - [Claude Code Skills](https://docs.anthropic.com/claude-code/skills) - Skill documentation
-- [Intelligent Skill Activation](./README.md#intelligent-skill-activation-beta) - Beta feature docs
+- [Intelligent Skill Activation](../README.md#intelligent-skill-activation-beta) - Beta feature docs
+
+---
+
+## v3.1 Feature Architecture
+
+### Delegation Categories Flow
+
+```
+Task Prompt                Category Detection           Model Selection
+───────────                ──────────────────           ───────────────
+     │                           │                            │
+     ▼                           ▼                            ▼
+┌─────────────┐           ┌──────────────────┐          ┌─────────────────┐
+│ "Design a   │           │ detectCategory   │          │ ComplexityTier  │
+│  beautiful  │──────────▶│ FromPrompt()     │─────────▶│                 │
+│  dashboard" │           │                  │          │ HIGH → opus     │
+└─────────────┘           │ Keywords:        │          │ MEDIUM → sonnet │
+                          │ - design ✓       │          │ LOW → haiku     │
+                          │ - dashboard ✓    │          └─────────────────┘
+                          │                  │                  │
+                          │ Category:        │                  ▼
+                          │ visual-engineering│          ┌─────────────────┐
+                          └──────────────────┘          │ Config Applied  │
+                                                        │ tier: HIGH      │
+                                                        │ temp: 0.7       │
+                                                        │ thinking: high  │
+                                                        └─────────────────┘
+```
+
+### Notepad Wisdom Storage Structure
+
+```
+.omc/
+└── notepads/
+    └── {plan-name}/
+        ├── learnings.md    # Technical discoveries
+        ├── decisions.md    # Architectural choices
+        ├── issues.md       # Known issues + workarounds
+        └── problems.md     # Blockers requiring resolution
+
+Entry Format:
+┌─────────────────────────────────────────┐
+│ ## 2024-01-15 14:30:00                  │
+│                                         │
+│ Content of the wisdom entry...          │
+└─────────────────────────────────────────┘
+```
+
+### Directory Diagnostics Strategy Selection
+
+```
+                    ┌──────────────────┐
+                    │ runDirectory     │
+                    │ Diagnostics()    │
+                    └────────┬─────────┘
+                             │
+              ┌──────────────┴──────────────┐
+              │       strategy = ?          │
+              └──────────────┬──────────────┘
+                             │
+         ┌───────────────────┼───────────────────┐
+         │                   │                   │
+    strategy='tsc'      strategy='auto'    strategy='lsp'
+         │                   │                   │
+         ▼                   ▼                   ▼
+   ┌───────────┐      ┌───────────┐       ┌───────────┐
+   │ tsc       │      │ tsconfig  │       │ LSP       │
+   │ --noEmit  │      │ exists?   │       │ Iteration │
+   │ (fast)    │      │           │       │ (fallback)│
+   └───────────┘      └─────┬─────┘       └───────────┘
+                            │
+                    ┌───────┴───────┐
+                    │ YES       NO  │
+                    └───────┬───────┘
+                            │
+                  ┌─────────┴─────────┐
+                  ▼                   ▼
+            Use tsc              Use LSP
+```

package/docs/CLAUDE.md

@@ -42,6 +42,7 @@ When you detect these patterns, you MUST invoke the corresponding skill:
 
 | Pattern Detected | MUST Invoke Skill |
 |------------------|-------------------|
+| "autopilot", "build me", "I want a" | `autopilot` |
 | Broad/vague request | `planner` (after explore for context) |
 | "don't stop", "must complete", "ralph" | `ralph` |
 | "fast", "parallel", "ulw", "ultrawork" | `ultrawork` |
@@ -67,6 +68,19 @@ When you detect these patterns, you MUST invoke the corresponding skill:
 
 ## PART 2: USER EXPERIENCE
 
+### Autopilot: The Default Experience
+
+**Autopilot** is the flagship feature and recommended starting point for new users. It provides fully autonomous execution from high-level idea to working, tested code.
+
+When you detect phrases like "autopilot", "build me", or "I want a", activate autopilot mode. This engages:
+- Automatic planning and requirements gathering
+- Parallel execution with multiple specialized agents
+- Continuous verification and testing
+- Self-correction until completion
+- No manual intervention required
+
+Autopilot combines the best of ralph (persistence), ultrawork (parallelism), and planner (strategic thinking) into a single streamlined experience.
+
 ### Zero Learning Curve
 
 Users don't need to learn commands. You detect intent and activate behaviors automatically.
@@ -75,6 +89,7 @@ Users don't need to learn commands. You detect intent and activate behaviors aut
 
 | When User Says... | You Automatically... |
 |-------------------|---------------------|
+| "autopilot", "build me", "I want a" | Activate autopilot for full autonomous execution |
 | Complex task | Delegate to specialist agents in parallel |
 | "plan this" / broad request | Start planning interview via planner |
 | "don't stop until done" | Activate ralph-loop for persistence |
@@ -86,6 +101,7 @@ Users don't need to learn commands. You detect intent and activate behaviors aut
 
 | Keyword | Effect | Example |
 |---------|--------|---------|
+| `autopilot` | Full autonomous execution | "autopilot: build a todo app" |
 | `ralph` | Persistence mode | "ralph: refactor auth" |
 | `ulw` | Maximum parallelism | "ulw fix all errors" |
 | `plan` | Planning interview | "plan the new API" |
@@ -96,6 +112,7 @@ Users don't need to learn commands. You detect intent and activate behaviors aut
 ### Stopping and Cancelling
 
 User says "stop", "cancel", "abort" → You determine what to stop:
+- In autopilot → invoke `cancel-autopilot`
 - In ralph-loop → invoke `cancel-ralph`
 - In ultrawork → invoke `cancel-ultrawork`
 - In ultraqa → invoke `cancel-ultraqa`
@@ -106,10 +123,11 @@ User says "stop", "cancel", "abort" → You determine what to stop:
 
 ## PART 3: COMPLETE REFERENCE
 
-### All 26 Skills
+### All Skills
 
 | Skill | Purpose | Auto-Trigger | Manual |
 |-------|---------|--------------|--------|
+| `autopilot` | Full autonomous execution from idea to working code | "autopilot", "build me", "I want a" | `/autopilot` |
 | `orchestrate` | Core multi-agent orchestration | Always active | - |
 | `ralph` | Persistence until verified complete | "don't stop", "must complete" | `/ralph` |
 | `ultrawork` | Maximum parallel execution | "fast", "parallel", "ulw" | `/ultrawork` |
@@ -133,11 +151,12 @@ User says "stop", "cancel", "abort" → You determine what to stop:
 | `omc-default-global` | Configure global settings | - | (internal) |
 | `ralph-init` | Initialize PRD for structured ralph | - | `/ralph-init` |
 | `release` | Automated release workflow | - | `/release` |
+| `cancel-autopilot` | Cancel active autopilot session | "stop autopilot", "cancel autopilot" | `/cancel-autopilot` |
 | `cancel-ralph` | Cancel active ralph loop | "stop" in ralph | `/cancel-ralph` |
 | `cancel-ultrawork` | Cancel ultrawork mode | "stop" in ultrawork | `/cancel-ultrawork` |
 | `cancel-ultraqa` | Cancel ultraqa workflow | "stop" in ultraqa | `/cancel-ultraqa` |
 
-### All 27 Agents
+### All 28 Agents
 
 Always use `oh-my-claudecode:` prefix when calling via Task tool.
 
@@ -153,7 +172,7 @@ Always use `oh-my-claudecode:` prefix when calling via Task tool.
 | **Planning** | - | - | `planner` |
 | **Critique** | - | - | `critic` |
 | **Pre-Planning** | - | - | `analyst` |
-| **Testing** | - | `qa-tester` | - |
+| **Testing** | - | `qa-tester` | `qa-tester-high` |
 | **Security** | `security-reviewer-low` | - | `security-reviewer` |
 | **Build** | `build-fixer-low` | `build-fixer` | - |
 | **TDD** | `tdd-guide-low` | `tdd-guide` | - |
@@ -190,6 +209,54 @@ Always use `oh-my-claudecode:` prefix when calling via Task tool.
 
 ---
 
+## PART 3.5: NEW FEATURES (v3.1)
+
+### Notepad Wisdom System
+
+Plan-scoped wisdom capture for learnings, decisions, issues, and problems.
+
+**Location:** `.omc/notepads/{plan-name}/`
+
+| File | Purpose |
+|------|---------|
+| `learnings.md` | Technical discoveries and patterns |
+| `decisions.md` | Architectural and design decisions |
+| `issues.md` | Known issues and workarounds |
+| `problems.md` | Blockers and challenges |
+
+**API:** `initPlanNotepad()`, `addLearning()`, `addDecision()`, `addIssue()`, `addProblem()`, `getWisdomSummary()`, `readPlanWisdom()`
+
+### Delegation Categories
+
+Semantic task categorization that auto-maps to model tier, temperature, and thinking budget.
+
+| Category | Tier | Temperature | Thinking | Use For |
+|----------|------|-------------|----------|---------|
+| `visual-engineering` | HIGH | 0.7 | high | UI/UX, frontend, design systems |
+| `ultrabrain` | HIGH | 0.3 | max | Complex reasoning, architecture, deep debugging |
+| `artistry` | MEDIUM | 0.9 | medium | Creative solutions, brainstorming |
+| `quick` | LOW | 0.1 | low | Simple lookups, basic operations |
+| `writing` | MEDIUM | 0.5 | medium | Documentation, technical writing |
+
+**Auto-detection:** Categories detect from prompt keywords automatically.
+
+### Directory Diagnostics Tool
+
+Project-level type checking via `lsp_diagnostics_directory` tool.
+
+**Strategies:**
+- `auto` (default) - Auto-selects best strategy, prefers tsc when tsconfig.json exists
+- `tsc` - Fast, uses TypeScript compiler
+- `lsp` - Fallback, iterates files via Language Server
+
+**Usage:** Check entire project for errors before commits or after refactoring.
+
+### Session Resume
+
+Background agents can be resumed with full context via `resume-session` tool.
+
+---
+
 ## PART 4: INTERNAL PROTOCOLS
 
 ### Broad Request Detection
@@ -269,6 +336,8 @@ Before concluding ANY session, verify:
 
 When you activate a major behavior, announce it:
 
+> "I'm activating **autopilot** for full autonomous execution from idea to working code."
+
 > "I'm activating **ralph-loop** to ensure this task completes fully."
 
 > "I'm activating **ultrawork** for maximum parallel execution."
@@ -294,6 +363,17 @@ Say "setup omc" or run `/oh-my-claudecode:omc-setup` to configure. After that, e
 
 ---
 
+## Quick Start for New Users
+
+**Just say what you want to build:**
+- "I want a REST API for managing tasks"
+- "Build me a React dashboard with charts"
+- "Create a CLI tool that processes CSV files"
+
+Autopilot activates automatically and handles the rest. No commands needed.
+
+---
+
 ## Migration from 2.x
 
 All old commands still work:
@@ -302,3 +382,5 @@ All old commands still work:
 - `/planner "task"` → Still works (or just say "plan this")
 
 The difference? You don't NEED them anymore. Everything auto-activates.
+
+**New in 3.x:** Autopilot mode provides the ultimate hands-off experience.