agent-skill-kit 3.9.135

package/.agent/workflows/mobile.md

@@ -0,0 +1,354 @@
+---
+description: End-to-end mobile development — React Native, Flutter, or native iOS/Android with push notifications, deep linking, offline-first architecture, and app store submission.
+skills: [mobile-developer, idea-storm, mobile-design, security-scanner, cicd-pipeline, perf-optimizer, problem-checker, smart-router, knowledge-compiler, context-engineering]
+agents: [orchestrator, assessor, recovery, critic, learner, project-planner, mobile-developer, backend-specialist, security-auditor, test-engineer]
+---
+
+# /mobile - Mobile App Development
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Orchestrate mobile app development from concept to app store submission — supporting React Native, Flutter, and native iOS/Android with push notifications, deep linking, offline sync, and CI/CD pipeline. **Differs from `/build` (general web apps) and `/game` (game-specific concerns) by focusing on mobile-specific platform conventions, touch interaction, offline-first architecture, and store submission requirements.** Uses `mobile-developer` with `mobile-design` for cross-platform development, coordinated by `orchestrator` for parallel implementation tracks.
+
+---
+
+## ?? Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Pre-Flight** | `assessor` | Evaluate platform risks, MFRI score, and knowledge-compiler context |
+| **Execution** | `orchestrator` | Coordinate UI, API, push, and offline parallel tracks |
+| **Safety** | `recovery` | Save state and recover from major implementation failures |
+| **Conflict** | `critic` | Resolve cross-platform compatibility issues |
+| **Post-Build** | `learner` | Log mobile execution telemetry and build patterns |
+
+```
+Flow:
+assessor.evaluate(platform, MFRI) ? recovery.save()
+       ?
+orchestrator.parallel(UI, push, deeplink, offline)
+       ? conflict
+critic.resolve(iOS_vs_Android)
+       ?
+verify ? learner.log(patterns)
+```
+
+---
+
+## ?? MANDATORY: Mobile Development Protocol
+
+### Phase 1: Pre-flight & knowledge-compiler Context
+
+> **Rule 0.5-K:** knowledge-compiler pattern check.
+
+1. Read `.agent/skills/knowledge-compiler/patterns/` for past failures before proceeding.
+2. Trigger `recovery` agent to run Checkpoint (`git commit -m "chore(checkpoint): pre-mobile"`).
+
+### Phase 2: Requirements & Platform Selection
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | $ARGUMENTS (app concept description) |
+| **OUTPUT** | Requirements doc: platform, framework, navigation, offline strategy |
+| **AGENTS** | `project-planner`, `assessor` |
+| **SKILLS** | `mobile-developer`, `idea-storm`, `context-engineering` |
+
+// turbo — telemetry: phase-2-requirements
+
+1. Ask critical questions:
+
+| Question | Options | Impact |
+|----------|---------|--------|
+| Platform? | iOS / Android / Both | Build pipeline |
+| Framework? | React Native / Flutter / Native | Architecture |
+| Navigation? | Tabs / Drawer / Stack | UX pattern |
+| Offline? | Required / Nice-to-have / No | Sync architecture |
+| Devices? | Phone / Tablet / Both | Layout strategy |
+
+2. Calculate MFRI (Mobile Feasibility Risk Index) — MFRI < 3 ? Redesign
+3. `assessor` evaluates platform and framework risks
+
+### Phase 3: Design & Architecture
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Requirements doc from Phase 2 |
+| **OUTPUT** | UI design, platform conventions, component architecture |
+| **AGENTS** | `mobile-developer` |
+| **SKILLS** | `mobile-design`, `mobile-developer` |
+
+// turbo — telemetry: phase-3-design
+
+Platform conventions:
+
+| Aspect | iOS | Android |
+|--------|-----|---------|
+| Font | SF Pro | Roboto |
+| Touch target | =44pt | =48dp |
+| Back | Edge swipe | System back |
+| Navigation | Tab bar (bottom) | Bottom nav / drawer |
+
+### Phase 4: Core Implementation
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Design + architecture from Phase 3 |
+| **OUTPUT** | App scaffold with navigation, screens, and data layer |
+| **AGENTS** | `orchestrator`, `mobile-developer` |
+| **SKILLS** | `mobile-developer`, `smart-router` |
+
+// turbo — telemetry: phase-4-core
+
+1. Initialize project:
+
+| Framework | Command |
+|-----------|---------|
+| React Native | `npx create-expo-app@latest ./` |
+| Flutter | `flutter create .` |
+| iOS Native | SwiftUI project |
+| Android | Kotlin + Compose |
+
+2. Performance patterns:
+   - Lists: FlatList/FlashList (NEVER ScrollView for lists)
+   - Memoization: React.memo + useCallback / const widgets
+   - Images: Lazy load, cache, progressive quality
+   - Navigation: Lazy screens, pre-fetch next screen data
+
+### Phase 5: Mobile Features
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | App scaffold from Phase 4 |
+| **OUTPUT** | Push notifications, deep linking, offline sync integrated |
+| **AGENTS** | `mobile-developer`, `nodejs-pro` |
+| **SKILLS** | `mobile-developer` |
+
+// turbo — telemetry: phase-5-features
+
+**Push Notifications:**
+
+| Platform | Service |
+|----------|---------|
+| iOS | APNs via `@notifee/react-native` |
+| Android | FCM via `@react-native-firebase/messaging` |
+| Cross-platform | OneSignal |
+
+**Deep Linking:**
+
+| Platform | Config |
+|----------|--------|
+| iOS | apple-app-site-association in `/.well-known/` |
+| Android | `assetlinks.json` in `/.well-known/` |
+
+**Offline Sync (if required):**
+
+| Pattern | Use When |
+|---------|----------|
+| **Cache-first** | Read-heavy, eventual consistency OK |
+| **Optimistic UI** | Writes need instant feedback |
+| **Queue + retry** | Writes must not be lost |
+| **CRDT** | Multi-device conflict resolution |
+
+### Phase 6: Security & Quality
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Feature-complete app from Phase 5 |
+| **OUTPUT** | Security hardened: secure storage, cert pinning, biometrics |
+| **AGENTS** | `security-scanner` |
+| **SKILLS** | `security-scanner` |
+
+// turbo — telemetry: phase-6-security
+
+Security checklist:
+- [ ] Secure storage (Keychain / Keystore)
+- [ ] Certificate pinning
+- [ ] Biometric auth (Face ID / fingerprint)
+- [ ] No sensitive data in logs
+- [ ] Root/jailbreak detection
+
+### Phase 7: CI/CD & Store Submission
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Secured app from Phase 6 |
+| **OUTPUT** | Platform builds, store submission assets |
+| **AGENTS** | `mobile-developer` |
+| **SKILLS** | `mobile-developer`, `cicd-pipeline` |
+
+// turbo — telemetry: phase-7-cicd
+
+| Tool | Purpose |
+|------|---------|
+| **EAS Build** (Expo) | Cloud builds, OTA updates |
+| **Fastlane** | Automate screenshots, signing, upload |
+| **GitHub Actions** | CI pipeline, automated testing |
+
+| iOS App Store | Google Play |
+|--------------|-------------|
+| Privacy labels | Target current SDK |
+| Screenshots (all sizes) | 64-bit build |
+| App Transport Security | App bundle (AAB) |
+| TestFlight beta | Internal testing track |
+
+### Phase 8: Testing & Verification
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Built app from Phase 7 |
+| **OUTPUT** | Test results: crash-free rate, startup time, platform tests |
+| **AGENTS** | `test-architect`, `learner` |
+| **SKILLS** | `mobile-developer`, `perf-optimizer`, `problem-checker`, `knowledge-compiler` |
+
+// turbo — telemetry: phase-8-test
+```bash
+npx cross-env OTEL_SERVICE_NAME="workflow:mobile" TRACE_ID="$TRACE_ID" npm run test:mobile
+```
+
+Key metrics:
+- Crash-free rate: target > 99.5%
+- Cold start time: target < 2s
+- Screen load times, API latency
+- DAU/MAU, retention (D1/D7/D30)
+
+---
+
+## ? MANDATORY: Problem Verification Before Completion
+
+> **CRITICAL:** This check MUST be performed before any `notify_user` or task completion.
+
+### Check @[current_problems]
+
+```
+1. Read @[current_problems] from IDE
+2. If errors/warnings > 0:
+   a. Auto-fix: imports, types, lint errors
+   b. Re-check @[current_problems]
+   c. If still > 0 ? STOP ? Notify user
+3. If count = 0 ? Proceed to completion
+```
+
+### Auto-Fixable
+
+| Type | Fix |
+|------|-----|
+| Missing import | Add import statement |
+| Unused variable | Remove or prefix `_` |
+| Type mismatch | Fix type annotation |
+| Lint errors | Run eslint --fix |
+
+> **Rule:** Never mark complete with errors in `@[current_problems]`.
+
+---
+
+## ?? Rollback & Recovery
+
+If scaffolding or builds fail completely due to native dependencies or environment issues:
+1. Revert to safe checkpoint using `recovery` meta-agent.
+2. Trigger `diagnose` workflow to analyze framework/platform specific native errors (e.g. CocoaPods, Gradle).
+3. Do not proceed with execution until environment is stable.
+
+---
+
+## Output Format
+
+```markdown
+## ?? Mobile App Built: [App Name]
+
+### Configuration
+
+| Setting | Value |
+|---------|-------|
+| Platform | iOS + Android |
+| Framework | React Native (Expo) |
+| Navigation | Tab-based |
+| Offline | Cache-first |
+
+### Features
+
+| Feature | Status |
+|---------|--------|
+| Core screens | ? |
+| Push notifications | ? |
+| Deep linking | ? |
+| Offline sync | ? |
+| Security hardening | ? |
+| CI/CD pipeline | ? |
+
+### Performance
+
+| Metric | Target | Actual | Status |
+|--------|--------|--------|--------|
+| Cold start | <2s | 1.4s | ? |
+| Crash-free | >99.5% | 99.8% | ? |
+
+### Next Steps
+
+- [ ] Run TestFlight / internal testing
+- [ ] Run `/validate` for full test suite
+- [ ] Run `/launch` for store submission
+```
+
+---
+
+## Examples
+
+```
+/mobile fitness tracking app for iOS and Android with React Native
+/mobile e-commerce app with Flutter and offline cart
+/mobile social media app with push notifications and deep linking
+/mobile banking app with biometric auth and secure storage
+/mobile food delivery app with real-time tracking
+```
+
+---
+
+## Key Principles
+
+- **Platform-native feel** — respect iOS HIG and Material Design conventions
+- **Offline-first** — design for bad connectivity, don't assume always-online
+- **FlatList always** — never use ScrollView for lists, always FlatList/FlashList
+- **Permission timing** — show value before requesting permissions (notifications, location)
+- **Deep link from day one** — integrate universal/app links early, not as afterthought
+
+---
+
+## ?? Workflow Chain
+
+**Skills Loaded (10):**
+
+- `mobile-developer` - React Native/Flutter/native patterns
+- `mobile-design` - Platform-specific UI/UX conventions
+- `security-scanner` - Secure mobile coding practices
+- `idea-storm` - Requirements gathering
+- `cicd-pipeline` - Mobile CI/CD and store submission
+- `perf-optimizer` - Mobile performance profiling
+- `problem-checker` - IDE problem verification
+- `smart-router` - Dynamic agent routing
+- `context-engineering` - Codebase parsing and component mapping
+- `knowledge-compiler` - Learning and logging workflow patterns
+
+```mermaid
+graph LR
+    A["/plan"] --> B["/mobile"]
+    B --> C["/validate"]
+    C --> D["/launch"]
+    style B fill:#10b981
+```
+
+| After /mobile | Run | Purpose |
+|--------------|-----|---------|
+| Need testing | `/validate` | Run mobile test suite |
+| Performance tuning | `/optimize` | Profile and fix bottlenecks |
+| Ready to ship | `/launch` | App store submission |
+
+**Handoff to /validate:**
+
+```markdown
+?? Mobile app built! Platform: [platform], Framework: [framework].
+Features: [count] integrated. Run `/validate` to test or `/launch` to submit.
+```

