start-vibing 2.0.3 → 2.0.5

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

@@ -13,6 +13,9 @@ Output is sent to Claude as context before processing the user's request.
 
 Based on official Claude Code documentation:
 https://code.claude.com/docs/en/hooks.md
+
+AGENT SYSTEM: 82 specialized agents in 14 categories
+SKILL SYSTEM: 22 skills auto-loaded by agents
 """
 
 import json
@@ -47,85 +50,531 @@ STRICT_WORKFLOW = """
     - Documenter agent not executed for code changes
 """
 
-# Agent definitions with triggers
-AGENTS = {
-    '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'
+# ============================================================================
+# AGENT SYSTEM - 82 Specialized Agents in 14 Categories
+# ============================================================================
+
+AGENT_CATEGORIES = {
+    '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']
+            }
+        }
+    },
+    '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']
+            }
+        }
+    },
+    '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']
+            }
+        }
     },
-    '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'
+    '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']
+            }
+        }
     },
-    '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'
+    '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']
+            }
+        }
     }
 }
 
-# Workflow sequences (research after analyzer, domain-updater BEFORE commit-manager for clean git)
+# ============================================================================
+# SKILL SYSTEM - 22 Skills Auto-loaded by Agents
+# ============================================================================
+
+SKILLS = {
+    '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'
+}
+
+# Workflow sequences
 WORKFLOWS = {
-    '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']
 }
 
@@ -145,9 +594,9 @@ def detect_task_type(prompt: str) -> str:
     """Detect task type from prompt"""
     prompt_lower = prompt.lower()
 
-    if any(word in prompt_lower for word in ['bug', 'fix', 'error', 'broken', 'not working', 'issue']):
+    if any(word in prompt_lower for word in ['bug', 'fix', 'error', 'broken', 'not working', 'issue', 'debug']):
         return 'fix'
-    elif any(word in prompt_lower for word in ['refactor', 'restructure', 'reorganize', 'clean up']):
+    elif any(word in prompt_lower for word in ['refactor', 'restructure', 'reorganize', 'clean up', 'improve']):
         return 'refactor'
     elif any(word in prompt_lower for word in ['config', 'setting', 'env', 'package.json', 'tsconfig']):
         return 'config'
@@ -155,38 +604,44 @@ def detect_task_type(prompt: str) -> str:
         return 'feature'
 
 
-def detect_best_agent(prompt: str) -> tuple[str, str]:
-    """Detect best agent for the task"""
+def detect_best_agents(prompt: str) -> list[tuple[str, str, str]]:
+    """Detect best agents for the task, returns list of (category, agent, reason)"""
     prompt_lower = prompt.lower()
+    matches = []
 
-    # Check for multi-step tasks first
-    multi_step_indicators = ['and then', 'after that', 'also', 'implement', 'build', 'create feature']
-    if any(indicator in prompt_lower for indicator in multi_step_indicators):
-        return 'orchestrator', 'Multi-step task detected - orchestrator will coordinate all agents'
+    for category, info in AGENT_CATEGORIES.items():
+        for agent_name, agent_info in info['agents'].items():
+            for trigger in agent_info['triggers']:
+                if trigger in prompt_lower:
+                    matches.append((category, agent_name, f"Matched '{trigger}'"))
+                    break
 
-    # Check each agent's triggers
-    matches = []
-    for agent_name, agent_info in AGENTS.items():
-        for trigger in agent_info['triggers']:
-            if trigger in prompt_lower:
-                matches.append((agent_name, agent_info['priority'], trigger))
+    # Sort by category number (priority)
+    matches.sort(key=lambda x: x[0])
+
+    # Return top 3 matches or orchestrator if none
+    if not matches:
+        return [('01-orchestration', 'orchestrator', 'No specific trigger - orchestrator will analyze')]
+
+    return matches[:3]
 
-    if matches:
-        # Sort by priority (lower is better)
-        matches.sort(key=lambda x: x[1])
-        best = matches[0]
-        return best[0], f"Matched trigger '{best[2]}'"
 
-    # Default to orchestrator for unknown tasks
-    return 'orchestrator', 'No specific trigger matched - orchestrator will analyze'
+def format_agent_categories() -> str:
+    """Format all agent categories for display"""
+    lines = []
+    for category, info in sorted(AGENT_CATEGORIES.items()):
+        agent_count = len(info['agents'])
+        veto_agents = [name for name, a in info['agents'].items() if a.get('can_veto')]
+        veto_str = f" [VETO: {', '.join(veto_agents)}]" if veto_agents else ""
+        lines.append(f"  {category}: {info['description']} ({agent_count} agents){veto_str}")
+    return '\n'.join(lines)
 
 
-def format_agent_list() -> str:
-    """Format agent list for display"""
+def format_skills() -> str:
+    """Format all skills for display"""
     lines = []
-    for name, info in sorted(AGENTS.items(), key=lambda x: x[1]['priority']):
-        veto = ' [CAN VETO]' if info.get('can_veto') else ''
-        lines.append(f"  - {name}: {info['description']}{veto}")
+    for name, description in sorted(SKILLS.items()):
+        lines.append(f"  {name}: {description}")
     return '\n'.join(lines)
 
 
@@ -217,19 +672,23 @@ def main():
     except json.JSONDecodeError:
         hook_input = {}
 
-    # Get user prompt (may not be available in all hook contexts)
+    # Get user prompt
     prompt = hook_input.get('user_prompt', hook_input.get('prompt', ''))
 
     # Load current state
     state = load_workflow_state()
 
-    # Detect task type and best agent
+    # Detect task type and best agents
     task_type = detect_task_type(prompt) if prompt else 'unknown'
-    best_agent, reason = detect_best_agent(prompt) if prompt else ('orchestrator', 'Default')
+    best_agents = detect_best_agents(prompt) if prompt else [('01-orchestration', 'orchestrator', 'Default')]
 
-    # Check if task is new feature (requires research)
-    is_new_feature = task_type in ['feature'] or any(word in prompt.lower() for word in ['new', 'implement', 'create', 'add'])
+    # Check task characteristics
+    is_new_feature = task_type == 'feature' or any(word in prompt.lower() for word in ['new', 'implement', 'create', 'add'])
     is_ui_task = any(word in prompt.lower() for word in ['ui', 'component', 'page', 'design', 'layout', 'mobile', 'desktop', 'tablet'])
+    is_debug_task = any(word in prompt.lower() for word in ['bug', 'error', 'broken', 'not working', 'debug', 'fix'])
+
+    # Format recommended agents
+    recommended_str = '\n'.join([f"    {i+1}. {cat}/{agent} - {reason}" for i, (cat, agent, reason) in enumerate(best_agents)])
 
     # Build output message
     output = f"""
