start-vibing 2.0.3 → 2.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "start-vibing",
-  "version": "2.0.3",
+  "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

@@ -3,6 +3,7 @@ name: checkpoint-manager
 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

@@ -3,6 +3,7 @@ name: context-manager
 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

@@ -3,6 +3,7 @@ name: error-recovery
 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/parallel-coordinator.md

@@ -3,6 +3,7 @@ name: parallel-coordinator
 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/workflow-router.md

@@ -3,6 +3,7 @@ name: workflow-router
 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

@@ -3,6 +3,7 @@ name: bun-runtime-expert
 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

@@ -3,6 +3,7 @@ name: esm-resolver
 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

@@ -3,6 +3,7 @@ name: import-alias-enforcer
 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

@@ -3,6 +3,7 @@ name: ts-migration-helper
 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

@@ -3,6 +3,7 @@ name: ts-strict-checker
 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

@@ -3,6 +3,7 @@ name: ts-types-analyzer
 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

@@ -3,6 +3,7 @@ name: type-definition-writer
 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

@@ -3,7 +3,7 @@ name: zod-schema-designer
 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

@@ -3,6 +3,7 @@ name: zod-validator
 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

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

@@ -1,8 +1,9 @@
 ---
 name: readme-generator
-description: "Generates and updates README files. Triggers: new project, major changes, 'update readme'. Creates comprehensive project documentation."
+description: "AUTOMATICALLY invoke when project structure changes significantly. Triggers: new project, major changes, new features added. Generates and updates README files. PROACTIVELY creates comprehensive project documentation."
 model: haiku
 tools: Read, Write, Edit, Grep, Glob
+skills: docs-tracker
 ---
 
 # README Generator Agent

package/template/.claude/agents/08-git/branch-manager.md

@@ -1,8 +1,9 @@
 ---
 name: branch-manager
-description: "Manages git branches. Triggers: 'branch', 'feature branch', 'create branch'. Creates and manages feature/fix branches."
+description: "AUTOMATICALLY invoke BEFORE making source changes on main branch. Triggers: source changes on main, new feature starting, bug fix starting. Creates and manages feature/fix branches. PROACTIVELY ensures proper branch workflow."
 model: haiku
 tools: Bash, Read
+skills: git-workflow
 ---
 
 # Branch Manager Agent

package/template/.claude/agents/08-git/commit-manager.md

@@ -1,9 +1,9 @@
 ---
 name: commit-manager
-description: "FINAL AGENT in workflow. Triggers: 'commit', 'push', 'finalize'. Creates conventional commits, updates tracking. Runs AFTER domain-updater."
+description: "AUTOMATICALLY invoke as FINAL AGENT when implementation is complete. Triggers: 'commit', 'push', 'finalize', implementation done. Creates conventional commits, updates tracking. PROACTIVELY runs AFTER domain-updater."
 model: haiku
 tools: Read, Write, Edit, Bash, Grep, Glob
-skills: docs-tracker, codebase-knowledge
+skills: docs-tracker, codebase-knowledge, git-workflow
 ---
 
 # Commit Manager Agent

package/template/.claude/agents/08-git/pr-creator.md

@@ -1,8 +1,9 @@
 ---
 name: pr-creator
-description: "Creates pull requests. Triggers: 'create PR', 'pull request', ready to merge. Creates well-formatted PRs with gh CLI."
+description: "AUTOMATICALLY invoke AFTER commit-manager when feature is ready. Triggers: feature complete, 'create PR', ready to merge. Creates well-formatted PRs with gh CLI. PROACTIVELY creates PRs after committing."
 model: haiku
 tools: Bash, Read, Grep
+skills: git-workflow
 ---
 
 # PR Creator Agent

package/template/.claude/agents/09-quality/code-reviewer.md

@@ -1,8 +1,9 @@
 ---
 name: code-reviewer
-description: "Reviews code quality. Triggers: 'review', 'check code', PR review. Reviews patterns, readability, maintainability."
+description: "AUTOMATICALLY invoke AFTER significant code is written. Triggers: 'review', implementation complete, PR review, significant code added. Reviews patterns, readability, maintainability. PROACTIVELY reviews code quality."
 model: sonnet
 tools: Read, Grep, Glob
+skills: quality-gate, codebase-knowledge
 ---
 
 # Code Reviewer Agent