@ngxtm/devkit 3.6.1 → 3.8.0

package/merged-commands/api-testing-observability-api-mock.md

@@ -0,0 +1,46 @@
+---
+name: api-testing-observability-api-mock
+description: "You are an API mocking expert specializing in realistic mock services for development, testing, and demos. Design mocks that simulate real API behavior and enable parallel development."
+---
+
+# API Mocking Framework
+
+You are an API mocking expert specializing in creating realistic mock services for development, testing, and demonstration purposes. Design comprehensive mocking solutions that simulate real API behavior, enable parallel development, and facilitate thorough testing.
+
+## Use this skill when
+
+- Building mock APIs for frontend or integration testing
+- Simulating partner or third-party APIs during development
+- Creating demo environments with realistic responses
+- Validating API contracts before backend completion
+
+## Do not use this skill when
+
+- You need to test production systems or live integrations
+- The task is security testing or penetration testing
+- There is no API contract or expected behavior to mock
+
+## Safety
+
+- Avoid reusing production secrets or real customer data in mocks.
+- Make mock endpoints clearly labeled to prevent accidental use.
+
+## Context
+
+The user needs to create mock APIs for development, testing, or demonstration purposes. Focus on creating flexible, realistic mocks that accurately simulate production API behavior while enabling efficient development workflows.
+
+## Requirements
+
+$ARGUMENTS
+
+## Instructions
+
+- Clarify the API contract, auth flows, error shapes, and latency expectations.
+- Define mock routes, scenarios, and state transitions before generating responses.
+- Provide deterministic fixtures with optional randomness toggles.
+- Document how to run the mock server and how to switch scenarios.
+- If detailed implementation is requested, open `resources/implementation-playbook.md`.
+
+## Resources
+
+- `resources/implementation-playbook.md` for code samples, checklists, and templates.

package/merged-commands/app-builder.md

@@ -0,0 +1,75 @@
+---
+name: app-builder
+description: Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent
+---
+
+# App Builder - Application Building Orchestrator
+
+> Analyzes user's requests, determines tech stack, plans structure, and coordinates agents.
+
+## 🎯 Selective Reading Rule
+
+**Read ONLY files relevant to the request!** Check the content map, find what you need.
+
+| File | Description | When to Read |
+|------|-------------|--------------|
+| `project-detection.md` | Keyword matrix, project type detection | Starting new project |
+| `tech-stack.md` | 2025 default stack, alternatives | Choosing technologies |
+| `agent-coordination.md` | Agent pipeline, execution order | Coordinating multi-agent work |
+| `scaffolding.md` | Directory structure, core files | Creating project structure |
+| `feature-building.md` | Feature analysis, error handling | Adding features to existing project |
+| `templates/SKILL.md` | **Project templates** | Scaffolding new project |
+
+---
+
+## 📦 Templates (13)
+
+Quick-start scaffolding for new projects. **Read the matching template only!**
+
+| Template | Tech Stack | When to Use |
+|----------|------------|-------------|
+| [nextjs-fullstack](templates/nextjs-fullstack/TEMPLATE.md) | Next.js + Prisma | Full-stack web app |
+| [nextjs-saas](templates/nextjs-saas/TEMPLATE.md) | Next.js + Stripe | SaaS product |
+| [nextjs-static](templates/nextjs-static/TEMPLATE.md) | Next.js + Framer | Landing page |
+| [nuxt-app](templates/nuxt-app/TEMPLATE.md) | Nuxt 3 + Pinia | Vue full-stack app |
+| [express-api](templates/express-api/TEMPLATE.md) | Express + JWT | REST API |
+| [python-fastapi](templates/python-fastapi/TEMPLATE.md) | FastAPI | Python API |
+| [react-native-app](templates/react-native-app/TEMPLATE.md) | Expo + Zustand | Mobile app |
+| [flutter-app](templates/flutter-app/TEMPLATE.md) | Flutter + Riverpod | Cross-platform mobile |
+| [electron-desktop](templates/electron-desktop/TEMPLATE.md) | Electron + React | Desktop app |
+| [chrome-extension](templates/chrome-extension/TEMPLATE.md) | Chrome MV3 | Browser extension |
+| [cli-tool](templates/cli-tool/TEMPLATE.md) | Node.js + Commander | CLI app |
+| [monorepo-turborepo](templates/monorepo-turborepo/TEMPLATE.md) | Turborepo + pnpm | Monorepo |
+
+---
+
+## 🔗 Related Agents
+
+| Agent | Role |
+|-------|------|
+| `project-planner` | Task breakdown, dependency graph |
+| `frontend-specialist` | UI components, pages |
+| `backend-specialist` | API, business logic |
+| `database-architect` | Schema, migrations |
+| `devops-engineer` | Deployment, preview |
+
+---
+
+## Usage Example
+
+```
+User: "Make an Instagram clone with photo sharing and likes"
+
+App Builder Process:
+1. Project type: Social Media App
+2. Tech stack: Next.js + Prisma + Cloudinary + Clerk
+3. Create plan:
+   ├─ Database schema (users, posts, likes, follows)
+   ├─ API routes (12 endpoints)
+   ├─ Pages (feed, profile, upload)
+   └─ Components (PostCard, Feed, LikeButton)
+4. Coordinate agents
+5. Report progress
+6. Start preview
+```

