oh-my-claude-sisyphus 3.8.15 → 3.9.0

package/dist/verification/tier-selector.js

@@ -0,0 +1,95 @@
+/**
+ * Verification Tier Selector
+ *
+ * Scales verification effort with task complexity to optimize cost
+ * while maintaining quality. Used by ralph, autopilot, and ultrapilot.
+ */
+const TIER_AGENTS = {
+    LIGHT: {
+        agent: 'architect-low',
+        model: 'haiku',
+        evidenceRequired: ['lsp_diagnostics clean'],
+    },
+    STANDARD: {
+        agent: 'architect-medium',
+        model: 'sonnet',
+        evidenceRequired: ['lsp_diagnostics clean', 'build pass'],
+    },
+    THOROUGH: {
+        agent: 'architect',
+        model: 'opus',
+        evidenceRequired: ['full architect review', 'all tests pass', 'no regressions'],
+    },
+};
+/**
+ * Select appropriate verification tier based on change metadata.
+ */
+export function selectVerificationTier(changes) {
+    // Security and architectural changes always require thorough review
+    if (changes.hasSecurityImplications || changes.hasArchitecturalChanges) {
+        return 'THOROUGH';
+    }
+    // Large scope changes require thorough review
+    if (changes.filesChanged > 20) {
+        return 'THOROUGH';
+    }
+    // Small, well-tested changes can use light verification
+    if (changes.filesChanged < 5 &&
+        changes.linesChanged < 100 &&
+        changes.testCoverage === 'full') {
+        return 'LIGHT';
+    }
+    // Default to standard verification
+    return 'STANDARD';
+}
+/**
+ * Get the verification agent configuration for a tier.
+ */
+export function getVerificationAgent(tier) {
+    return TIER_AGENTS[tier];
+}
+/**
+ * Detect if any files represent architectural changes.
+ */
+export function detectArchitecturalChanges(files) {
+    const architecturalPatterns = [
+        /config\.(ts|js|json)$/i,
+        /schema\.(ts|prisma|sql)$/i,
+        /definitions\.ts$/i,
+        /types\.ts$/i,
+        /package\.json$/i,
+        /tsconfig\.json$/i,
+    ];
+    return files.some((file) => architecturalPatterns.some((pattern) => pattern.test(file)));
+}
+/**
+ * Detect if any files have security implications.
+ */
+export function detectSecurityImplications(files) {
+    const securityPatterns = [
+        /\/auth\//i, // auth directory
+        /\/security\//i, // security directory
+        /(^|[\/-])permissions?\.(ts|js)$/i, // permission.ts, permissions.ts
+        /(^|[\/-])credentials?\.(ts|js|json)$/i, // credential.ts, credentials.json
+        /(^|[\/-])secrets?\.(ts|js|json|ya?ml)$/i, // secret.ts, secrets.yaml
+        /(^|[\/-])tokens?\.(ts|js|json)$/i, // token.ts, auth-token.ts
+        /\.(env|pem|key)(\.|$)/i, // .env, .env.local, cert.pem, private.key
+        /(^|[\/-])passwords?\.(ts|js|json)$/i, // password.ts
+        /(^|[\/-])oauth/i, // oauth.ts, oauth-config.ts, oauth2.ts
+        /(^|[\/-])jwt/i, // jwt.ts, jwt-utils.ts, jwt_utils.ts
+    ];
+    return files.some((file) => securityPatterns.some((pattern) => pattern.test(file)));
+}
+/**
+ * Build change metadata from a list of changed files and line count.
+ */
+export function buildChangeMetadata(files, linesChanged, testCoverage = 'partial') {
+    return {
+        filesChanged: files.length,
+        linesChanged,
+        hasArchitecturalChanges: detectArchitecturalChanges(files),
+        hasSecurityImplications: detectSecurityImplications(files),
+        testCoverage,
+    };
+}
+//# sourceMappingURL=tier-selector.js.map

