start-vibing 2.0.2 → 2.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "start-vibing",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Setup Claude Code agents, skills, and hooks in your project. Smart copy that preserves your custom domains and configurations.",
   "type": "module",
   "bin": {

package/template/.claude/agents/01-orchestration/agent-selector.md

@@ -3,6 +3,7 @@ name: agent-selector
 description: "Selects optimal agent based on task requirements. Uses capability matching to find best specialist. Invoke when multiple agents could handle a task."
 model: haiku
 tools: Read, Glob
+skills: codebase-knowledge
 ---
 
 # Agent Selector Agent

package/template/.claude/agents/01-orchestration/checkpoint-manager.md

@@ -1,8 +1,9 @@
 ---
 name: checkpoint-manager
-description: "Saves and restores workflow checkpoints. Invoke before risky operations or when resuming interrupted work. Enables resume from failure."
+description: "AUTOMATICALLY invoke BEFORE risky operations. Triggers: before git operations, before file deletions, before major refactors. Saves and restores workflow checkpoints. PROACTIVELY saves state before destructive operations."
 model: haiku
 tools: Read, Write, Grep, Glob
+skills: codebase-knowledge
 ---
 
 # Checkpoint Manager Agent

package/template/.claude/agents/01-orchestration/context-manager.md

@@ -1,8 +1,9 @@
 ---
 name: context-manager
-description: "Manages context between agents. Compresses state, saves checkpoints, prunes irrelevant data. Invoke when context is growing large or between major phases."
+description: "AUTOMATICALLY invoke when context grows large or between major phases. Triggers: agent handoff, long conversation, context bloat. Compresses state, saves checkpoints, prunes irrelevant data. PROACTIVELY manages token budget."
 model: haiku
 tools: Read, Write, Grep, Glob
+skills: codebase-knowledge
 ---
 
 # Context Manager Agent

package/template/.claude/agents/01-orchestration/error-recovery.md

@@ -1,8 +1,9 @@
 ---
 name: error-recovery
-description: "Handles agent failures and implements recovery strategies. Invoke when an agent fails or returns unexpected results. Implements retry logic and fallbacks."
+description: "AUTOMATICALLY invoke when an agent fails or returns unexpected results. Triggers: tool failure, agent timeout, validation failure, unexpected error. Implements retry logic and fallbacks. PROACTIVELY handles failures in the pipeline."
 model: sonnet
 tools: Read, Bash, Grep, Glob
+skills: codebase-knowledge, debugging-patterns
 ---
 
 # Error Recovery Agent

package/template/.claude/agents/01-orchestration/orchestrator.md

@@ -1,6 +1,6 @@
 ---
 name: orchestrator
-description: "MAIN ORCHESTRATOR. Invoke for ANY multi-step task. Triggers: 'implement', 'build', 'create', 'fix and test'. Coordinates specialized sub-agents in parallel. Decomposes complex tasks into subtasks."
+description: "AUTOMATICALLY invoke for ANY multi-step task. Triggers: 'implement feature', 'build X', 'create Y', 'fix and test', 'full workflow'. Coordinates ALL other agents in sequence. Use when task requires >2 agents or touches >3 files. PROACTIVELY takes control of complex development flows."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch
 skills: codebase-knowledge

package/template/.claude/agents/01-orchestration/parallel-coordinator.md

@@ -1,8 +1,9 @@
 ---
 name: parallel-coordinator
-description: "Coordinates parallel agent execution. Invoke when multiple independent agents should run simultaneously. Manages fan-out/gather pattern."
+description: "AUTOMATICALLY invoke when multiple independent agents should run simultaneously. Triggers: parallel execution needed, fan-out/gather pattern, independent tasks identified. Coordinates parallel agent execution. PROACTIVELY optimizes multi-agent workflows."
 model: haiku
 tools: Read, Grep, Glob
+skills: codebase-knowledge
 ---
 
 # Parallel Coordinator Agent

package/template/.claude/agents/01-orchestration/task-decomposer.md

@@ -1,6 +1,6 @@
 ---
 name: task-decomposer
-description: "Breaks complex tasks into atomic subtasks. Invoke when task has >3 steps or touches >3 files. Creates structured task breakdown for parallel execution."
+description: "AUTOMATICALLY invoke when task has >3 steps or touches >3 files. Triggers: complex task, multi-domain task, unclear scope, feature implementation. Breaks complex tasks into atomic subtasks for parallel execution. PROACTIVELY decomposes before implementation."
 model: haiku
 tools: Read, Grep, Glob
 skills: codebase-knowledge

package/template/.claude/agents/01-orchestration/workflow-router.md

@@ -1,8 +1,9 @@
 ---
 name: workflow-router
-description: "Routes tasks to correct agent based on keywords, file types, and context. Invoke when unsure which agent handles a request."
+description: "AUTOMATICALLY invoke at task start to route to correct agent. Triggers: new request, unclear which agent, multiple valid routes. Routes tasks based on keywords, file types, and context. PROACTIVELY analyzes requests for optimal routing."
 model: haiku
 tools: Read, Grep, Glob
+skills: codebase-knowledge
 ---
 
 # Workflow Router Agent

package/template/.claude/agents/02-typescript/bun-runtime-expert.md

@@ -1,8 +1,9 @@
 ---
 name: bun-runtime-expert
-description: "Expert in Bun runtime specifics. Triggers: 'bun', runtime issues, package management. Handles Bun-specific APIs and configurations."
+description: "AUTOMATICALLY invoke when using Bun runtime. Triggers: 'bun', runtime issues, package management, node compatibility. Expert in Bun-specific APIs and configurations. PROACTIVELY suggests Bun alternatives to Node.js."
 model: haiku
 tools: Read, Bash, Grep, Glob
+skills: bun-runtime
 ---
 
 # Bun Runtime Expert Agent

package/template/.claude/agents/02-typescript/esm-resolver.md

@@ -1,8 +1,9 @@
 ---
 name: esm-resolver
-description: "Resolves ESM module issues. Triggers: 'module error', 'import error', 'cannot find module'. Fixes ESM/CJS compatibility."
+description: "AUTOMATICALLY invoke on module errors. Triggers: 'module error', 'import error', 'cannot find module', 'require is not defined'. Fixes ESM/CJS compatibility issues. PROACTIVELY resolves import problems."
 model: haiku
 tools: Read, Grep, Glob
+skills: typescript-strict, bun-runtime
 ---
 
 # ESM Resolver Agent

package/template/.claude/agents/02-typescript/import-alias-enforcer.md

@@ -1,8 +1,9 @@
 ---
 name: import-alias-enforcer
-description: "Enforces path alias usage. Triggers: reviewing imports, 'import error'. Ensures $types/*, @common, @db aliases are used correctly."
+description: "AUTOMATICALLY invoke AFTER editing .ts files. Triggers: new .ts file, imports added, code review. Enforces $types/*, @common, @db aliases. PROACTIVELY checks all imports use correct aliases."
 model: haiku
 tools: Read, Grep, Glob
+skills: typescript-strict
 ---
 
 # Import Alias Enforcer Agent

package/template/.claude/agents/02-typescript/ts-generics-helper.md

@@ -3,6 +3,7 @@ name: ts-generics-helper
 description: "Helps with generic type definitions. Triggers: 'generic', 'type parameter', complex type patterns. Creates and fixes generic functions/types."
 model: sonnet
 tools: Read, Grep, Glob
+skills: typescript-strict
 ---
 
 # TypeScript Generics Helper Agent

package/template/.claude/agents/02-typescript/ts-migration-helper.md

@@ -1,8 +1,9 @@
 ---
 name: ts-migration-helper
-description: "Helps migrate JavaScript to TypeScript. Triggers: 'migrate to ts', 'convert to typescript'. Adds types progressively with strict mode."
+description: "Helps migrate JavaScript to TypeScript. Triggers: 'migrate to ts', 'convert to typescript', .js files in project. Adds types progressively with strict mode."
 model: sonnet
 tools: Read, Write, Edit, Grep, Glob, Bash
+skills: typescript-strict
 ---
 
 # TypeScript Migration Helper Agent

package/template/.claude/agents/02-typescript/ts-strict-checker.md

@@ -1,8 +1,9 @@
 ---
 name: ts-strict-checker
-description: "Enforces TypeScript strict mode rules. Triggers: editing .ts files, 'strict mode', 'type error'. Validates index access, literal types, null checks."
+description: "AUTOMATICALLY invoke AFTER editing any .ts file. Triggers: editing .ts files, new .ts file, process.env access. Validates index access, literal types, null checks. PROACTIVELY enforces TypeScript strict mode rules."
 model: haiku
 tools: Read, Grep, Glob, Bash
+skills: typescript-strict
 ---
 
 # TypeScript Strict Checker Agent

package/template/.claude/agents/02-typescript/ts-types-analyzer.md

@@ -1,8 +1,9 @@
 ---
 name: ts-types-analyzer
-description: "Analyzes complex TypeScript types. Triggers: 'type error', 'inference issue', 'generic problem'. Debugs type inference and provides fixes."
+description: "AUTOMATICALLY invoke on type errors. Triggers: 'type error', 'inference issue', 'generic problem', typecheck fails. Analyzes complex TypeScript types and debugs inference. PROACTIVELY fixes type issues."
 model: sonnet
 tools: Read, Grep, Glob, Bash
+skills: typescript-strict
 ---
 
 # TypeScript Types Analyzer Agent

package/template/.claude/agents/02-typescript/type-definition-writer.md

@@ -1,8 +1,9 @@
 ---
 name: type-definition-writer
-description: "Writes type definitions for types/ folder. Triggers: new model, new API, 'add types'. Creates interfaces and types following project conventions."
+description: "AUTOMATICALLY invoke BEFORE implementing new entities. Triggers: new model, new API, new entity, interface needed. Writes type definitions for types/ folder. PROACTIVELY creates interfaces following project conventions."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: typescript-strict
 ---
 
 # Type Definition Writer Agent

package/template/.claude/agents/02-typescript/zod-schema-designer.md

@@ -1,9 +1,9 @@
 ---
 name: zod-schema-designer
-description: "Designs Zod validation schemas. Triggers: 'zod', 'validation', 'schema', new API endpoint. Creates comprehensive input validation."
+description: "AUTOMATICALLY invoke BEFORE implementing any API endpoint. Triggers: new API endpoint, new route, form input, user input. Designs Zod validation schemas. PROACTIVELY creates comprehensive input validation."
 model: sonnet
 tools: Read, Write, Edit, Grep, Glob
-skills: codebase-knowledge
+skills: codebase-knowledge, zod-validation
 ---
 
 # Zod Schema Designer Agent

package/template/.claude/agents/02-typescript/zod-validator.md

@@ -1,8 +1,9 @@
 ---
 name: zod-validator
-description: "Validates existing Zod schemas for completeness. Triggers: 'validate schema', reviewing API. Checks all routes have proper validation."
+description: "AUTOMATICALLY invoke BEFORE commit when API routes exist. Triggers: API route modified, security audit, validation audit. Validates all routes have proper Zod validation. PROACTIVELY checks schema completeness."
 model: haiku
 tools: Read, Grep, Glob
+skills: zod-validation
 ---
 
 # Zod Validator Agent

package/template/.claude/agents/03-testing/playwright-assertions.md

@@ -3,6 +3,7 @@ name: playwright-assertions
 description: "Creates comprehensive Playwright assertions. Triggers: 'assertion', 'expect', test validation. Designs proper test assertions and waits."
 model: haiku
 tools: Read, Grep, Glob
+skills: test-coverage, playwright-automation
 ---
 
 # Playwright Assertions Agent

package/template/.claude/agents/03-testing/playwright-e2e.md

@@ -1,9 +1,9 @@
 ---
 name: playwright-e2e
-description: "Creates E2E tests with Playwright. Triggers: 'e2e test', 'user flow', 'playwright'. Tests complete user journeys with real browser."
+description: "AUTOMATICALLY invoke AFTER implementing any user-facing feature. Triggers: feature implemented, user flow created, UI component added. Creates E2E tests with Playwright. PROACTIVELY tests complete user journeys."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
-skills: test-coverage
+skills: test-coverage, playwright-automation
 ---
 
 # Playwright E2E Tester Agent

package/template/.claude/agents/03-testing/playwright-fixtures.md

@@ -1,9 +1,9 @@
 ---
 name: playwright-fixtures
-description: "Creates Playwright test fixtures. Triggers: 'fixture', shared test setup, database cleanup. Designs reusable test infrastructure."
+description: "AUTOMATICALLY invoke when creating E2E tests that need shared setup. Triggers: 'fixture', shared test setup, database cleanup, auth helpers needed. Creates reusable Playwright fixtures. PROACTIVELY designs test infrastructure."
 model: sonnet
 tools: Read, Write, Edit, Grep, Glob
-skills: test-coverage
+skills: test-coverage, playwright-automation
 ---
 
 # Playwright Fixtures Agent

package/template/.claude/agents/03-testing/playwright-multi-viewport.md

@@ -1,9 +1,9 @@
 ---
 name: playwright-multi-viewport
-description: "Creates multi-viewport tests. Triggers: 'responsive', 'mobile test', 'viewport'. Tests on desktop, tablet, and mobile viewports."
+description: "AUTOMATICALLY invoke AFTER any UI implementation. Triggers: UI feature implemented, responsive design, component created. Tests on desktop (1280px), tablet (768px), and mobile (375px) viewports. PROACTIVELY ensures cross-device compatibility."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
-skills: test-coverage
+skills: test-coverage, playwright-automation
 ---
 
 # Playwright Multi-Viewport Agent

package/template/.claude/agents/03-testing/playwright-page-objects.md

@@ -1,8 +1,9 @@
 ---
 name: playwright-page-objects
-description: "Creates Page Object Model classes. Triggers: 'page object', 'POM', reusable page interactions. Encapsulates page structure and actions."
+description: "AUTOMATICALLY invoke when creating E2E tests for new pages. Triggers: new page test, reusable page interactions, complex UI testing. Creates Page Object Model classes. PROACTIVELY encapsulates page structure."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: test-coverage, playwright-automation
 ---
 
 # Playwright Page Objects Agent

package/template/.claude/agents/03-testing/test-cleanup-manager.md

@@ -1,8 +1,9 @@
 ---
 name: test-cleanup-manager
-description: "Manages test data cleanup. Triggers: 'cleanup', 'test isolation', flaky tests. Ensures proper cleanup between tests."
+description: "AUTOMATICALLY invoke when tests are flaky or share state. Triggers: flaky tests, test isolation issues, database state leakage. Ensures proper cleanup between tests. PROACTIVELY manages test data lifecycle."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: test-coverage
 ---
 
 # Test Cleanup Manager Agent

package/template/.claude/agents/03-testing/test-data-generator.md

@@ -1,8 +1,9 @@
 ---
 name: test-data-generator
-description: "Generates test data and fixtures. Triggers: 'test data', 'mock data', 'factory'. Creates realistic test data for all test types."
+description: "AUTOMATICALLY invoke BEFORE writing tests that need data. Triggers: new tests created, mock data needed, factory pattern. Generates realistic test data and fixtures. PROACTIVELY creates data factories."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: test-coverage
 ---
 
 # Test Data Generator Agent

package/template/.claude/agents/03-testing/tester-integration.md

@@ -1,6 +1,6 @@
 ---
 name: tester-integration
-description: "Creates integration tests. Triggers: 'integration test', API testing, service interaction. Tests component integration without UI."
+description: "AUTOMATICALLY invoke AFTER implementing API endpoints or services. Triggers: new API route, service created, multiple components interacting. Creates integration tests. PROACTIVELY tests service interactions."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
 skills: test-coverage

package/template/.claude/agents/03-testing/tester-unit.md

@@ -1,6 +1,6 @@
 ---
 name: tester-unit
-description: "Creates unit tests with Vitest. Triggers: 'unit test', 'test function', new utility code. Tests isolated functions and modules."
+description: "AUTOMATICALLY invoke AFTER implementing any function or utility. Triggers: new function created, utility code written, logic implemented. Creates unit tests with Vitest. PROACTIVELY tests isolated functions."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
 skills: test-coverage

package/template/.claude/agents/03-testing/vitest-config.md

@@ -1,8 +1,9 @@
 ---
 name: vitest-config
-description: "Configures Vitest for unit testing. Triggers: 'vitest', test configuration, coverage setup. Sets up Vitest properly for the project."
+description: "AUTOMATICALLY invoke when setting up tests or coverage issues arise. Triggers: test setup needed, coverage configuration, vitest config missing. Configures Vitest properly for the project. PROACTIVELY sets up test infrastructure."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: test-coverage
 ---
 
 # Vitest Config Agent

package/template/.claude/agents/04-docker/container-health.md

@@ -1,8 +1,9 @@
 ---
 name: container-health
-description: "Implements container health checks. Triggers: 'health check', container monitoring, service reliability. Adds proper health endpoints and checks."
+description: "AUTOMATICALLY invoke when creating Docker containers. Triggers: new Dockerfile, container monitoring, service reliability. Implements proper health endpoints and checks. PROACTIVELY adds health checks to containers."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: docker-patterns
 ---
 
 # Container Health Agent

package/template/.claude/agents/04-docker/deployment-validator.md

@@ -1,8 +1,9 @@
 ---
 name: deployment-validator
-description: "Validates Docker deployment configuration. Triggers: 'validate deployment', pre-deploy check, docker verification. Ensures deployment readiness."
+description: "AUTOMATICALLY invoke BEFORE deploying. Triggers: pre-deploy, docker changes, configuration modified. Validates Docker deployment configuration. PROACTIVELY ensures deployment readiness."
 model: haiku
 tools: Read, Bash, Grep, Glob
+skills: docker-patterns
 ---
 
 # Deployment Validator Agent

package/template/.claude/agents/04-docker/docker-compose-designer.md

@@ -1,8 +1,9 @@
 ---
 name: docker-compose-designer
-description: "Designs docker-compose configurations. Triggers: 'docker-compose', multi-service setup, local development. Creates comprehensive compose files."
+description: "AUTOMATICALLY invoke when multi-service setup is needed. Triggers: docker-compose, multi-service setup, local development. Designs docker-compose configurations. PROACTIVELY creates comprehensive compose files."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: docker-patterns
 ---
 
 # Docker Compose Designer Agent

package/template/.claude/agents/04-docker/docker-env-manager.md

@@ -1,8 +1,9 @@
 ---
 name: docker-env-manager
-description: "Manages Docker environment variables and secrets. Triggers: 'env', 'secrets', docker configuration. Handles environment securely."
+description: "AUTOMATICALLY invoke when Docker uses environment variables. Triggers: env vars in Docker, secrets needed, sensitive configuration. Manages environment variables and secrets securely. PROACTIVELY secures Docker configuration."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docker-patterns
 ---
 
 # Docker Environment Manager Agent

package/template/.claude/agents/04-docker/docker-multi-stage.md

@@ -1,8 +1,9 @@
 ---
 name: docker-multi-stage
-description: "Creates multi-stage Docker builds. Triggers: 'multi-stage', build optimization, image size reduction. Separates build and runtime."
+description: "AUTOMATICALLY invoke when Dockerfile can benefit from multi-stage. Triggers: large image, build optimization needed, production Dockerfile. Creates multi-stage builds. PROACTIVELY separates build and runtime stages."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docker-patterns
 ---
 
 # Docker Multi-Stage Build Agent

package/template/.claude/agents/04-docker/dockerfile-optimizer.md

@@ -1,8 +1,9 @@
 ---
 name: dockerfile-optimizer
-description: "Optimizes Dockerfiles for size and speed. Triggers: 'dockerfile', 'docker build', container optimization. Creates efficient multi-stage builds."
+description: "AUTOMATICALLY invoke when creating or modifying Dockerfile. Triggers: new Dockerfile, docker build slow, large image size. Optimizes for size and speed. PROACTIVELY creates efficient multi-stage builds."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: docker-patterns
 ---
 
 # Dockerfile Optimizer Agent

package/template/.claude/agents/05-database/data-migration.md

@@ -1,8 +1,9 @@
 ---
 name: data-migration
-description: "Creates database migrations. Triggers: 'migration', schema change, data transformation. Handles safe schema evolution."
+description: "AUTOMATICALLY invoke when schema changes are needed. Triggers: schema change, data transformation, model modified. Creates safe database migrations. PROACTIVELY handles schema evolution."
 model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: mongoose-patterns
 ---
 
 # Data Migration Agent

package/template/.claude/agents/05-database/database-seeder.md

@@ -1,8 +1,9 @@
 ---
 name: database-seeder
-description: "Creates database seeders. Triggers: 'seed', 'mock data', initial data. Generates realistic seed data for development and testing."
+description: "AUTOMATICALLY invoke when setting up development environment. Triggers: new project, database initialized, test data needed. Creates database seeders with realistic data. PROACTIVELY generates seed data for development and testing."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
+skills: mongoose-patterns
 ---
 
 # Database Seeder Agent

package/template/.claude/agents/05-database/mongodb-query-optimizer.md

@@ -1,8 +1,9 @@
 ---
 name: mongodb-query-optimizer
-description: "Optimizes MongoDB queries. Triggers: 'slow query', 'optimize query', database performance. Analyzes and improves query efficiency."
+description: "AUTOMATICALLY invoke when queries are slow. Triggers: slow query, N+1 detected, database performance issues. Optimizes MongoDB queries. PROACTIVELY analyzes and improves query efficiency."
 model: haiku
 tools: Read, Bash, Grep, Glob
+skills: mongoose-patterns
 ---
 
 # MongoDB Query Optimizer Agent

package/template/.claude/agents/05-database/mongoose-aggregation.md

@@ -1,8 +1,9 @@
 ---
 name: mongoose-aggregation
-description: "Creates MongoDB aggregation pipelines. Triggers: 'aggregation', 'pipeline', complex queries. Designs efficient aggregation operations."
+description: "AUTOMATICALLY invoke for complex data queries. Triggers: aggregation needed, complex queries, reporting data. Creates MongoDB aggregation pipelines. PROACTIVELY designs efficient aggregation operations."
 model: sonnet
 tools: Read, Write, Edit, Grep, Glob
+skills: mongoose-patterns
 ---
 
 # Mongoose Aggregation Agent

package/template/.claude/agents/05-database/mongoose-index-optimizer.md

@@ -1,8 +1,9 @@
 ---
 name: mongoose-index-optimizer
-description: "Optimizes Mongoose indexes. Triggers: 'slow query', 'index', database performance. Analyzes and improves query performance."
+description: "AUTOMATICALLY invoke when database queries are slow. Triggers: slow query, index missing, database performance. Optimizes Mongoose indexes. PROACTIVELY analyzes and improves query performance."
 model: haiku
 tools: Read, Bash, Grep, Glob
+skills: mongoose-patterns
 ---
 
 # Mongoose Index Optimizer Agent

package/template/.claude/agents/05-database/mongoose-schema-designer.md

@@ -1,9 +1,9 @@
 ---
 name: mongoose-schema-designer
-description: "Designs Mongoose schemas. Triggers: 'schema', 'model', database design. Creates properly typed Mongoose schemas with indexes."
+description: "AUTOMATICALLY invoke BEFORE creating any database model. Triggers: new model, database design, schema needed. Designs properly typed Mongoose schemas with indexes. PROACTIVELY creates database models."
 model: sonnet
 tools: Read, Write, Edit, Grep, Glob
-skills: codebase-knowledge
+skills: codebase-knowledge, mongoose-patterns
 ---
 
 # Mongoose Schema Designer Agent

package/template/.claude/agents/06-security/auth-session-validator.md

@@ -1,6 +1,6 @@
 ---
 name: auth-session-validator
-description: "Validates authentication and session handling. Triggers: auth code, login, session, token. Ensures secure auth implementation."
+description: "AUTOMATICALLY invoke when implementing auth or session code. Triggers: auth code, login, session, token, JWT. Validates authentication and session handling. PROACTIVELY ensures secure auth implementation."
 model: sonnet
 tools: Read, Grep, Glob
 skills: security-scan

package/template/.claude/agents/06-security/input-sanitizer.md

@@ -1,8 +1,9 @@
 ---
 name: input-sanitizer
-description: "Validates input sanitization. Triggers: user input, form data, API input. Ensures proper input validation and sanitization."
+description: "AUTOMATICALLY invoke when handling user input. Triggers: user input, form data, API input, query params. Validates input sanitization. PROACTIVELY ensures proper input validation and sanitization."
 model: haiku
 tools: Read, Grep, Glob
+skills: security-scan, zod-validation
 ---
 
 # Input Sanitizer Agent

package/template/.claude/agents/06-security/owasp-checker.md

@@ -1,6 +1,6 @@
 ---
 name: owasp-checker
-description: "Checks OWASP Top 10 vulnerabilities. Triggers: security review, new API endpoint. Validates against common vulnerability patterns."
+description: "AUTOMATICALLY invoke BEFORE committing any API or security code. Triggers: security review, new API endpoint, auth changes. Checks OWASP Top 10 vulnerabilities. PROACTIVELY validates against common vulnerability patterns."
 model: sonnet
 tools: Read, Grep, Glob
 skills: security-scan

package/template/.claude/agents/06-security/permission-auditor.md

@@ -1,8 +1,9 @@
 ---
 name: permission-auditor
-description: "Audits permission and authorization. Triggers: protected routes, role-based access, resource ownership. Ensures proper access control."
+description: "AUTOMATICALLY invoke when implementing protected routes. Triggers: protected routes, role-based access, resource ownership. Audits permission and authorization. PROACTIVELY ensures proper access control."
 model: haiku
 tools: Read, Grep, Glob
+skills: security-scan
 ---
 
 # Permission Auditor Agent

package/template/.claude/agents/06-security/security-auditor.md

@@ -1,6 +1,6 @@
 ---
 name: security-auditor
-description: "VETO POWER. Audits security for all code changes. Triggers: auth, session, user data, passwords, tokens, API routes. MUST block insecure code."
+description: "AUTOMATICALLY invoke BEFORE committing any code that touches auth, user data, or APIs. Triggers: auth, session, user data, passwords, tokens, API routes. VETO POWER - MUST block insecure code. PROACTIVELY audits security for all code changes."
 model: opus
 tools: Read, Grep, Glob, Bash
 skills: security-scan

package/template/.claude/agents/06-security/sensitive-data-scanner.md

@@ -1,8 +1,9 @@
 ---
 name: sensitive-data-scanner
-description: "Scans for sensitive data exposure. Triggers: API response, logging, error handling. Detects potential data leaks."
+description: "AUTOMATICALLY invoke when implementing API responses or logging. Triggers: API response, logging, error handling, data serialization. Scans for sensitive data exposure. PROACTIVELY detects potential data leaks."
 model: haiku
 tools: Read, Grep, Glob
+skills: security-scan
 ---
 
 # Sensitive Data Scanner Agent

package/template/.claude/agents/07-documentation/api-documenter.md

@@ -1,8 +1,9 @@
 ---
 name: api-documenter
-description: "Documents API endpoints. Triggers: new API route, endpoint changes. Creates OpenAPI/Swagger compatible documentation."
+description: "AUTOMATICALLY invoke AFTER creating or modifying API endpoints. Triggers: new API route, endpoint changes, API implementation complete. Documents API endpoints with OpenAPI/Swagger. PROACTIVELY creates API documentation."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docs-tracker
 ---
 
 # API Documenter Agent

package/template/.claude/agents/07-documentation/changelog-manager.md

@@ -1,8 +1,9 @@
 ---
 name: changelog-manager
-description: "Manages project changelog. Triggers: new feature, bug fix, release. Maintains CHANGELOG.md following Keep a Changelog format."
+description: "AUTOMATICALLY invoke BEFORE committing any feature or fix. Triggers: new feature, bug fix, release, implementation complete. Manages CHANGELOG.md following Keep a Changelog format. PROACTIVELY maintains project changelog."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docs-tracker
 ---
 
 # Changelog Manager Agent

package/template/.claude/agents/07-documentation/documenter.md

@@ -1,6 +1,6 @@
 ---
 name: documenter
-description: "Creates and maintains documentation. Triggers: code implementation complete, new files created. Detects changes via git diff, updates domains, maintains changelog."
+description: "AUTOMATICALLY invoke AFTER any code implementation completes. Triggers: code was written/edited, new files created, feature implemented. Detects changes via git diff, updates domain files, maintains changelog. PROACTIVELY runs after tester agent completes."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob, Bash
 skills: docs-tracker, codebase-knowledge

package/template/.claude/agents/07-documentation/domain-updater.md

@@ -1,6 +1,6 @@
 ---
 name: domain-updater
-description: "Updates domain documentation with session learnings. Runs BEFORE commit-manager. Records problems, solutions, prevention tips."
+description: "AUTOMATICALLY invoke BEFORE commit-manager at session end. Triggers: implementation complete, problems solved, learnings to record. Updates domain documentation with session learnings. PROACTIVELY records problems, solutions, prevention tips."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
 skills: codebase-knowledge, docs-tracker

package/template/.claude/agents/07-documentation/jsdoc-generator.md

@@ -1,8 +1,9 @@
 ---
 name: jsdoc-generator
-description: "Generates JSDoc comments for code. Triggers: new function, complex code, 'add docs'. Creates TypeScript-aware documentation."
+description: "AUTOMATICALLY invoke when complex functions lack documentation. Triggers: new function, complex code, exported function without docs. Generates JSDoc comments. PROACTIVELY creates TypeScript-aware documentation."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docs-tracker, typescript-strict
 ---
 
 # JSDoc Generator Agent