package/merged-commands/app-store-optimization.md

@@ -0,0 +1,403 @@
+---
+name: app-store-optimization
+description: Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store
+---
+
+# App Store Optimization (ASO) Skill
+
+This comprehensive skill provides complete ASO capabilities for successfully launching and optimizing mobile applications on the Apple App Store and Google Play Store.
+
+## Capabilities
+
+### Research & Analysis
+- **Keyword Research**: Analyze keyword volume, competition, and relevance for app discovery
+- **Competitor Analysis**: Deep-dive into top-performing apps in your category
+- **Market Trend Analysis**: Identify emerging trends and opportunities in your app category
+- **Review Sentiment Analysis**: Extract insights from user reviews to identify strengths and issues
+- **Category Analysis**: Evaluate optimal category and subcategory placement strategies
+
+### Metadata Optimization
+- **Title Optimization**: Create compelling titles with optimal keyword placement (platform-specific character limits)
+- **Description Optimization**: Craft both short and full descriptions that convert and rank
+- **Subtitle/Promotional Text**: Optimize Apple-specific subtitle (30 chars) and promotional text (170 chars)
+- **Keyword Field**: Maximize Apple's 100-character keyword field with strategic selection
+- **Category Selection**: Data-driven recommendations for primary and secondary categories
+- **Icon Best Practices**: Guidelines for designing high-converting app icons
+- **Screenshot Optimization**: Strategies for creating screenshots that drive installs
+- **Preview Video**: Best practices for app preview videos
+- **Localization**: Multi-language optimization strategies for global reach
+
+### Conversion Optimization
+- **A/B Testing Framework**: Plan and track metadata experiments for continuous improvement
+- **Visual Asset Testing**: Test icons, screenshots, and videos for maximum conversion
+- **Store Listing Optimization**: Comprehensive page optimization for impression-to-install conversion
+- **Call-to-Action**: Optimize CTAs in descriptions and promotional materials
+
+### Rating & Review Management
+- **Review Monitoring**: Track and analyze user reviews for actionable insights
+- **Response Strategies**: Templates and best practices for responding to reviews
+- **Rating Improvement**: Tactical approaches to improve app ratings organically
+- **Issue Identification**: Surface common problems and feature requests from reviews
+
+### Launch & Update Strategies
+- **Pre-Launch Checklist**: Complete validation before submitting to stores
+- **Launch Timing**: Optimize release timing for maximum visibility and downloads
+- **Update Cadence**: Plan optimal update frequency and feature rollouts
+- **Feature Announcements**: Craft "What's New" sections that re-engage users
+- **Seasonal Optimization**: Leverage seasonal trends and events
+
+### Analytics & Tracking
+- **ASO Score**: Calculate overall ASO health score across multiple factors
+- **Keyword Rankings**: Track keyword position changes over time
+- **Conversion Metrics**: Monitor impression-to-install conversion rates
+- **Download Velocity**: Track download trends and momentum
+- **Performance Benchmarking**: Compare against category averages and competitors
+
+### Platform-Specific Requirements
+- **Apple App Store**:
+  - Title: 30 characters
+  - Subtitle: 30 characters
+  - Promotional Text: 170 characters (editable without app update)
+  - Description: 4,000 characters
+  - Keywords: 100 characters (comma-separated, no spaces)
+  - What's New: 4,000 characters
+- **Google Play Store**:
+  - Title: 50 characters (formerly 30, increased in 2021)
+  - Short Description: 80 characters
+  - Full Description: 4,000 characters
+  - No separate keyword field (keywords extracted from title and description)
+
+## Input Requirements
+
+### Keyword Research
+```json
+{
+  "app_name": "MyApp",
+  "category": "Productivity",
+  "target_keywords": ["task manager", "productivity", "todo list"],
+  "competitors": ["Todoist", "Any.do", "Microsoft To Do"],
+  "language": "en-US"
+}
+```
+
+### Metadata Optimization
+```json
+{
+  "platform": "apple" | "google",
+  "app_info": {
+    "name": "MyApp",
+    "category": "Productivity",
+    "target_audience": "Professionals aged 25-45",
+    "key_features": ["Task management", "Team collaboration", "AI assistance"],
+    "unique_value": "AI-powered task prioritization"
+  },
+  "current_metadata": {
+    "title": "Current Title",
+    "subtitle": "Current Subtitle",
+    "description": "Current description..."
+  },
+  "target_keywords": ["productivity", "task manager", "todo"]
+}
+```
+
+### Review Analysis
+```json
+{
+  "app_id": "com.myapp.app",
+  "platform": "apple" | "google",
+  "date_range": "last_30_days" | "last_90_days" | "all_time",
+  "rating_filter": [1, 2, 3, 4, 5],
+  "language": "en"
+}
+```
+
+### ASO Score Calculation
+```json
+{
+  "metadata": {
+    "title_quality": 0.8,
+    "description_quality": 0.7,
+    "keyword_density": 0.6
+  },
+  "ratings": {
+    "average_rating": 4.5,
+    "total_ratings": 15000
+  },
+  "conversion": {
+    "impression_to_install": 0.05
+  },
+  "keyword_rankings": {
+    "top_10": 5,
+    "top_50": 12,
+    "top_100": 18
+  }
+}
+```
+
+## Output Formats
+
+### Keyword Research Report
+- List of recommended keywords with search volume estimates
+- Competition level analysis (low/medium/high)
+- Relevance scores for each keyword
+- Strategic recommendations for primary vs. secondary keywords
+- Long-tail keyword opportunities
+
+### Optimized Metadata Package
+- Platform-specific title (with character count validation)
+- Subtitle/promotional text (Apple)
+- Short description (Google)
+- Full description (both platforms)
+- Keyword field (Apple - 100 chars)
+- Character count validation for all fields
+- Keyword density analysis
+- Before/after comparison
+
+### Competitor Analysis Report
+- Top 10 competitors in category
+- Their metadata strategies
+- Keyword overlap analysis
+- Visual asset assessment
+- Rating and review volume comparison
+- Identified gaps and opportunities
+
+### ASO Health Score
+- Overall score (0-100)
+- Category breakdown:
+  - Metadata Quality (0-25)
+  - Ratings & Reviews (0-25)
+  - Keyword Performance (0-25)
+  - Conversion Metrics (0-25)
+- Specific improvement recommendations
+- Priority action items
+
+### A/B Test Plan
+- Hypothesis and test variables
+- Test duration recommendations
+- Success metrics definition
+- Sample size calculations
+- Statistical significance thresholds
+
+### Launch Checklist
+- Pre-submission validation (all required assets, metadata)
+- Store compliance verification
+- Testing checklist (devices, OS versions)
+- Marketing preparation items
+- Post-launch monitoring plan
+
+## How to Use
+
+### Keyword Research
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you research the best keywords for a productivity app targeting professionals? Focus on keywords with good search volume but lower competition.
+```
+
+### Optimize App Store Listing
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you optimize my app's metadata for the Apple App Store? Here's my current listing: [provide current metadata]. I want to rank for "task management" and "productivity tools".
+```
+
+### Analyze Competitor Strategy
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you analyze the ASO strategies of Todoist, Any.do, and Microsoft To Do? I want to understand what they're doing well and where there are opportunities.
+```
+
+### Review Sentiment Analysis
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you analyze recent reviews for my app (com.myapp.ios) and identify the most common user complaints and feature requests?
+```
+
+### Calculate ASO Score
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you calculate my app's overall ASO health score and provide specific recommendations for improvement?
+```
+
+### Plan A/B Test
+```
+Hey Claude—I just added the "app-store-optimization" skill. I want to A/B test my app icon and first screenshot. Can you help me design the test and determine how long to run it?
+```
+
+### Pre-Launch Checklist
+```
+Hey Claude—I just added the "app-store-optimization" skill. Can you generate a comprehensive pre-launch checklist for submitting my app to both Apple App Store and Google Play Store?
+```
+
+## Scripts
+
+### keyword_analyzer.py
+Analyzes keywords for search volume, competition, and relevance. Provides strategic recommendations for primary and secondary keywords.
+
+**Key Functions:**
+- `analyze_keyword()`: Analyze single keyword metrics
+- `compare_keywords()`: Compare multiple keywords
+- `find_long_tail()`: Discover long-tail keyword opportunities
+- `calculate_keyword_difficulty()`: Assess competition level
+
+### metadata_optimizer.py
+Optimizes titles, descriptions, and keyword fields with platform-specific character limit validation.
+
+**Key Functions:**
+- `optimize_title()`: Create compelling, keyword-rich titles
+- `optimize_description()`: Generate conversion-focused descriptions
+- `optimize_keyword_field()`: Maximize Apple's 100-char keyword field
+- `validate_character_limits()`: Ensure compliance with platform limits
+- `calculate_keyword_density()`: Analyze keyword usage in metadata
+
+### competitor_analyzer.py
+Analyzes top competitors' ASO strategies and identifies opportunities.
+
+**Key Functions:**
+- `get_top_competitors()`: Identify category leaders
+- `analyze_competitor_metadata()`: Extract and analyze competitor keywords
+- `compare_visual_assets()`: Evaluate icons and screenshots
+- `identify_gaps()`: Find competitive opportunities
+
+### aso_scorer.py
+Calculates comprehensive ASO health score across multiple dimensions.
+
+**Key Functions:**
+- `calculate_overall_score()`: Compute 0-100 ASO score
+- `score_metadata_quality()`: Evaluate title, description, keywords
+- `score_ratings_reviews()`: Assess rating quality and volume
+- `score_keyword_performance()`: Analyze ranking positions
+- `score_conversion_metrics()`: Evaluate impression-to-install rates
+- `generate_recommendations()`: Provide prioritized action items
+
+### ab_test_planner.py
+Plans and tracks A/B tests for metadata and visual assets.
+
+**Key Functions:**
+- `design_test()`: Create test hypothesis and variables
+- `calculate_sample_size()`: Determine required test duration
+- `calculate_significance()`: Assess statistical significance
+- `track_results()`: Monitor test performance
+- `generate_report()`: Summarize test outcomes
+
+### localization_helper.py
+Manages multi-language ASO optimization strategies.
+
+**Key Functions:**
+- `identify_target_markets()`: Recommend localization priorities
+- `translate_metadata()`: Generate localized metadata
+- `adapt_keywords()`: Research locale-specific keywords
+- `validate_translations()`: Check character limits per language
+- `calculate_localization_roi()`: Estimate impact of localization
+
+### review_analyzer.py
+Analyzes user reviews for sentiment, issues, and feature requests.
+
+**Key Functions:**
+- `analyze_sentiment()`: Calculate positive/negative/neutral ratios
+- `extract_common_themes()`: Identify frequently mentioned topics
+- `identify_issues()`: Surface bugs and user complaints
+- `find_feature_requests()`: Extract desired features
+- `track_sentiment_trends()`: Monitor sentiment over time
+- `generate_response_templates()`: Create review response drafts
+
+### launch_checklist.py
+Generates comprehensive pre-launch and update checklists.
+
+**Key Functions:**
+- `generate_prelaunch_checklist()`: Complete submission validation
+- `validate_app_store_compliance()`: Check Apple guidelines
+- `validate_play_store_compliance()`: Check Google policies
+- `create_update_plan()`: Plan update cadence and features
+- `optimize_launch_timing()`: Recommend release dates
+- `plan_seasonal_campaigns()`: Identify seasonal opportunities
+
+## Best Practices
+
+### Keyword Research
+1. **Volume vs. Competition**: Balance high-volume keywords with achievable rankings
+2. **Relevance First**: Only target keywords genuinely relevant to your app
+3. **Long-Tail Strategy**: Include 3-4 word phrases with lower competition
+4. **Continuous Research**: Keyword trends change—research quarterly
+5. **Competitor Keywords**: Don't copy blindly; ensure relevance to your features
+
+### Metadata Optimization
+1. **Front-Load Keywords**: Place most important keywords early in title/description
+2. **Natural Language**: Write for humans first, SEO second
+3. **Feature Benefits**: Focus on user benefits, not just features
+4. **A/B Test Everything**: Test titles, descriptions, screenshots systematically
+5. **Update Regularly**: Refresh metadata every major update
+6. **Character Limits**: Use every character—don't waste valuable space
+7. **Apple Keyword Field**: No plurals, duplicates, or spaces between commas
+
+### Visual Assets
+1. **Icon**: Must be recognizable at small sizes (60x60px)
+2. **Screenshots**: First 2-3 are critical—most users don't scroll
+3. **Captions**: Use screenshot captions to tell your value story
+4. **Consistency**: Match visual style to app design
+5. **A/B Test Icons**: Icon is the single most important visual element
+
+### Reviews & Ratings
+1. **Respond Quickly**: Reply to reviews within 24-48 hours
+2. **Professional Tone**: Always courteous, even with negative reviews
+3. **Address Issues**: Show you're actively fixing reported problems
+4. **Thank Supporters**: Acknowledge positive reviews
+5. **Prompt Strategically**: Ask for ratings after positive experiences
+
+### Launch Strategy
+1. **Soft Launch**: Consider launching in smaller markets first
+2. **PR Timing**: Coordinate press coverage with launch
+3. **Update Frequently**: Initial updates signal active development
+4. **Monitor Closely**: Track metrics daily for first 2 weeks
+5. **Iterate Quickly**: Fix critical issues immediately
+
+### Localization
+1. **Prioritize Markets**: Start with English, Spanish, Chinese, French, German
+2. **Native Speakers**: Use professional translators, not machine translation
+3. **Cultural Adaptation**: Some features resonate differently by culture
+4. **Test Locally**: Have native speakers review before publishing
+5. **Measure ROI**: Track downloads by locale to assess impact
+
+## Limitations
+
+### Data Dependencies
+- Keyword search volume estimates are approximate (no official data from Apple/Google)
+- Competitor data may be incomplete for private apps
+- Review analysis limited to public reviews (can't access private feedback)
+- Historical data may not be available for new apps
+
+### Platform Constraints
+- Apple App Store keyword changes require app submission (except Promotional Text)
+- Google Play Store metadata changes take 1-2 hours to index
+- A/B testing requires significant traffic for statistical significance
+- Store algorithms are proprietary and change without notice
+
+### Industry Variability
+- ASO benchmarks vary significantly by category (games vs. utilities)
+- Seasonality affects different categories differently
+- Geographic markets have different competitive landscapes
+- Cultural preferences impact what works in different countries
+
+### Scope Boundaries
+- Does not include paid user acquisition strategies (Apple Search Ads, Google Ads)
+- Does not cover app development or UI/UX optimization
+- Does not include app analytics implementation (use Firebase, Mixpanel, etc.)
+- Does not handle app submission technical issues (provisioning profiles, certificates)
+
+### When NOT to Use This Skill
+- For web apps (different SEO strategies apply)
+- For enterprise apps not in public stores
+- For apps in beta/TestFlight only
+- If you need paid advertising strategies (use marketing skills instead)
+
+## Integration with Other Skills
+
+This skill works well with:
+- **Content Strategy Skills**: For creating app descriptions and marketing copy
+- **Analytics Skills**: For analyzing download and engagement data
+- **Localization Skills**: For managing multi-language content
+- **Design Skills**: For creating optimized visual assets
+- **Marketing Skills**: For coordinating broader launch campaigns
+
+## Version & Updates
+
+This skill is based on current Apple App Store and Google Play Store requirements as of November 2025. Store policies and best practices evolve—verify current requirements before major launches.
+
+**Key Updates to Monitor:**
+- Apple App Store Connect updates (apple.com/app-store/review/guidelines)
+- Google Play Console updates (play.google.com/console/about/guides/releasewithconfidence)
+- iOS/Android version adoption rates (affects device testing)
+- Store algorithm changes (follow ASO blogs and communities)

package/merged-commands/application-performance-performance-optimization.md

@@ -0,0 +1,154 @@
+---
+name: application-performance-performance-optimization
+description: "Optimize end-to-end application performance with profiling, observability, and backend/frontend tuning. Use when coordinating performance optimization across the stack."
+---
+
+Optimize application performance end-to-end using specialized performance and optimization agents:
+
+[Extended thinking: This workflow orchestrates a comprehensive performance optimization process across the entire application stack. Starting with deep profiling and baseline establishment, the workflow progresses through targeted optimizations in each system layer, validates improvements through load testing, and establishes continuous monitoring for sustained performance. Each phase builds on insights from previous phases, creating a data-driven optimization strategy that addresses real bottlenecks rather than theoretical improvements. The workflow emphasizes modern observability practices, user-centric performance metrics, and cost-effective optimization strategies.]
+
+## Use this skill when
+
+- Coordinating performance optimization across backend, frontend, and infrastructure
+- Establishing baselines and profiling to identify bottlenecks
+- Designing load tests, performance budgets, or capacity plans
+- Building observability for performance and reliability targets
+
+## Do not use this skill when
+
+- The task is a small localized fix with no broader performance goals
+- There is no access to metrics, tracing, or profiling data
+- The request is unrelated to performance or scalability
+
+## Instructions
+
+1. Confirm performance goals, constraints, and target metrics.
+2. Establish baselines with profiling, tracing, and real-user data.
+3. Execute phased optimizations across the stack with measurable impact.
+4. Validate improvements and set guardrails to prevent regressions.
+
+## Safety
+
+- Avoid load testing production without approvals and safeguards.
+- Roll out performance changes gradually with rollback plans.
+
+## Phase 1: Performance Profiling & Baseline
+
+### 1. Comprehensive Performance Profiling
+
+- Use Task tool with subagent_type="performance-engineer"
+- Prompt: "Profile application performance comprehensively for: $ARGUMENTS. Generate flame graphs for CPU usage, heap dumps for memory analysis, trace I/O operations, and identify hot paths. Use APM tools like DataDog or New Relic if available. Include database query profiling, API response times, and frontend rendering metrics. Establish performance baselines for all critical user journeys."
+- Context: Initial performance investigation
+- Output: Detailed performance profile with flame graphs, memory analysis, bottleneck identification, baseline metrics
+
+### 2. Observability Stack Assessment
+
+- Use Task tool with subagent_type="observability-engineer"
+- Prompt: "Assess current observability setup for: $ARGUMENTS. Review existing monitoring, distributed tracing with OpenTelemetry, log aggregation, and metrics collection. Identify gaps in visibility, missing metrics, and areas needing better instrumentation. Recommend APM tool integration and custom metrics for business-critical operations."
+- Context: Performance profile from step 1
+- Output: Observability assessment report, instrumentation gaps, monitoring recommendations
+
+### 3. User Experience Analysis
+
+- Use Task tool with subagent_type="performance-engineer"
+- Prompt: "Analyze user experience metrics for: $ARGUMENTS. Measure Core Web Vitals (LCP, FID, CLS), page load times, time to interactive, and perceived performance. Use Real User Monitoring (RUM) data if available. Identify user journeys with poor performance and their business impact."
+- Context: Performance baselines from step 1
+- Output: UX performance report, Core Web Vitals analysis, user impact assessment
+
+## Phase 2: Database & Backend Optimization
+
+### 4. Database Performance Optimization
+
+- Use Task tool with subagent_type="database-cloud-optimization::database-optimizer"
+- Prompt: "Optimize database performance for: $ARGUMENTS based on profiling data: {context_from_phase_1}. Analyze slow query logs, create missing indexes, optimize execution plans, implement query result caching with Redis/Memcached. Review connection pooling, prepared statements, and batch processing opportunities. Consider read replicas and database sharding if needed."
+- Context: Performance bottlenecks from phase 1
+- Output: Optimized queries, new indexes, caching strategy, connection pool configuration
+
+### 5. Backend Code & API Optimization
+
+- Use Task tool with subagent_type="backend-development::backend-architect"
+- Prompt: "Optimize backend services for: $ARGUMENTS targeting bottlenecks: {context_from_phase_1}. Implement efficient algorithms, add application-level caching, optimize N+1 queries, use async/await patterns effectively. Implement pagination, response compression, GraphQL query optimization, and batch API operations. Add circuit breakers and bulkheads for resilience."
+- Context: Database optimizations from step 4, profiling data from phase 1
+- Output: Optimized backend code, caching implementation, API improvements, resilience patterns
+
+### 6. Microservices & Distributed System Optimization
+
+- Use Task tool with subagent_type="performance-engineer"
+- Prompt: "Optimize distributed system performance for: $ARGUMENTS. Analyze service-to-service communication, implement service mesh optimizations, optimize message queue performance (Kafka/RabbitMQ), reduce network hops. Implement distributed caching strategies and optimize serialization/deserialization."
+- Context: Backend optimizations from step 5
+- Output: Service communication improvements, message queue optimization, distributed caching setup
+
+## Phase 3: Frontend & CDN Optimization
+
+### 7. Frontend Bundle & Loading Optimization
+
+- Use Task tool with subagent_type="frontend-developer"
+- Prompt: "Optimize frontend performance for: $ARGUMENTS targeting Core Web Vitals: {context_from_phase_1}. Implement code splitting, tree shaking, lazy loading, and dynamic imports. Optimize bundle sizes with webpack/rollup analysis. Implement resource hints (prefetch, preconnect, preload). Optimize critical rendering path and eliminate render-blocking resources."
+- Context: UX analysis from phase 1, backend optimizations from phase 2
+- Output: Optimized bundles, lazy loading implementation, improved Core Web Vitals
+
+### 8. CDN & Edge Optimization
+
+- Use Task tool with subagent_type="cloud-infrastructure::cloud-architect"
+- Prompt: "Optimize CDN and edge performance for: $ARGUMENTS. Configure CloudFlare/CloudFront for optimal caching, implement edge functions for dynamic content, set up image optimization with responsive images and WebP/AVIF formats. Configure HTTP/2 and HTTP/3, implement Brotli compression. Set up geographic distribution for global users."
+- Context: Frontend optimizations from step 7
+- Output: CDN configuration, edge caching rules, compression setup, geographic optimization
+
+### 9. Mobile & Progressive Web App Optimization
+
+- Use Task tool with subagent_type="frontend-mobile-development::mobile-developer"
+- Prompt: "Optimize mobile experience for: $ARGUMENTS. Implement service workers for offline functionality, optimize for slow networks with adaptive loading. Reduce JavaScript execution time for mobile CPUs. Implement virtual scrolling for long lists. Optimize touch responsiveness and smooth animations. Consider React Native/Flutter specific optimizations if applicable."
+- Context: Frontend optimizations from steps 7-8
+- Output: Mobile-optimized code, PWA implementation, offline functionality
+
+## Phase 4: Load Testing & Validation
+
+### 10. Comprehensive Load Testing
+
+- Use Task tool with subagent_type="performance-engineer"
+- Prompt: "Conduct comprehensive load testing for: $ARGUMENTS using k6/Gatling/Artillery. Design realistic load scenarios based on production traffic patterns. Test normal load, peak load, and stress scenarios. Include API testing, browser-based testing, and WebSocket testing if applicable. Measure response times, throughput, error rates, and resource utilization at various load levels."
+- Context: All optimizations from phases 1-3
+- Output: Load test results, performance under load, breaking points, scalability analysis
+
+### 11. Performance Regression Testing
+
+- Use Task tool with subagent_type="performance-testing-review::test-automator"
+- Prompt: "Create automated performance regression tests for: $ARGUMENTS. Set up performance budgets for key metrics, integrate with CI/CD pipeline using GitHub Actions or similar. Create Lighthouse CI tests for frontend, API performance tests with Artillery, and database performance benchmarks. Implement automatic rollback triggers for performance regressions."
+- Context: Load test results from step 10, baseline metrics from phase 1
+- Output: Performance test suite, CI/CD integration, regression prevention system
+
+## Phase 5: Monitoring & Continuous Optimization
+
+### 12. Production Monitoring Setup
+
+- Use Task tool with subagent_type="observability-engineer"
+- Prompt: "Implement production performance monitoring for: $ARGUMENTS. Set up APM with DataDog/New Relic/Dynatrace, configure distributed tracing with OpenTelemetry, implement custom business metrics. Create Grafana dashboards for key metrics, set up PagerDuty alerts for performance degradation. Define SLIs/SLOs for critical services with error budgets."
+- Context: Performance improvements from all previous phases
+- Output: Monitoring dashboards, alert rules, SLI/SLO definitions, runbooks
+
+### 13. Continuous Performance Optimization
+
+- Use Task tool with subagent_type="performance-engineer"
+- Prompt: "Establish continuous optimization process for: $ARGUMENTS. Create performance budget tracking, implement A/B testing for performance changes, set up continuous profiling in production. Document optimization opportunities backlog, create capacity planning models, and establish regular performance review cycles."
+- Context: Monitoring setup from step 12, all previous optimization work
+- Output: Performance budget tracking, optimization backlog, capacity planning, review process
+
+## Configuration Options
+
+- **performance_focus**: "latency" | "throughput" | "cost" | "balanced" (default: "balanced")
+- **optimization_depth**: "quick-wins" | "comprehensive" | "enterprise" (default: "comprehensive")
+- **tools_available**: ["datadog", "newrelic", "prometheus", "grafana", "k6", "gatling"]
+- **budget_constraints**: Set maximum acceptable costs for infrastructure changes
+- **user_impact_tolerance**: "zero-downtime" | "maintenance-window" | "gradual-rollout"
+
+## Success Criteria
+
+- **Response Time**: P50 < 200ms, P95 < 1s, P99 < 2s for critical endpoints
+- **Core Web Vitals**: LCP < 2.5s, FID < 100ms, CLS < 0.1
+- **Throughput**: Support 2x current peak load with <1% error rate
+- **Database Performance**: Query P95 < 100ms, no queries > 1s
+- **Resource Utilization**: CPU < 70%, Memory < 80% under normal load
+- **Cost Efficiency**: Performance per dollar improved by minimum 30%
+- **Monitoring Coverage**: 100% of critical paths instrumented with alerting
+
+Performance optimization target: $ARGUMENTS