package/dist/verification/tier-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-selector.js","sourceRoot":"","sources":["../../src/verification/tier-selector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,WAAW,GAAgD;IAC/D,KAAK,EAAE;QACL,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,OAAO;QACd,gBAAgB,EAAE,CAAC,uBAAuB,CAAC;KAC5C;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,QAAQ;QACf,gBAAgB,EAAE,CAAC,uBAAuB,EAAE,YAAY,CAAC;KAC1D;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,MAAM;QACb,gBAAgB,EAAE,CAAC,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;KAChF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,oEAAoE;IACpE,IAAI,OAAO,CAAC,uBAAuB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;QACvE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,IAAI,OAAO,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,wDAAwD;IACxD,IACE,OAAO,CAAC,YAAY,GAAG,CAAC;QACxB,OAAO,CAAC,YAAY,GAAG,GAAG;QAC1B,OAAO,CAAC,YAAY,KAAK,MAAM,EAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mCAAmC;IACnC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAe;IACxD,MAAM,qBAAqB,GAAG;QAC5B,wBAAwB;QACxB,2BAA2B;QAC3B,mBAAmB;QACnB,aAAa;QACb,iBAAiB;QACjB,kBAAkB;KACnB,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAe;IACxD,MAAM,gBAAgB,GAAG;QACvB,WAAW,EAA+B,iBAAiB;QAC3D,eAAe,EAA2B,qBAAqB;QAC/D,kCAAkC,EAAQ,gCAAgC;QAC1E,uCAAuC,EAAG,kCAAkC;QAC5E,yCAAyC,EAAE,0BAA0B;QACrE,kCAAkC,EAAQ,0BAA0B;QACpE,wBAAwB,EAAkB,0CAA0C;QACpF,qCAAqC,EAAK,cAAc;QACxD,iBAAiB,EAAyB,uCAAuC;QACjF,eAAe,EAA2B,qCAAqC;KAChF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzB,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAe,EACf,YAAoB,EACpB,eAA4C,SAAS;IAErD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,MAAM;QAC1B,YAAY;QACZ,uBAAuB,EAAE,0BAA0B,CAAC,KAAK,CAAC;QAC1D,uBAAuB,EAAE,0BAA0B,CAAC,KAAK,CAAC;QAC1D,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/verification/tier-selector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tier-selector.test.d.ts.map

package/dist/verification/tier-selector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-selector.test.d.ts","sourceRoot":"","sources":["../../src/verification/tier-selector.test.ts"],"names":[],"mappings":""}

package/dist/verification/tier-selector.test.js

