start-vibing 2.0.3 → 2.0.5

package/template/.claude/hooks/user-prompt-submit.ts

@@ -7,6 +7,9 @@
  * 2. MANDATORY research agent for new features
  * 3. STRICT workflow: audit -> branch -> implement -> document -> quality -> PR
  * 4. Separate UI for mobile/tablet/desktop (NOT just responsive)
+ *
+ * AGENT SYSTEM: 82 specialized agents in 14 categories
+ * SKILL SYSTEM: 22 skills auto-loaded by agents
  */
 
 import { existsSync, readFileSync } from 'fs';
@@ -36,93 +39,543 @@ const STRICT_WORKFLOW = `
     - Documenter agent not executed for code changes
 `;
 
+// ============================================================================
+// AGENT SYSTEM - 82 Specialized Agents in 14 Categories
+// ============================================================================
+
 interface AgentInfo {
-  description: string;
   triggers: string[];
-  priority: number;
   when: string;
+  skills: string[];
   can_veto?: boolean;
   mandatory_for?: string[];
-  enforces?: string;
 }
 
-const AGENTS: Record<string, AgentInfo> = {
-  'orchestrator': {
-    description: 'Coordinates entire development flow',
-    triggers: ['implement feature', 'build', 'create', 'fix and test', 'full workflow', 'multi-step'],
-    priority: 1,
-    when: 'Task requires >2 agents or touches >3 files'
+interface CategoryInfo {
+  description: string;
+  agents: Record<string, AgentInfo>;
+}
+
+const AGENT_CATEGORIES: Record<string, CategoryInfo> = {
+  '01-orchestration': {
+    description: 'Workflow coordination and task management',
+    agents: {
+      'orchestrator': {
+        triggers: ['implement feature', 'build', 'create', 'full workflow', 'multi-step'],
+        when: 'Task requires >2 agents or touches >3 files',
+        skills: ['codebase-knowledge']
+      },
+      'task-decomposer': {
+        triggers: ['complex task', 'break down', 'multiple steps'],
+        when: 'Task has >3 steps or touches >3 files',
+        skills: ['codebase-knowledge']
+      },
+      'workflow-router': {
+        triggers: ['route', 'which agent', 'unclear'],
+        when: 'At task start to route to correct agent',
+        skills: ['codebase-knowledge']
+      },
+      'parallel-coordinator': {
+        triggers: ['parallel', 'concurrent', 'simultaneous'],
+        when: 'Multiple independent agents should run simultaneously',
+        skills: ['codebase-knowledge']
+      },
+      'context-manager': {
+        triggers: ['context', 'compress', 'long conversation'],
+        when: 'Context grows large or between major phases',
+        skills: ['codebase-knowledge']
+      },
+      'checkpoint-manager': {
+        triggers: ['checkpoint', 'save state', 'backup'],
+        when: 'BEFORE risky operations (git, deletions, refactors)',
+        skills: ['codebase-knowledge']
+      },
+      'error-recovery': {
+        triggers: ['failed', 'retry', 'timeout', 'unexpected error'],
+        when: 'An agent fails or returns unexpected results',
+        skills: ['codebase-knowledge', 'debugging-patterns']
+      },
+      'agent-selector': {
+        triggers: ['select agent', 'best agent', 'which agent'],
+        when: 'Multiple agents could handle a task',
+        skills: ['codebase-knowledge']
+      }
+    }
   },
-  'analyzer': {
-    description: 'Analyzes impact before code modification',
-    triggers: ['implement', 'add feature', 'fix bug', 'refactor', 'change', 'modify', 'update code'],
-    priority: 2,
-    when: 'BEFORE any Edit/Write to source files'
+  '02-typescript': {
+    description: 'TypeScript strict mode, types, and module resolution',
+    agents: {
+      'ts-strict-checker': {
+        triggers: ['strict mode', 'null check', 'process.env'],
+        when: 'AFTER editing any .ts file',
+        skills: ['typescript-strict']
+      },
+      'ts-types-analyzer': {
+        triggers: ['type error', 'inference', 'generic problem'],
+        when: 'On type errors or typecheck fails',
+        skills: ['typescript-strict']
+      },
+      'ts-generics-helper': {
+        triggers: ['generic', 'type parameter', 'complex type'],
+        when: 'Creating generic functions/types',
+        skills: ['typescript-strict']
+      },
+      'ts-migration-helper': {
+        triggers: ['migrate', 'convert to typescript', '.js'],
+        when: 'Migrating JavaScript to TypeScript',
+        skills: ['typescript-strict']
+      },
+      'type-definition-writer': {
+        triggers: ['new model', 'new entity', 'interface needed'],
+        when: 'BEFORE implementing new entities',
+        skills: ['typescript-strict']
+      },
+      'import-alias-enforcer': {
+        triggers: ['import', 'alias', '@types'],
+        when: 'AFTER editing .ts files - enforces $types/*, @common, @db',
+        skills: ['typescript-strict']
+      },
+      'esm-resolver': {
+        triggers: ['module error', 'import error', 'cannot find module'],
+        when: 'On module errors',
+        skills: ['typescript-strict', 'bun-runtime']
+      },
+      'bun-runtime-expert': {
+        triggers: ['bun', 'runtime', 'package management'],
+        when: 'Using Bun runtime',
+        skills: ['bun-runtime']
+      },
+      'zod-validator': {
+        triggers: ['validation', 'zod', 'schema'],
+        when: 'BEFORE commit when API routes exist',
+        skills: ['zod-validation']
+      },
+      'zod-schema-designer': {
+        triggers: ['new endpoint', 'form input', 'user input'],
+        when: 'BEFORE implementing any API endpoint',
+        skills: ['zod-validation', 'typescript-strict']
+      }
+    }
   },
-  'research': {
-    description: 'Researches best practices (2024-2025) - MANDATORY for new features',
-    triggers: ['research', 'investigate', 'study', 'best practice', 'how to', 'pattern', 'new feature', 'implement'],
-    priority: 3,
-    when: 'MANDATORY for ANY new feature or complex bug fix',
-    mandatory_for: ['feature', 'fix']
+  '03-testing': {
+    description: 'Unit tests (Vitest) and E2E tests (Playwright)',
+    agents: {
+      'vitest-config': {
+        triggers: ['test setup', 'vitest config', 'coverage config'],
+        when: 'Setting up tests or coverage issues arise',
+        skills: ['test-coverage']
+      },
+      'tester-unit': {
+        triggers: ['unit test', 'function test', 'utility test'],
+        when: 'AFTER implementing any function or utility',
+        skills: ['test-coverage']
+      },
+      'tester-integration': {
+        triggers: ['integration test', 'api test', 'service test'],
+        when: 'AFTER implementing API endpoints or services',
+        skills: ['test-coverage']
+      },
+      'test-data-generator': {
+        triggers: ['mock data', 'test fixture', 'factory'],
+        when: 'BEFORE writing tests that need data',
+        skills: ['test-coverage']
+      },
+      'test-cleanup-manager': {
+        triggers: ['flaky test', 'test isolation', 'state leakage'],
+        when: 'Tests are flaky or share state',
+        skills: ['test-coverage']
+      },
+      'playwright-e2e': {
+        triggers: ['e2e test', 'user flow', 'end to end'],
+        when: 'AFTER implementing any user-facing feature',
+        skills: ['test-coverage', 'playwright-automation']
+      },
+      'playwright-fixtures': {
+        triggers: ['fixture', 'shared setup', 'auth helper'],
+        when: 'Creating E2E tests that need shared setup',
+        skills: ['test-coverage', 'playwright-automation']
+      },
+      'playwright-page-objects': {
+        triggers: ['page object', 'page model', 'page interaction'],
+        when: 'Creating E2E tests for new pages',
+        skills: ['test-coverage', 'playwright-automation']
+      },
+      'playwright-multi-viewport': {
+        triggers: ['viewport', 'responsive test', 'mobile test'],
+        when: 'AFTER any UI implementation - tests desktop/tablet/mobile',
+        skills: ['test-coverage', 'playwright-automation']
+      },
+      'playwright-assertions': {
+        triggers: ['assertion', 'expect', 'test validation'],
+        when: 'Creating comprehensive test assertions',
+        skills: ['test-coverage', 'playwright-automation']
+      }
+    }
   },
-  'ui-ux-reviewer': {
-    description: 'Reviews UI/UX - ENFORCES separate mobile/tablet/desktop UIs',
-    triggers: ['ui', 'component', 'page', 'design', 'layout', 'style', 'frontend', 'mobile', 'desktop'],
-    priority: 3,
-    when: 'Files in components/, app/, or .tsx with JSX',
-    enforces: 'SEPARATE UIs for each platform (NOT just responsive)'
+  '04-docker': {
+    description: 'Docker containerization and deployment',
+    agents: {
+      'dockerfile-optimizer': {
+        triggers: ['dockerfile', 'docker build', 'image size'],
+        when: 'Creating or modifying Dockerfile',
+        skills: ['docker-patterns']
+      },
+      'docker-multi-stage': {
+        triggers: ['multi-stage', 'build optimization', 'production docker'],
+        when: 'Dockerfile can benefit from multi-stage',
+        skills: ['docker-patterns']
+      },
+      'docker-compose-designer': {
+        triggers: ['docker-compose', 'multi-service', 'local dev'],
+        when: 'Multi-service setup is needed',
+        skills: ['docker-patterns']
+      },
+      'docker-env-manager': {
+        triggers: ['docker env', 'secrets', 'env vars'],
+        when: 'Docker uses environment variables',
+        skills: ['docker-patterns']
+      },
+      'container-health': {
+        triggers: ['health check', 'container monitoring', 'service health'],
+        when: 'Creating Docker containers',
+        skills: ['docker-patterns']
+      },
+      'deployment-validator': {
+        triggers: ['deploy', 'pre-deploy', 'docker validation'],
+        when: 'BEFORE deploying',
+        skills: ['docker-patterns']
+      }
+    }
   },
-  'documenter': {
-    description: 'Documents results with commit hash references',
-    triggers: ['document', 'readme', 'docs', 'explain'],
-    priority: 4,
-    when: 'After implementation - MUST include commit hash for audit trail'
+  '05-database': {
+    description: 'MongoDB/Mongoose database operations',
+    agents: {
+      'mongoose-schema-designer': {
+        triggers: ['schema', 'model', 'collection'],
+        when: 'BEFORE creating any database model',
+        skills: ['mongoose-patterns']
+      },
+      'mongoose-index-optimizer': {
+        triggers: ['index', 'slow query', 'query performance'],
+        when: 'Database queries are slow',
+        skills: ['mongoose-patterns']
+      },
+      'mongoose-aggregation': {
+        triggers: ['aggregation', 'pipeline', 'reporting'],
+        when: 'Complex data queries needed',
+        skills: ['mongoose-patterns']
+      },
+      'mongodb-query-optimizer': {
+        triggers: ['n+1', 'query optimizer', 'database performance'],
+        when: 'Queries are slow',
+        skills: ['mongoose-patterns']
+      },
+      'database-seeder': {
+        triggers: ['seed', 'sample data', 'dev data'],
+        when: 'Setting up development environment',
+        skills: ['mongoose-patterns']
+      },
+      'data-migration': {
+        triggers: ['migration', 'schema change', 'data transform'],
+        when: 'Schema changes are needed',
+        skills: ['mongoose-patterns']
+      }
+    }
   },
-  'tester': {
-    description: 'Creates unit tests (Vitest) and E2E tests (Playwright)',
-    triggers: ['test', 'coverage', 'spec', 'e2e'],
-    priority: 5,
-    when: 'After any code implementation'
+  '06-security': {
+    description: 'Security auditing and OWASP compliance (CAN VETO)',
+    agents: {
+      'security-auditor': {
+        triggers: ['security', 'audit', 'vulnerability'],
+        when: 'BEFORE committing auth/user/API code',
+        can_veto: true,
+        skills: ['security-scan']
+      },
+      'owasp-checker': {
+        triggers: ['owasp', 'top 10', 'security review'],
+        when: 'BEFORE committing any API or security code',
+        can_veto: true,
+        skills: ['security-scan']
+      },
+      'input-sanitizer': {
+        triggers: ['sanitize', 'user input', 'xss'],
+        when: 'Handling user input',
+        skills: ['security-scan', 'zod-validation']
+      },
+      'auth-session-validator': {
+        triggers: ['auth', 'session', 'login', 'jwt'],
+        when: 'Implementing auth or session code',
+        skills: ['security-scan']
+      },
+      'permission-auditor': {
+        triggers: ['permission', 'authorization', 'access control'],
+        when: 'Implementing protected routes',
+        skills: ['security-scan']
+      },
+      'sensitive-data-scanner': {
+        triggers: ['sensitive', 'pii', 'data leak'],
+        when: 'Implementing API responses or logging',
+        skills: ['security-scan']
+      }
+    }
   },
-  'security-auditor': {
-    description: 'Audits security (CAN VETO)',
-    triggers: ['auth', 'session', 'password', 'token', 'api', 'database', 'user data', 'security'],
-    priority: 6,
-    when: 'Code touches auth/, api/, server/, or sensitive data',
-    can_veto: true
+  '07-documentation': {
+    description: 'Documentation and domain knowledge updates',
+    agents: {
+      'documenter': {
+        triggers: ['document', 'docs', 'explain code'],
+        when: 'AFTER any code implementation completes',
+        skills: ['docs-tracker', 'codebase-knowledge']
+      },
+      'domain-updater': {
+        triggers: ['domain', 'learnings', 'session end'],
+        when: 'BEFORE commit-manager at session end',
+        skills: ['codebase-knowledge', 'docs-tracker']
+      },
+      'readme-generator': {
+        triggers: ['readme', 'project docs', 'setup guide'],
+        when: 'Project structure changes significantly',
+        skills: ['docs-tracker']
+      },
+      'jsdoc-generator': {
+        triggers: ['jsdoc', 'function docs', 'api docs'],
+        when: 'Complex functions lack documentation',
+        skills: ['docs-tracker', 'typescript-strict']
+      },
+      'changelog-manager': {
+        triggers: ['changelog', 'release notes', 'version'],
+        when: 'BEFORE committing any feature or fix',
+        skills: ['docs-tracker', 'git-workflow']
+      },
+      'api-documenter': {
+        triggers: ['api docs', 'swagger', 'openapi'],
+        when: 'AFTER creating or modifying API endpoints',
+        skills: ['docs-tracker']
+      }
+    }
   },
-  'quality-checker': {
-    description: 'Runs typecheck, lint, test, build (Husky pre-commit)',
-    triggers: ['check', 'verify', 'validate', 'run tests', 'quality'],
-    priority: 7,
-    when: 'BEFORE any commit - Husky enforces this'
+  '08-git': {
+    description: 'Git workflow and version control',
+    agents: {
+      'branch-manager': {
+        triggers: ['branch', 'feature branch', 'fix branch'],
+        when: 'BEFORE making source changes on main branch',
+        skills: ['git-workflow']
+      },
+      'commit-manager': {
+        triggers: ['commit', 'push', 'finalize'],
+        when: 'FINAL AGENT when implementation is complete',
+        skills: ['git-workflow', 'docs-tracker', 'codebase-knowledge']
+      },
+      'pr-creator': {
+        triggers: ['pr', 'pull request', 'merge'],
+        when: 'AFTER commit-manager when feature is ready',
+        skills: ['git-workflow']
+      }
+    }
   },
-  'final-validator': {
-    description: 'Final validation before commit (CAN VETO)',
-    triggers: ['final', 'commit ready', 'approve'],
-    priority: 8,
-    when: 'Before any commit operation',
-    can_veto: true
+  '09-quality': {
+    description: 'Code quality and review',
+    agents: {
+      'quality-checker': {
+        triggers: ['quality', 'typecheck', 'lint', 'build'],
+        when: 'BEFORE any commit',
+        skills: ['quality-gate', 'codebase-knowledge']
+      },
+      'code-reviewer': {
+        triggers: ['review', 'pr review', 'code quality'],
+        when: 'AFTER significant code is written',
+        skills: ['quality-gate', 'codebase-knowledge']
+      }
+    }
   },
-  'domain-updater': {
-    description: 'Updates domain knowledge with session learnings',
-    triggers: ['update domain', 'document learnings', 'session end'],
-    priority: 9,
-    when: 'BEFORE commit-manager - updates domains so git stays clean'
+  '10-research': {
+    description: 'Web research and best practices (MANDATORY for new features)',
+    agents: {
+      'research-web': {
+        triggers: ['search', 'find info', 'look up'],
+        when: 'BEFORE implementing any new feature or technology',
+        mandatory_for: ['feature'],
+        skills: ['research-cache']
+      },
+      'research-cache-manager': {
+        triggers: ['cache', 'cached research', 'previous research'],
+        when: 'BEFORE any web research',
+        skills: ['research-cache']
+      },
+      'best-practices-finder': {
+        triggers: ['best practice', 'recommended', 'how should'],
+        when: 'BEFORE implementing any new pattern',
+        skills: ['research-cache']
+      },
+      'pattern-researcher': {
+        triggers: ['pattern', 'architecture', 'design decision'],
+        when: 'Facing architectural decisions',
+        skills: ['research-cache']
+      },
+      'competitor-analyzer': {
+        triggers: ['competitor', 'similar app', 'how does'],
+        when: 'Designing UI or features with existing market solutions',
+        skills: ['research-cache']
+      },
+      'tech-evaluator': {
+        triggers: ['compare', 'evaluate', 'which library'],
+        when: 'Choosing between technologies',
+        skills: ['research-cache']
+      }
+    }
   },
-  'commit-manager': {
-    description: 'Creates conventional commits and completes workflow',
-    triggers: ['commit', 'save changes', 'push', 'finalize', 'git'],
-    priority: 10,
-    when: 'FINAL step - after domain-updater, runs complete-task'
+  '11-ui-ux': {
+    description: 'UI/UX - SEPARATE UIs for mobile/tablet/desktop (NOT just responsive)',
+    agents: {
+      'ui-mobile': {
+        triggers: ['mobile', 'touch', '375px'],
+        when: 'Implementing any UI feature',
+        skills: ['ui-ux-audit', 'react-patterns', 'tailwind-patterns', 'shadcn-ui']
+      },
+      'ui-tablet': {
+        triggers: ['tablet', 'ipad', '768px'],
+        when: 'Implementing any UI feature',
+        skills: ['ui-ux-audit', 'react-patterns', 'tailwind-patterns', 'shadcn-ui']
+      },
+      'ui-desktop': {
+        triggers: ['desktop', 'sidebar', '1280px'],
+        when: 'Implementing any UI feature',
+        skills: ['ui-ux-audit', 'react-patterns', 'tailwind-patterns', 'shadcn-ui']
+      },
+      'skeleton-generator': {
+        triggers: ['skeleton', 'loading', 'placeholder'],
+        when: 'AFTER creating any component that loads data',
+        skills: ['react-patterns', 'tailwind-patterns']
+      },
+      'design-system-enforcer': {
+        triggers: ['design system', 'consistency', 'component style'],
+        when: 'AFTER creating UI components',
+        skills: ['ui-ux-audit', 'shadcn-ui', 'tailwind-patterns']
+      },
+      'accessibility-auditor': {
+        triggers: ['a11y', 'accessibility', 'wcag', 'screen reader'],
+        when: 'AFTER any UI implementation',
+        skills: ['ui-ux-audit']
+      }
+    }
+  },
+  '12-performance': {
+    description: 'Performance profiling and optimization',
+    agents: {
+      'performance-profiler': {
+        triggers: ['slow', 'performance', 'profile', 'bottleneck'],
+        when: 'Application is slow',
+        skills: ['performance-patterns']
+      },
+      'memory-leak-detector': {
+        triggers: ['memory', 'leak', 'heap'],
+        when: 'Memory issues are suspected',
+        skills: ['performance-patterns']
+      },
+      'bundle-analyzer': {
+        triggers: ['bundle', 'build size', 'lighthouse'],
+        when: 'Build is large or slow',
+        skills: ['performance-patterns']
+      },
+      'api-latency-analyzer': {
+        triggers: ['api slow', 'response time', 'latency'],
+        when: 'API endpoints are slow',
+        skills: ['performance-patterns']
+      },
+      'query-optimizer': {
+        triggers: ['slow query', 'n+1', 'database slow'],
+        when: 'Database queries are slow',
+        skills: ['performance-patterns', 'mongoose-patterns']
+      },
+      'render-optimizer': {
+        triggers: ['re-render', 'react slow', 'component slow'],
+        when: 'React components re-render excessively',
+        skills: ['performance-patterns', 'react-patterns']
+      }
+    }
+  },
+  '13-debugging': {
+    description: 'Error analysis and debugging',
+    agents: {
+      'debugger': {
+        triggers: ['bug', 'error', 'not working', 'broken', 'fails'],
+        when: 'Any bug or error occurs',
+        skills: ['debugging-patterns']
+      },
+      'type-error-resolver': {
+        triggers: ['ts error', 'type error', 'typecheck fails'],
+        when: 'On TypeScript type errors',
+        skills: ['debugging-patterns', 'typescript-strict']
+      },
+      'runtime-error-fixer': {
+        triggers: ['crash', 'exception', 'runtime error'],
+        when: 'On runtime crashes or exceptions',
+        skills: ['debugging-patterns']
+      },
+      'network-debugger': {
+        triggers: ['fetch error', 'api error', 'cors', 'network'],
+        when: 'On network or API errors',
+        skills: ['debugging-patterns']
+      },
+      'error-stack-analyzer': {
+        triggers: ['stack trace', 'trace', 'call stack'],
+        when: 'Error includes stack trace',
+        skills: ['debugging-patterns']
+      },
+      'build-error-fixer': {
+        triggers: ['build failed', 'compile error', 'bundler error'],
+        when: 'Build fails',
+        skills: ['debugging-patterns']
+      }
+    }
+  },
+  '14-validation': {
+    description: 'Final validation before commit (CAN VETO)',
+    agents: {
+      'final-validator': {
+        triggers: ['final check', 'validate', 'ready to commit'],
+        when: 'BEFORE commit-manager - last check',
+        can_veto: true,
+        skills: ['final-check']
+      }
+    }
   }
 };
 
+// ============================================================================
+// SKILL SYSTEM - 22 Skills Auto-loaded by Agents
+// ============================================================================
+
+const SKILLS: Record<string, string> = {
+  'bun-runtime': 'Bun runtime patterns, package management, scripts',
+  'codebase-knowledge': 'Project domain knowledge, file mapping, recent commits',
+  'debugging-patterns': 'Stack traces, runtime errors, build errors, network issues',
+  'docker-patterns': 'Containerization, multi-stage builds, Docker Compose, security',
+  'docs-tracker': 'Documentation maintenance, git diff detection, changelog',
+  'final-check': 'Final validation, tests pass, docs updated, security audited',
+  'git-workflow': 'Branch management, conventional commits, PR creation, hooks',
+  'mongoose-patterns': 'MongoDB schema design, queries, indexes, aggregations',
+  'nextjs-app-router': 'Next.js 15 App Router, Server/Client components, data fetching',
+  'performance-patterns': 'React optimization, bundle analysis, memory leaks, API latency',
+  'playwright-automation': 'E2E tests, browser automation, visual testing, API testing',
+  'quality-gate': 'Quality checks (typecheck, lint, test, build)',
+  'react-patterns': 'React 19 patterns, hooks, state management, performance',
+  'research-cache': 'Cached research findings, best practices by topic',
+  'security-scan': 'OWASP Top 10, user ID validation, sensitive data detection',
+  'shadcn-ui': 'shadcn/ui components, customization, theming, accessibility',
+  'tailwind-patterns': 'Tailwind CSS, responsive design, dark mode, animations',
+  'test-coverage': 'Playwright E2E, Vitest unit tests, coverage tracking',
+  'trpc-api': 'tRPC type-safe APIs, routers, procedures, middleware',
+  'typescript-strict': 'TypeScript strict mode, index access, null checks, generics',
+  'ui-ux-audit': 'UI/UX audits, competitor research, WCAG 2.1, responsiveness',
+  'zod-validation': 'Zod schemas, input validation, type inference, error handling'
+};
+
 const WORKFLOWS: Record<string, string[]> = {
-  'feature': ['analyzer', 'research', 'ui-ux-reviewer', 'documenter', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
-  'fix': ['analyzer', 'research', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
-  'refactor': ['analyzer', 'tester', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
+  'feature': ['analyzer', 'research-web', 'ui-ux-reviewer', 'documenter', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
+  'fix': ['debugger', 'analyzer', 'tester', 'security-auditor', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
+  'refactor': ['analyzer', 'code-reviewer', 'tester', 'quality-checker', 'final-validator', 'domain-updater', 'commit-manager'],
   'config': ['quality-checker', 'domain-updater', 'commit-manager']
 };
 
@@ -148,9 +601,9 @@ function loadWorkflowState(): WorkflowState | null {
 function detectTaskType(prompt: string): string {
   const promptLower = prompt.toLowerCase();
 
-  if (['bug', 'fix', 'error', 'broken', 'not working', 'issue'].some(w => promptLower.includes(w))) {
+  if (['bug', 'fix', 'error', 'broken', 'not working', 'issue', 'debug'].some(w => promptLower.includes(w))) {
     return 'fix';
-  } else if (['refactor', 'restructure', 'reorganize', 'clean up'].some(w => promptLower.includes(w))) {
+  } else if (['refactor', 'restructure', 'reorganize', 'clean up', 'improve'].some(w => promptLower.includes(w))) {
     return 'refactor';
   } else if (['config', 'setting', 'env', 'package.json', 'tsconfig'].some(w => promptLower.includes(w))) {
     return 'config';
@@ -158,38 +611,48 @@ function detectTaskType(prompt: string): string {
   return 'feature';
 }
 
-function detectBestAgent(prompt: string): [string, string] {
+function detectBestAgents(prompt: string): Array<[string, string, string]> {
   const promptLower = prompt.toLowerCase();
-
-  const multiStepIndicators = ['and then', 'after that', 'also', 'implement', 'build', 'create feature'];
-  if (multiStepIndicators.some(ind => promptLower.includes(ind))) {
-    return ['orchestrator', 'Multi-step task detected - orchestrator will coordinate all agents'];
-  }
-
-  const matches: Array<[string, number, string]> = [];
-  for (const [agentName, agentInfo] of Object.entries(AGENTS)) {
-    for (const trigger of agentInfo.triggers) {
-      if (promptLower.includes(trigger)) {
-        matches.push([agentName, agentInfo.priority, trigger]);
+  const matches: Array<[string, string, string]> = [];
+
+  for (const [category, info] of Object.entries(AGENT_CATEGORIES)) {
+    for (const [agentName, agentInfo] of Object.entries(info.agents)) {
+      for (const trigger of agentInfo.triggers) {
+        if (promptLower.includes(trigger)) {
+          matches.push([category, agentName, `Matched '${trigger}'`]);
+          break;
+        }
       }
     }
   }
 
-  if (matches.length > 0) {
-    matches.sort((a, b) => a[1] - b[1]);
-    const best = matches[0];
-    return [best[0], `Matched trigger '${best[2]}'`];
+  matches.sort((a, b) => a[0].localeCompare(b[0]));
+
+  if (matches.length === 0) {
+    return [['01-orchestration', 'orchestrator', 'No specific trigger - orchestrator will analyze']];
   }
 
-  return ['orchestrator', 'No specific trigger matched - orchestrator will analyze'];
+  return matches.slice(0, 3);
 }
 
-function formatAgentList(): string {
-  const sorted = Object.entries(AGENTS).sort((a, b) => a[1].priority - b[1].priority);
-  return sorted.map(([name, info]) => {
-    const veto = info.can_veto ? ' [CAN VETO]' : '';
-    return `  - ${name}: ${info.description}${veto}`;
-  }).join('\n');
+function formatAgentCategories(): string {
+  const lines: string[] = [];
+  for (const [category, info] of Object.entries(AGENT_CATEGORIES).sort()) {
+    const agentCount = Object.keys(info.agents).length;
+    const vetoAgents = Object.entries(info.agents)
+      .filter(([, a]) => a.can_veto)
+      .map(([n]) => n);
+    const vetoStr = vetoAgents.length > 0 ? ` [VETO: ${vetoAgents.join(', ')}]` : '';
+    lines.push(`  ${category}: ${info.description} (${agentCount} agents)${vetoStr}`);
+  }
+  return lines.join('\n');
+}
+
+function formatSkills(): string {
+  return Object.entries(SKILLS)
+    .sort()
+    .map(([name, desc]) => `  ${name}: ${desc}`)
+    .join('\n');
 }
 
 function formatWorkflowStatus(state: WorkflowState | null): string {
@@ -240,10 +703,13 @@ async function main(): Promise<void> {
   const prompt = hookInput.user_prompt || hookInput.prompt || '';
   const state = loadWorkflowState();
   const taskType = prompt ? detectTaskType(prompt) : 'unknown';
-  const [bestAgent, reason] = prompt ? detectBestAgent(prompt) : ['orchestrator', 'Default'];
+  const bestAgents = prompt ? detectBestAgents(prompt) : [['01-orchestration', 'orchestrator', 'Default'] as [string, string, string]];
 
   const isNewFeature = taskType === 'feature' || ['new', 'implement', 'create', 'add'].some(w => prompt.toLowerCase().includes(w));
   const isUiTask = ['ui', 'component', 'page', 'design', 'layout', 'mobile', 'desktop', 'tablet'].some(w => prompt.toLowerCase().includes(w));
+  const isDebugTask = ['bug', 'error', 'broken', 'not working', 'debug', 'fix'].some(w => prompt.toLowerCase().includes(w));
+
+  const recommendedStr = bestAgents.map(([cat, agent, reason], i) => `    ${i + 1}. ${cat}/${agent} - ${reason}`).join('\n');
 
   const output = `
 ================================================================================
@@ -253,6 +719,7 @@ ${STRICT_WORKFLOW}
 
 ${isNewFeature ? '⚠️  NEW FEATURE DETECTED - RESEARCH AGENT IS MANDATORY!' : ''}
 ${isUiTask ? '⚠️  UI TASK DETECTED - SEPARATE UIs FOR MOBILE/TABLET/DESKTOP REQUIRED!' : ''}
+${isDebugTask ? '🐛 DEBUG TASK DETECTED - Use debugger or type-error-resolver agents' : ''}
 
 ================================================================================
 STEP 1: CREATE DETAILED TODO LIST (MANDATORY)
@@ -262,19 +729,30 @@ BEFORE doing anything, you MUST use TodoWrite to create a detailed todo list.
 Break down the user's prompt into specific, actionable items.
 
 ================================================================================
-AVAILABLE AGENTS:
-${formatAgentList()}
+AGENT SYSTEM: 82 Specialized Agents in 14 Categories
+================================================================================
+
+CATEGORIES:
+${formatAgentCategories()}
 
 TASK ANALYSIS:
   Detected type: ${taskType}
-  Recommended agent: ${bestAgent}
-  Reason: ${reason}
+  Recommended agents:
+${recommendedStr}
   Research required: ${isNewFeature ? 'YES (MANDATORY)' : 'Optional'}
   Separate UIs required: ${isUiTask ? 'YES (MANDATORY)' : 'N/A'}
   Workflow sequence: ${(WORKFLOWS[taskType] || WORKFLOWS['feature']).join(' -> ')}
 
 ${formatWorkflowStatus(state)}
 
+================================================================================
+SKILL SYSTEM: 22 Skills Auto-loaded by Agents
+================================================================================
+
+${formatSkills()}
+
+Skills are auto-loaded when an agent starts. Agents don't inherit parent skills.
+
 ================================================================================
 AGENT INVOCATION (VIA TASK TOOL ONLY)
 ================================================================================
@@ -282,6 +760,10 @@ AGENT INVOCATION (VIA TASK TOOL ONLY)
 You MUST use the Task tool with subagent_type to invoke agents.
 DO NOT execute agent logic manually - INVOKE the agent properly.
 
+Example:
+  Task(subagent_type="debugger", prompt="Fix the TypeError in user.ts")
+  Task(subagent_type="playwright-e2e", prompt="Create E2E tests for login")
+
 ================================================================================
 `;