@@ -240,6 +699,7 @@ STRICT WORKFLOW ENFORCEMENT - UserPromptSubmit Hook
 
 {"⚠️  NEW FEATURE DETECTED - RESEARCH AGENT IS MANDATORY!" if is_new_feature else ""}
 {"⚠️  UI TASK DETECTED - SEPARATE UIs FOR MOBILE/TABLET/DESKTOP REQUIRED!" if is_ui_task else ""}
+{"🐛 DEBUG TASK DETECTED - Use debugger or type-error-resolver agents" if is_debug_task else ""}
 
 ================================================================================
 STEP 1: CREATE DETAILED TODO LIST (MANDATORY)
@@ -248,36 +708,31 @@ STEP 1: CREATE DETAILED TODO LIST (MANDATORY)
 BEFORE doing anything, you MUST use TodoWrite to create a detailed todo list.
 Break down the user's prompt into specific, actionable items.
 
-Example:
-  User prompt: "Add login feature"
-  Todo list:
-    1. Research login best practices 2024-2025
-    2. Check existing auth documentation
-    3. Create feature/login branch
-    4. Implement login form (mobile UI)
-    5. Implement login form (tablet UI)
-    6. Implement login form (desktop UI)
-    7. Add validation with visual feedback
-    8. Create unit tests
-    9. Create E2E tests
-    10. Document implementation with commit hash
-    11. Run quality gates
-    12. Create PR to main
-
 ================================================================================