@@ -0,0 +1,282 @@
+import { describe, it, expect } from 'vitest';
+import { selectVerificationTier, getVerificationAgent, detectArchitecturalChanges, detectSecurityImplications, buildChangeMetadata, } from './tier-selector.js';
+describe('selectVerificationTier', () => {
+    it('returns LIGHT for small, well-tested changes', () => {
+        const changes = {
+            filesChanged: 2,
+            linesChanged: 50,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        expect(selectVerificationTier(changes)).toBe('LIGHT');
+    });
+    it('returns THOROUGH for security changes regardless of size', () => {
+        const changes = {
+            filesChanged: 1,
+            linesChanged: 5,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: true,
+            testCoverage: 'full',
+        };
+        expect(selectVerificationTier(changes)).toBe('THOROUGH');
+    });
+    it('returns THOROUGH for architectural changes', () => {
+        const changes = {
+            filesChanged: 3,
+            linesChanged: 80,
+            hasArchitecturalChanges: true,
+            hasSecurityImplications: false,
+            testCoverage: 'partial',
+        };
+        expect(selectVerificationTier(changes)).toBe('THOROUGH');
+    });
+    it('returns STANDARD for medium changes without special flags', () => {
+        const changes = {
+            filesChanged: 10,
+            linesChanged: 200,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'partial',
+        };
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+    it('returns THOROUGH for >20 files', () => {
+        const changes = {
+            filesChanged: 25,
+            linesChanged: 100,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        expect(selectVerificationTier(changes)).toBe('THOROUGH');
+    });
+    it('returns STANDARD when test coverage is not full', () => {
+        const changes = {
+            filesChanged: 2,
+            linesChanged: 50,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'partial',
+        };
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+    it('returns STANDARD when lines exceed 100', () => {
+        const changes = {
+            filesChanged: 3,
+            linesChanged: 150,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+});
+describe('getVerificationAgent', () => {
+    it('returns architect-low for LIGHT tier', () => {
+        const agent = getVerificationAgent('LIGHT');
+        expect(agent.agent).toBe('architect-low');
+        expect(agent.model).toBe('haiku');
+    });
+    it('returns architect-medium for STANDARD tier', () => {
+        const agent = getVerificationAgent('STANDARD');
+        expect(agent.agent).toBe('architect-medium');
+        expect(agent.model).toBe('sonnet');
+    });
+    it('returns architect for THOROUGH tier', () => {
+        const agent = getVerificationAgent('THOROUGH');
+        expect(agent.agent).toBe('architect');
+        expect(agent.model).toBe('opus');
+    });
+});
+describe('detectArchitecturalChanges', () => {
+    it('detects config files', () => {
+        expect(detectArchitecturalChanges(['src/config.ts'])).toBe(true);
+        expect(detectArchitecturalChanges(['app.config.json'])).toBe(true);
+    });
+    it('detects schema files', () => {
+        expect(detectArchitecturalChanges(['prisma/schema.prisma'])).toBe(true);
+        expect(detectArchitecturalChanges(['db/schema.sql'])).toBe(true);
+    });
+    it('detects definitions and types', () => {
+        expect(detectArchitecturalChanges(['src/definitions.ts'])).toBe(true);
+        expect(detectArchitecturalChanges(['src/types.ts'])).toBe(true);
+    });
+    it('detects package files', () => {
+        expect(detectArchitecturalChanges(['package.json'])).toBe(true);
+        expect(detectArchitecturalChanges(['tsconfig.json'])).toBe(true);
+    });
+    it('ignores regular source files', () => {
+        expect(detectArchitecturalChanges(['src/utils/helper.ts'])).toBe(false);
+        expect(detectArchitecturalChanges(['src/components/Button.tsx'])).toBe(false);
+    });
+});
+describe('detectSecurityImplications', () => {
+    it('detects auth files', () => {
+        expect(detectSecurityImplications(['src/auth/login.ts'])).toBe(true);
+        expect(detectSecurityImplications(['lib/auth/jwt.ts'])).toBe(true);
+    });
+    it('detects security-related paths', () => {
+        expect(detectSecurityImplications(['src/security/encrypt.ts'])).toBe(true);
+        expect(detectSecurityImplications(['src/permissions.ts'])).toBe(true);
+    });
+    it('detects credential and secret files', () => {
+        expect(detectSecurityImplications(['credentials.json'])).toBe(true);
+        expect(detectSecurityImplications(['secrets.ts'])).toBe(true);
+    });
+    it('detects env files', () => {
+        expect(detectSecurityImplications(['.env'])).toBe(true);
+        expect(detectSecurityImplications(['.env.local'])).toBe(true);
+    });
+    it('ignores regular source files', () => {
+        expect(detectSecurityImplications(['src/utils/helper.ts'])).toBe(false);
+        expect(detectSecurityImplications(['src/components/Button.tsx'])).toBe(false);
+    });
+});
+describe('buildChangeMetadata', () => {
+    it('builds metadata with auto-detection', () => {
+        const files = ['src/auth/login.ts', 'src/config.ts'];
+        const metadata = buildChangeMetadata(files, 100, 'full');
+        expect(metadata.filesChanged).toBe(2);
+        expect(metadata.linesChanged).toBe(100);
+        expect(metadata.hasArchitecturalChanges).toBe(true);
+        expect(metadata.hasSecurityImplications).toBe(true);
+        expect(metadata.testCoverage).toBe('full');
+    });
+    it('defaults test coverage to partial', () => {
+        const metadata = buildChangeMetadata(['src/util.ts'], 50);
+        expect(metadata.testCoverage).toBe('partial');
+    });
+});
+describe('boundary values', () => {
+    it('returns STANDARD for exactly 5 files with full test coverage', () => {
+        const changes = {
+            filesChanged: 5,
+            linesChanged: 50,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        // 5 files is at the boundary - should NOT qualify for LIGHT (which requires < 5)
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+    it('returns STANDARD for exactly 100 lines with full test coverage', () => {
+        const changes = {
+            filesChanged: 3,
+            linesChanged: 100,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        // 100 lines is at the boundary - should NOT qualify for LIGHT (which requires < 100)
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+    it('returns THOROUGH for exactly 21 files', () => {
+        const changes = {
+            filesChanged: 21,
+            linesChanged: 100,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        // 21 files exceeds > 20 threshold
+        expect(selectVerificationTier(changes)).toBe('THOROUGH');
+    });
+    it('returns STANDARD for exactly 20 files', () => {
+        const changes = {
+            filesChanged: 20,
+            linesChanged: 100,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        // 20 files does NOT exceed > 20 threshold
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+});
+describe('edge cases', () => {
+    it('handles testCoverage: none', () => {
+        const changes = {
+            filesChanged: 2,
+            linesChanged: 50,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'none',
+        };
+        // No test coverage means it can't qualify for LIGHT
+        expect(selectVerificationTier(changes)).toBe('STANDARD');
+    });
+    it('handles empty file list in buildChangeMetadata', () => {
+        const metadata = buildChangeMetadata([], 0);
+        expect(metadata.filesChanged).toBe(0);
+        expect(metadata.linesChanged).toBe(0);
+        expect(metadata.hasArchitecturalChanges).toBe(false);
+        expect(metadata.hasSecurityImplications).toBe(false);
+    });
+    it('handles zero files and zero lines', () => {
+        const changes = {
+            filesChanged: 0,
+            linesChanged: 0,
+            hasArchitecturalChanges: false,
+            hasSecurityImplications: false,
+            testCoverage: 'full',
+        };
+        // 0 files and 0 lines with full coverage qualifies for LIGHT
+        expect(selectVerificationTier(changes)).toBe('LIGHT');
+    });
+});
+describe('false-positive prevention', () => {
+    describe('detectSecurityImplications', () => {
+        it('does NOT flag tokenizer.ts as security file', () => {
+            expect(detectSecurityImplications(['src/utils/tokenizer.ts'])).toBe(false);
+        });
+        it('does NOT flag StringTokenizer.ts as security file', () => {
+            expect(detectSecurityImplications(['src/lexer/StringTokenizer.ts'])).toBe(false);
+        });
+        it('does NOT flag secretariat.ts as security file', () => {
+            expect(detectSecurityImplications(['src/admin/secretariat.ts'])).toBe(false);
+        });
+        it('does NOT flag permissionless.ts as security file', () => {
+            expect(detectSecurityImplications(['src/blockchain/permissionless.ts'])).toBe(false);
+        });
+        it('DOES flag auth/token.ts as security file', () => {
+            expect(detectSecurityImplications(['src/auth/token.ts'])).toBe(true);
+        });
+        it('DOES flag secrets.yaml as security file', () => {
+            expect(detectSecurityImplications(['config/secrets.yaml'])).toBe(true);
+        });
+        it('DOES flag .env.local as security file', () => {
+            expect(detectSecurityImplications(['.env.local'])).toBe(true);
+        });
+        it('DOES flag permissions.ts as security file', () => {
+            expect(detectSecurityImplications(['src/permissions.ts'])).toBe(true);
+        });
+        it('DOES flag oauth2.ts as security file', () => {
+            expect(detectSecurityImplications(['src/auth/oauth2.ts'])).toBe(true);
+        });
+        it('DOES flag oauth2-client.ts as security file', () => {
+            expect(detectSecurityImplications(['src/oauth2-client.ts'])).toBe(true);
+        });
+        it('DOES flag jwt_utils.ts as security file', () => {
+            expect(detectSecurityImplications(['src/jwt_utils.ts'])).toBe(true);
+        });
+    });
+    describe('detectArchitecturalChanges', () => {
+        it('does NOT flag barrel index.ts as architectural', () => {
+            expect(detectArchitecturalChanges(['src/components/index.ts'])).toBe(false);
+        });
+        it('does NOT flag nested barrel index.ts as architectural', () => {
+            expect(detectArchitecturalChanges(['src/utils/helpers/index.ts'])).toBe(false);
+        });
+        it('DOES still flag config.ts as architectural', () => {
+            expect(detectArchitecturalChanges(['src/config.ts'])).toBe(true);
+        });
+        it('DOES still flag package.json as architectural', () => {
+            expect(detectArchitecturalChanges(['package.json'])).toBe(true);
+        });
+        it('DOES still flag tsconfig.json as architectural', () => {
+            expect(detectArchitecturalChanges(['tsconfig.json'])).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=tier-selector.test.js.map

package/dist/verification/tier-selector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-selector.test.js","sourceRoot":"","sources":["../../src/verification/tier-selector.test.ts"],"names":[],"mappings":"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"}

package/docs/AGENTS.md

@@ -0,0 +1,100 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-01-31 | Updated: 2026-01-31 -->
+
+# docs
+
+User documentation and technical guides for oh-my-claudecode.
+
+## Purpose
+
+This directory contains documentation for end-users and developers:
+
+- **End-user guides**: How to use oh-my-claudecode features
+- **Technical reference**: Architecture, compatibility, migration
+- **Design documents**: Feature design specifications
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `CLAUDE.md` | End-user orchestration instructions (installed to user projects) |
+| `FEATURES.md` | Developer API reference for internal features |
+| `REFERENCE.md` | API reference and configuration options |
+| `ARCHITECTURE.md` | System architecture overview |
+| `MIGRATION.md` | Version migration guides |
+| `COMPATIBILITY.md` | Compatibility matrix and requirements |
+| `TIERED_AGENTS_V2.md` | Model routing and tiered agent design |
+| `DELEGATION-ENFORCER.md` | Delegation protocol documentation |
+| `SYNC-SYSTEM.md` | State synchronization system |
+| `ANALYTICS-SYSTEM.md` | Analytics collection documentation |
+| `LOCAL_PLUGIN_INSTALL.md` | Plugin installation guide |
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `design/` | Feature design specifications |
+
+## For AI Agents
+
+### Working In This Directory
+
+1. **End-User Focus**: CLAUDE.md is installed to user projects - write for end-users, not developers
+2. **Keep Links Accessible**: Use raw GitHub URLs for links in CLAUDE.md (agents can't navigate GitHub UI)
+3. **Version Consistency**: Update version numbers across all docs when releasing
+
+### When to Update Each File
+
+| Trigger | File to Update |
+|---------|---------------|
+| Agent count or list changes | `REFERENCE.md` (Agents section) |
+| Skill count or list changes | `REFERENCE.md` (Skills section) |
+| Hook count or list changes | `REFERENCE.md` (Hooks System section) |
+| Magic keywords change | `REFERENCE.md` (Magic Keywords section) |
+| Agent tool assignments change | `CLAUDE.md` (Agent Tool Matrix) |
+| Skill composition or architecture changes | `ARCHITECTURE.md` |
+| New internal API or feature | `FEATURES.md` |
+| Breaking changes or migrations | `MIGRATION.md` |
+| Tiered agent design updates | `TIERED_AGENTS_V2.md` |
+| Platform or version support changes | `COMPATIBILITY.md` |
+| End-user instructions change | `CLAUDE.md` |
+| Major user-facing features | `../README.md` |
+
+### Testing Requirements
+
+- Verify markdown renders correctly
+- Check all internal links resolve
+- Validate code examples in documentation
+
+### Common Patterns
+
+#### Linking to Raw Content
+
+Use raw GitHub URLs for external accessibility:
+
+[Migration Guide](https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/MIGRATION.md)
+
+#### Version References
+
+Use consistent version heading format with blank line after heading:
+
+```markdown
+## v3.8.17 Changes
+
+- Feature A
+- Feature B
+```
+
+## Dependencies
+
+### Internal
+
+- References agents from `agents/`
+- References skills from `skills/`
+- References tools from `src/tools/`
+
+### External
+
+None - pure markdown files.
+
+<!-- MANUAL: -->

package/docs/ARCHITECTURE.md

@@ -62,7 +62,7 @@ Skills: ultrawork + default + git-master
 | MEDIUM | Sonnet | Standard implementations |
 | HIGH | Opus | Complex reasoning, architecture |
 
-See [FEATURES.md](./FEATURES.md) for the complete agent roster.
+See [REFERENCE.md](./REFERENCE.md) for the complete agent roster.
 
 ### Delegation
 
@@ -118,13 +118,16 @@ Legacy locations are auto-migrated on read.
 
 ## Hooks
 
-oh-my-claudecode uses Claude Code's hooks system for lifecycle events:
+oh-my-claudecode includes 31 hooks in `src/hooks/` for lifecycle events:
 
-- **conversationStart**: Initialize OMC, check for active modes
-- **beforeRequest**: Task delegation, skill routing
-- **afterResponse**: State updates, verification checks
+| Event | Purpose |
+|-------|---------|
+| `UserPromptSubmit` | Keyword detection, mode activation |
+| `Stop` | Continuation enforcement, session end |
+| `PreToolUse` | Permission validation |
+| `PostToolUse` | Error recovery, rules injection |
 
-Hooks are defined in `.claude/hooks/` and managed through the plugin system.
+See [REFERENCE.md](./REFERENCE.md) for the complete hooks list.
 
 ## Verification Protocol
 
@@ -143,6 +146,7 @@ Evidence must be fresh (within 5 minutes) and include actual command output.
 
 ## For More Details
 
-- **API Reference**: See [FEATURES.md](./FEATURES.md)
+- **Complete Reference**: See [REFERENCE.md](./REFERENCE.md)
+- **Internal API**: See [FEATURES.md](./FEATURES.md)
 - **User Guide**: See [README.md](../README.md)
 - **Skills Reference**: See CLAUDE.md in your project