package/.agent/workflows/monitor.md

@@ -0,0 +1,239 @@
+---
+description: Production observability stack — OpenTelemetry instrumentation, structured logging, Prometheus/Grafana dashboards, distributed tracing, and PagerDuty incident alerting.
+skills: [observability, server-ops, problem-checker, context-engineering, knowledge-compiler]
+agents: [orchestrator, assessor, recovery, learner, devops-engineer]
+---
+
+# /monitor - Production Observability
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+---
+
+# /monitor - Production Observability
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Set up production observability infrastructure — OpenTelemetry SDK, structured logging, Prometheus metrics, distributed tracing, and incident alerting with runbooks. **Differs from `/launch` (production deployment) and `/diagnose` (root cause analysis) by establishing the full observability foundation for production monitoring.** Uses `cicd-pipeline` with `observability` for instrumentation and `server-ops` for infrastructure configuration.
+
+---
+
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Pre-Flight** | `assessor` | Evaluate monitoring scope, providers, and knowledge-compiler patterns |
+| **Execution** | `orchestrator` | Coordinate OpenTelemetry, metrics, logs, traces, and alerts |
+| **Safety** | `recovery` | Save state checkpoint before infrastructure changes |
+| **Post-Setup** | `learner` | Log monitoring patterns for future setups |
+
+```
+Flow:
+assessor.evaluate(scope, provider) �’ recovery.save()
+       ↓
+setup OpenTelemetry �’ logs �’ metrics �’ traces �’ alerts
+       ↓
+learner.log(monitoring_patterns)
+```
+
+---
+
+## Sub-Commands
+
+| Command | Action |
+|---------|--------|
+| `/monitor` | Full observability setup (all 5 phases) |
+| `/monitor <app-name>` | Setup for specific application |
+| `/monitor --provider datadog` | Use specific provider |
+
+---
+
+## 🔴 MANDATORY: Observability Setup Protocol
+
+### Phase 0: Pre-flight & Auto-Learned Context
+
+> **Rule 0.5-K:** Auto-learned pattern check.
+
+1. Read `.agent/skills/auto-learned/patterns/` for past failures before proceeding.
+2. Trigger `recovery` agent to run Checkpoint (`git commit -m "chore(checkpoint): pre-monitor"`).
+
+### Phase 1: Pre-flight & knowledge-compiler Context
+
+> **Rule 0.5-K:** knowledge-compiler pattern check.
+
+1. Read `.agent/skills/knowledge-compiler/patterns/` for past failures before proceeding.
+2. Trigger `recovery` agent to run Checkpoint (`git commit -m "chore(checkpoint): pre-monitor"`).
+
+### Phase 2: Foundation (OpenTelemetry)
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | $ARGUMENTS (app name + optional provider/requirements) |
+| **OUTPUT** | OpenTelemetry SDK initialized, provider configured, auto-instrumentation enabled |
+| **AGENTS** | `cicd-pipeline`, `assessor` |
+| **SKILLS** | `observability`, `context-engineering` |
+
+// turbo — telemetry: phase-2-foundation
+
+1. `assessor` evaluates monitoring scope
+2. Select provider:
+
+| Provider | Use Case |
+|----------|----------|
+| **Datadog** | Full-stack monitoring |
+| **New Relic** | APM and infrastructure |
+| **Sentry** | Error tracking and performance |
+| **Grafana Cloud** | Open-source stack |
+| **Self-hosted** | Prometheus + Jaeger + Loki |
+
+3. Install OpenTelemetry SDK and configure exporters
+4. Enable auto-instrumentation (HTTP, DB, Redis)
+
+### Phase 3: Structured Logging
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | OpenTelemetry foundation from Phase 2 |
+| **OUTPUT** | Structured logger with PII masking, correlation IDs, cloud aggregation |
+| **AGENTS** | `orchestrator`, `cicd-pipeline` |
+| **SKILLS** | `observability` |
+
+// turbo — telemetry: phase-3-logging
+
+1. Setup Pino/Winston with JSON formatting
+2. Configure PII redaction (email, phone, SSN, credit card)
+3. Cloud aggregation (Datadog Logs, CloudWatch, Loki)
+4. Enable correlation IDs for request tracing
+
+### Phase 4: Metrics & Dashboards
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Logger from Phase 3 |
+| **OUTPUT** | Prometheus `/metrics` endpoint, Golden Signals dashboard |
+| **AGENTS** | `cicd-pipeline` |
+| **SKILLS** | `observability`, `server-ops` |
+
+// turbo — telemetry: phase-4-metrics
+
+1. Expose Prometheus `/metrics` endpoint
+2. Configure Golden Signals:
+
+| Signal | Metrics |
+|--------|---------|
+| **Latency** | p50, p95, p99 response times |
+| **Traffic** | Requests/sec |
+| **Errors** | Error rate (%) |
+| **Saturation** | CPU, memory usage |
+
+3. Add custom business metrics (signups, orders, revenue)
+4. Create Grafana/Datadog dashboard
+
+### Phase 5: Distributed Tracing (optional)
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Metrics from Phase 4 |
+| **OUTPUT** | Auto-instrumented traces with context propagation |
+| **AGENTS** | `cicd-pipeline` |
+| **SKILLS** | `observability` |
+
+1. Enable auto-instrumentation (HTTP, Prisma, Redis)
+2. Configure sampling (10% production, 100% dev)
+3. Enable W3C trace context propagation
+4. Verify traces visible in APM provider
+
+### Phase 6: Alerting & Incident Response
+
+| Field | Value |
+|-------|-------|
+| **INPUT** | Full observability stack from Phases 2-5 |
+| **OUTPUT** | Alert rules, Slack/PagerDuty integration, runbooks |
+| **AGENTS** | `cicd-pipeline`, `learner` |
+| **SKILLS** | `observability`, `server-ops`, `problem-checker`, `knowledge-compiler` |
+
+Default alert rules:
+
+| Alert | Threshold | Severity | Notification |
+|-------|-----------|----------|-------------|
+| High Error Rate | >1% for 5min | Critical | Slack + PagerDuty |
+| High Latency | p95 >500ms | High | Slack |
+| Health Check Failed | <100% | Critical | Slack + PagerDuty |
+| Memory Usage | >90% | High | Slack |
+| Database Timeout | >3 in 5min | High | Slack |
+
+Runbooks generated:
+- High error rate investigation
+- High latency debugging
+- Health check failure response
+- Database timeout resolution
+- Memory leak investigation
+
+---
+
+## ⛔ MANDATORY: Problem Verification Before Completion
+
+> **CRITICAL:** This check MUST be performed before any `notify_user` or task completion.
+
+### Check @[current_problems]
+
+```
+1. Read @[current_problems] from IDE
+2. If errors/warnings > 0:
+   a. Auto-fix: imports, types, lint errors
+   b. Re-check @[current_problems]
+   c. If still > 0 �’ STOP �’ Notify user
+3. If count = 0 �’ Proceed to completion
+```
+
+### Auto-Fixable
+
+| Type | Fix |
+|------|-----|
+| Missing import | Add import statement |
+| Type mismatch | Fix type annotation |
+| Lint errors | Run eslint --fix |
+
+> **Rule:** Never mark complete with errors in `@[current_problems]`.
+
+---
+
+## 🔙 Rollback & Recovery
+
+If observability setup causes application crashes or aggressive memory leaks:
+1. Revert infrastructure configs/SDK wrappers using `recovery` meta-agent.
+2. Remove any auto-instrumentation hooks from startup scripts.
+3. Fallback to previous safe state before generating Output Format.
+
+---
+
+## �— Workflow Chain
+
+```mermaid
+graph LR
+    A["/build"] --> B["/monitor"]
+    B --> C["/diagnose"]
+    B --> D["/launch"]
+    style B fill:#10b981
+```
+
+| After /monitor | Run | Purpose |
+|---------------|-----|---------|
+| Issues detected | `/diagnose` | Root cause analysis using traces |
+| Ready to deploy | `/launch` | Deploy with monitoring |
+| Performance issues | `/optimize` | Optimize using collected metrics |
+
+**Handoff to /diagnose:**
+
+```markdown
+📊 Monitoring configured! OpenTelemetry + logs + metrics + alerts active.
+Run `/diagnose` to investigate issues or `/launch` to deploy.
+```