-AVAILABLE AGENTS:
-{format_agent_list()}
+AGENT SYSTEM: 82 Specialized Agents in 14 Categories
+================================================================================
+
+CATEGORIES:
+{format_agent_categories()}
 
 TASK ANALYSIS:
   Detected type: {task_type}
-  Recommended agent: {best_agent}
-  Reason: {reason}
+  Recommended agents:
+{recommended_str}
   Research required: {"YES (MANDATORY)" if is_new_feature else "Optional"}
   Separate UIs required: {"YES (MANDATORY)" if is_ui_task else "N/A"}
   Workflow sequence: {' -> '.join(WORKFLOWS.get(task_type, WORKFLOWS['feature']))}
 
 {format_workflow_status(state)}
 
+================================================================================
+SKILL SYSTEM: 22 Skills Auto-loaded by Agents
+================================================================================
+
+{format_skills()}
+
+Skills are auto-loaded when an agent starts. Agents don't inherit parent skills.
+
 ================================================================================
 UI ARCHITECTURE RULES (MANDATORY FOR WEB APPS)
 ================================================================================
@@ -301,12 +756,6 @@ DESKTOP (1280px+):
   - Top navbar: centered Levenshtein search
   - High information density
 
-SHARED:
-  - Featured carousel section
-  - Hidden scrollbars (but scroll works)
-  - Scroll indicators (arrows)
-  - Framer Motion transitions
-
 ================================================================================
 INPUT VALIDATION RULES (ALL INPUTS)
 ================================================================================
@@ -341,17 +790,9 @@ 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.
 
-AGENTS INVOCABLE VIA TASK TOOL:
-  - research: Task(subagent_type="research", prompt="...") {"<-- MANDATORY FOR THIS TASK" if is_new_feature else ""}
-  - analyzer: Task(subagent_type="analyzer", prompt="...")
-  - ui-ux-reviewer: Task(subagent_type="ui-ux-reviewer", prompt="...") {"<-- MANDATORY FOR THIS TASK" if is_ui_task else ""}
-  - tester: Task(subagent_type="tester", prompt="...")
-  - security-auditor: Task(subagent_type="security-auditor", prompt="...")
-  - quality-checker: Task(subagent_type="quality-checker", prompt="...")
-  - final-validator: Task(subagent_type="final-validator", prompt="...")
-  - documenter: Task(subagent_type="documenter", prompt="...")
-  - commit-manager: Task(subagent_type="commit-manager", prompt="...")
-  - orchestrator: Task(subagent_type="orchestrator", prompt="...")
+Example:
+  Task(subagent_type="debugger", prompt="Fix the TypeError in user.ts")
+  Task(subagent_type="playwright-e2e", prompt="Create E2E tests for login")
 
 ================================================================================
 MANDATORY RULES CHECKLIST:
@@ -368,42 +809,6 @@ MANDATORY RULES CHECKLIST:
 [ ] 9. I WILL create PR to main with doc references
 [ ] 10. I WILL use Task tool to invoke agents (NOT manually)
 
-================================================================================
-COMPONENT DESIGN RULES (SELF-AWARE RESPONSIVE):
-================================================================================
-
-Components CAN be responsive internally (detect their own device type).
-But layouts MUST be separate for each platform.
-
-CARD COMPONENTS:
-  - NO BORDERS - Use shadows and backgrounds instead
-  - Use useDeviceType() hook for self-awareness
-  - Adapt padding/layout based on device
-  - Desktop: hover effects (scale, shadow)
-  - Mobile: touch-optimized (44px targets)
-
-```typescript
-// GOOD - Self-aware component
-const device = useDeviceType();
-<div className={{cn(
-  'rounded-2xl shadow-lg', // NO borders
-  device === 'mobile' ? 'p-4' : 'p-6 hover:scale-[1.02]'
-)}} />
-```
-
-================================================================================
-END OF WORKFLOW MANDATORY:
-================================================================================
-
-After completing any task, you MUST:
-
-1. Run commit-manager agent via Task tool
-2. Commit all changes with conventional commit format
-3. Create PR to main if on feature/fix branch
-4. NEVER leave uncommitted changes
-
-This is MANDATORY - workflow is NOT complete until committed.
-
 ================================================================================
 """