@nockdev/awf 6.2.0

package/.agent/workflows/init.md

@@ -0,0 +1,148 @@
+---
+description: "✨ Initialize project with intelligent scaffolding, P0-P6 phases, and progress tracking"
+skills: { required: [], contextual: [auto] }
+---
+
+# ✨ /init — Init Pro
+
+> Intelligent Project Scaffolding
+> 📚 30+ Templates • P0-P6 Phases • Auto-Detection
+
+---
+
+## INITIALIZATION FLOW
+
+1. **DETECT** (Auto) — Parse user intent, detect existing project via HSA (`hsa_detect_stack`), infer stack from keywords
+2. **CONFIGURE** — Select template, choose architecture → ⛔ STOP: confirm before scaffold
+3. **SCAFFOLD** — Run init commands, create folder structure, generate base files
+4. **CONFIGURE** — Setup linting/formatting, git hooks, create .env.example
+5. **SYNC** — `hsa_check_changes` to update index after project creation
+6. **PLAN** — Generate P0-P6 implementation plan, show next steps, offer to start coding
+
+---
+
+## TEMPLATE REGISTRY
+
+### Backend / Systems
+
+```yaml
+# lang: architectures (default*) | init command | tools
+go: standard*, clean, hexagonal, ddd | go mod init {module} | golangci-lint, air, wire
+rust: cargo*, workspace, binary, library | cargo new {project} | clippy, rustfmt
+cpp: cmake*, single, library, vcpkg | cmake -S . -B build | cmake, clang-format
+c: make*, cmake, single | make init | gcc, clang, valgrind
+java: maven*, gradle, spring, clean | mvn archetype:generate | maven, gradle, spotless
+kotlin: android*, multiplatform, ktor, compose | gradle init | gradle, ktlint, detekt
+scala: sbt*, mill, akka | sbt new scala/scala-seed.g8
+csharp: clean*, mvvm, mvc, minimal, blazor | dotnet new webapi -n {project} | dotnet-format
+fsharp: console*, web, giraffe | dotnet new console -lang F#
+python: src*, flat, django, fastapi, flask | uv init {project} | ruff, mypy, uv
+ruby: rails*, sinatra, gem, cli | rails new {project} | rubocop, bundler
+php: laravel*, symfony, psr4, wordpress | composer create-project laravel/laravel {project} | php-cs-fixer
+perl: module*, script, mojolicious | module-starter --module={project}
+lua: standard*, love2d, neovim | — | luacheck, stylua
+```
+
+### Frontend Frameworks
+
+```yaml
+react: vite*, remix | npm create vite@latest {project} -- --template react-ts | eslint, vitest
+nextjs: app*, pages, fullstack | npx create-next-app@latest {project} | eslint, turbopack
+remix: indie*, classic | npx create-remix@latest {project}
+vue: vite*, nuxt, pinia | npm create vue@latest {project} | eslint, vitest
+nuxt: default*, layers, minimal | npx nuxi@latest init {project}
+svelte: sveltekit*, vite | npm create svelte@latest {project}
+angular: standalone*, modules | ng new {project}
+solid: vite*, start | npm create solid@latest {project}
+astro: default*, blog, docs | npm create astro@latest {project}
+```
+
+### Mobile
+
+```yaml
+swift: swiftpm*, ios, mvvm, tca | swift package init | swiftformat, swiftlint
+kotlin_android: compose*, xml, multiplatform | Android Studio wizard | ktlint, detekt
+dart: flutter*, console, package | flutter create {project} | dart_format
+react_native: expo*, bare | npx create-expo-app {project}
+```
+
+### Infrastructure
+
+```yaml
+docker: multistage*, single, compose
+kubernetes: helm*, kustomize, manifest | helm create {project}
+terraform: aws*, gcp, azure, multi | terraform init
+aws: cdk*, sam, terraform, serverless | cdk init app --language typescript
+github_actions: node*, go, python, docker → .github/workflows/ci.yml
+```
+
+### Monorepo
+
+```yaml
+turborepo: npx create-turbo@latest | ⭐ recommended | caching, parallel, remote-cache
+nx: npx create-nx-workspace@latest | affected, graph, generators
+pnpm: pnpm init | pnpm-workspace.yaml
+```
+
+---
+
+## AUTO-DETECTION
+
+| User Input    | → Stack          |
+| ------------- | ---------------- |
+| "go api"      | Go + standard    |
+| "next app"    | Next.js + app    |
+| "react app"   | React + vite     |
+| "fastapi"     | Python + fastapi |
+| "spring boot" | Java + spring    |
+| "flutter app" | Dart + flutter   |
+| "monorepo"    | Turborepo        |
+
+| File Found     | → Stack |
+| -------------- | ------- |
+| go.mod         | Go      |
+| package.json   | Node/TS |
+| Cargo.toml     | Rust    |
+| pyproject.toml | Python  |
+| \*.csproj      | C#      |
+| pubspec.yaml   | Dart    |
+
+---
+
+## P0-P6 PLAN TEMPLATE
+
+```
+P0: Environment — .env.example, secrets validation, .gitignore
+P1: Foundation — Init project, install deps, setup linting, git hooks, README
+P2: Core — Define entities/models, setup DI, implement core logic
+P3: Features — Feature 1, Feature 2, Feature 3
+P4: Integration — API/routes, error handling, logging, tracing
+P5: Testing — Unit tests (80%+), integration tests, E2E
+P6: Production — Dockerfile, CI/CD, health checks, deploy config
+```
+
+---
+
+## CROSS-CUTTING
+
+| Language | Linter        | Formatter          | DI Tool             |
+| -------- | ------------- | ------------------ | ------------------- |
+| Go       | golangci-lint | gofmt              | wire, fx            |
+| Rust     | clippy        | rustfmt            | —                   |
+| Python   | ruff          | ruff format        | dependency-injector |
+| TS       | eslint        | prettier           | tsyringe, inversify |
+| Java     | checkstyle    | google-java-format | Spring              |
+| C#       | dotnet-format | —                  | Microsoft.DI        |
+
+---
+
+## SUB-COMMANDS
+
+| Command                        | Description               |
+| ------------------------------ | ------------------------- |
+| `/init [stack]`                | Initialize with stack     |
+| `/init ai [description]`       | AI-powered scaffolding    |
+| `/init from [template]`        | Use template              |
+| `/init templates`              | List templates            |
+| `/init --level [1\|2\|3]`      | Basic/Standard/Enterprise |
+| `/init --monorepo [turbo\|nx]` | Create monorepo           |

package/.agent/workflows/migrate.md

@@ -0,0 +1,135 @@
+---
+description: "🗃️ Database migrations: create, run, rollback, and seed with safety checks"
+skills: { required: [database], contextual: [auto] }
+---
+
+# 🗃️ /migrate — Migrate Pro
+
+> Safe Schema Evolution & Data Migrations
+> 📚 25+ Tools • Zero-Downtime • Rollback Safety
+
+---
+
+## MIGRATION FLOW
+
+1. **DETECT** (Auto) — Detect stack via HSA (`hsa_detect_stack`), load DB context (`hsa_get_context`), find migration tool, check pending
+2. **VALIDATE** — Check migration syntax, detect breaking changes, verify rollback exists → ⛔ STOP if destructive
+3. **BACKUP** — Create backup (required for production), snapshot schema, log attempt
+4. **EXECUTE** — Run migrations in transaction, apply changes, update version table
+5. **VERIFY** — Validate schema, run smoke tests, check data integrity
+6. **SYNC** — `hsa_check_changes` to update index after schema changes
+
+---
+
+## COMMANDS
+
+| Command               | Description           | Risk        |
+| --------------------- | --------------------- | ----------- |
+| `/migrate`            | Show status & pending | 🟢 Safe     |
+| `/migrate up`         | Run all pending       | 🟡 Medium   |
+| `/migrate up 1`       | Run next migration    | 🟢 Safe     |
+| `/migrate down`       | Rollback last         | 🟠 High     |
+| `/migrate down 3`     | Rollback N steps      | 🔴 Critical |
+| `/migrate new [name]` | Create migration      | 🟢 Safe     |
+| `/migrate seed`       | Run seeders           | 🟡 Medium   |
+| `/migrate reset`      | Rollback all + up     | 🔴 Critical |
+| `/migrate fresh`      | Drop all + migrate    | 🔴 Critical |
+| `/migrate diff`       | Show schema diff      | 🟢 Safe     |
+
+---
+
+## MIGRATION TOOLS
+
+### TypeScript / JavaScript
+
+```yaml
+# tool: databases | create | up | down | status
+prisma: PG,MySQL,SQLite,Mongo,MSSQL | prisma migrate dev --name {n} | prisma migrate deploy | prisma migrate resolve --rolled-back | prisma migrate status
+drizzle: PG,MySQL,SQLite | drizzle-kit generate | drizzle-kit migrate | — | drizzle-kit push
+knex: PG,MySQL,SQLite,Oracle | knex migrate:make {n} | knex migrate:latest | knex migrate:rollback | knex migrate:status
+typeorm: PG,MySQL,SQLite,Oracle,MSSQL | typeorm migration:create | typeorm migration:run | typeorm migration:revert | —
+sequelize: PG,MySQL,SQLite,MSSQL | sequelize migration:generate --name {n} | sequelize db:migrate | sequelize db:migrate:undo | —
+```
+
+### Python
+
+```yaml
+alembic: PG,MySQL,SQLite,Oracle | alembic revision --autogenerate -m "{msg}" | alembic upgrade head | alembic downgrade -1 | alembic current
+django: PG,MySQL,SQLite,Oracle | manage.py makemigrations | manage.py migrate | manage.py migrate app {num} | manage.py showmigrations
+tortoise: PG,MySQL,SQLite | aerich migrate --name {n} | aerich upgrade | aerich downgrade | —
+```
+
+### Go
+
+```yaml
+goose: PG,MySQL,SQLite,MSSQL | goose create {n} sql | goose up | goose down | goose status
+migrate: PG,MySQL,SQLite,Mongo | migrate create -ext sql -dir migrations {n} | migrate up | migrate down 1 | —
+atlas: PG,MySQL,SQLite,MSSQL | — | atlas schema apply | — | atlas schema inspect
+ent: PG,MySQL,SQLite | go generate ./ent | atlas migrate apply | — | —
+```
+
+### Java / JVM
+
+```yaml
+flyway: PG,MySQL,Oracle,MSSQL,DB2 | — | flyway migrate | flyway undo (Teams) | flyway info
+liquibase: PG,MySQL,Oracle,MSSQL,DB2 | — | liquibase update | liquibase rollback {tag} | liquibase status
+```
+
+### Ruby / PHP / Rust / .NET
+
+```yaml
+rails: PG,MySQL,SQLite | rails g migration {n} | rails db:migrate | rails db:rollback STEP=1 | rails db:migrate:status
+laravel: PG,MySQL,SQLite,MSSQL | artisan make:migration {n} | artisan migrate | artisan migrate:rollback | artisan migrate:status
+diesel: PG,MySQL,SQLite | diesel migration generate {n} | diesel migration run | diesel migration revert | —
+sqlx: PG,MySQL,SQLite | sqlx migrate add {n} | sqlx migrate run | sqlx migrate revert | —
+ef_core: PG,MySQL,SQLite,MSSQL | dotnet ef migrations add {n} | dotnet ef database update | dotnet ef database update {prev} | —
+```
+
+---
+
+## ZERO-DOWNTIME STRATEGIES
+
+| Pattern                | Description                                       | Use When                  |
+| ---------------------- | ------------------------------------------------- | ------------------------- |
+| **Expand-Contract** ⭐ | Add new → Migrate data → Remove old               | Production schema changes |
+| **Blue-Green DB**      | Two identical DBs, switch traffic                 | Critical migrations       |
+| **Rolling**            | Incremental with replication (gh-ost, pg_repack)  | Large tables, can't lock  |
+| **CDC**                | Capture changes in real-time (Debezium, pgoutput) | Minimal cutover downtime  |
+
+---
+
+## ROLLBACK SAFETY MATRIX
+
+| Change Type   | Rollback       | Risk     |
+| ------------- | -------------- | -------- |
+| Add column    | ✅ Safe        | Low      |
+| Add index     | ✅ Safe        | Low      |
+| Rename column | ⚠️ Risky       | High     |
+| Drop column   | ❌ Destructive | Critical |
+| Drop table    | ❌ Destructive | Critical |
+
+> ⚠️ Data written after migration will be LOST on rollback. Always use expand-contract in production.
+
+---
+
+## BACKUP COMMANDS
+
+```yaml
+postgresql: pg_dump -Fc {db} > backup.dump | pg_restore -d {db} backup.dump
+mysql: mysqldump {db} > backup.sql | mysql {db} < backup.sql
+mongodb: mongodump --db {db} | mongorestore --db {db} dump/{db}
+```
+
+---
+
+## SEEDING
+
+```yaml
+# tool: run command | config
+prisma: npx prisma db seed | prisma/seed.ts
+rails: rails db:seed | db/seeds.rb
+laravel: php artisan db:seed | --class=UserSeeder
+django: manage.py loaddata fixtures.json
+
+# Seed types: dev (admin+test data) | staging (admin+anonymized) | prod (system roles only)
+```

package/.agent/workflows/monitor.md

@@ -0,0 +1,133 @@
+---
+description: "📡 Setup observability: logging, tracing, metrics, and alerting configuration"
+skills: { required: [], contextual: [auto] }
+---
+
+# 📡 /monitor — Monitor Pro
+
+> 3-Pillar Observability: Logs, Traces, Metrics
+> 📚 OpenTelemetry • Prometheus • Grafana • Multi-language
+
+---
+
+## MONITOR FLOW
+
+1. **DETECT** (Auto) — Detect stack via HSA (`hsa_detect_stack`), load obs context (`hsa_get_context`), check existing observability, identify gaps
+2. **PLAN** — Recommend libraries & backends, setup OpenTelemetry → ⛔ STOP: confirm before install
+3. **EXECUTE** — Add logging, tracing (OpenTelemetry), metrics (Prometheus), configure alerts
+4. **VERIFY** — Verify data in backends, test alerts
+
+---
+
+## COMMANDS
+
+| Command              | Description      | Focus         |
+| -------------------- | ---------------- | ------------- |
+| `/monitor`           | Full setup guide | All pillars   |
+| `/monitor logs`      | Logging setup    | Pillar 1      |
+| `/monitor traces`    | Tracing setup    | Pillar 2      |
+| `/monitor metrics`   | Metrics setup    | Pillar 3      |
+| `/monitor alerts`    | Alerting config  | Operations    |
+| `/monitor dashboard` | Dashboard setup  | Visualization |
+
+---
+
+## 📊 3 PILLARS OF OBSERVABILITY
+
+| Pillar         | Purpose       | Data Type              | Key Tools             |
+| -------------- | ------------- | ---------------------- | --------------------- |
+| 📝 **Logs**    | What happened | Structured JSON events | slog, zap, winston    |
+| 🔍 **Traces**  | Request flow  | Spans & context        | OpenTelemetry, Jaeger |
+| 📈 **Metrics** | System health | Time-series numbers    | Prometheus, Grafana   |
+
+---
+
+## 📝 PILLAR 1: STRUCTURED LOGGING
+
+| Language   | Library               | Install                                 |
+| ---------- | --------------------- | --------------------------------------- |
+| Go         | `slog` (stdlib 1.21+) | built-in                                |
+| Python     | `structlog`           | `pip install structlog`                 |
+| TypeScript | `pino`                | `npm i pino`                            |
+| Rust       | `tracing`             | `cargo add tracing tracing-subscriber`  |
+| Java       | `SLF4J + Logback`     | Maven/Gradle                            |
+| C#         | `Serilog`             | `dotnet add package Serilog.AspNetCore` |
+| PHP        | `Monolog`             | `composer require monolog/monolog`      |
+| Ruby       | `Semantic Logger`     | `gem install semantic_logger`           |
+
+### Best Practices
+
+| Category    | Guidelines                                                        |
+| ----------- | ----------------------------------------------------------------- |
+| Structure   | JSON format, consistent fields, correlation IDs                   |
+| Levels      | `ERROR`: failures, `WARN`: degraded, `INFO`: events, `DEBUG`: dev |
+| Security    | Mask PII (email, phone, SSN), no passwords                        |
+| Performance | Async logging, sample repetitive, log rotation                    |
+
+---
+
+## 🔍 PILLAR 2: DISTRIBUTED TRACING
+
+### OpenTelemetry Setup
+
+| Language   | Install Command                                                   |
+| ---------- | ----------------------------------------------------------------- |
+| Go         | `go get go.opentelemetry.io/otel`                                 |
+| Python     | `pip install opentelemetry-api opentelemetry-sdk`                 |
+| Java       | `opentelemetry-javaagent.jar` (auto-instrument)                   |
+| TypeScript | `npm i @opentelemetry/sdk-node`                                   |
+| Rust       | `cargo add opentelemetry opentelemetry-otlp`                      |
+| C#         | `dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol` |
+
+### Tracing Backends
+
+| Backend    | Type           | Docker Quick Start                                                |
+| ---------- | -------------- | ----------------------------------------------------------------- |
+| **Jaeger** | All-in-one OSS | `docker run -p 16686:16686 -p 4317:4317 jaegertracing/all-in-one` |
+| **Tempo**  | Grafana native | `docker-compose` with Grafana                                     |
+| **Zipkin** | Lightweight    | `docker run -p 9411:9411 openzipkin/zipkin`                       |
+
+---
+
+## 📈 PILLAR 3: METRICS
+
+### Prometheus Setup
+
+| Language   | Library                    | Key Metrics                                    |
+| ---------- | -------------------------- | ---------------------------------------------- |
+| Go         | `prometheus/client_golang` | `http_requests_total`, `http_duration_seconds` |
+| Python     | `prometheus_client`        | `requests_total`, `request_latency`            |
+| TypeScript | `prom-client`              | `http_request_duration_seconds`                |
+| Java       | `micrometer`               | Spring Boot auto-metrics                       |
+| Rust       | `metrics-rs`               | Custom counters, histograms                    |
+| C#         | `prometheus-net`           | ASP.NET Core metrics                           |
+
+### RED + USE Methods
+
+| Method  | Metrics                         | Use For        |
+| ------- | ------------------------------- | -------------- |
+| **RED** | Rate, Errors, Duration          | Services, APIs |
+| **USE** | Utilization, Saturation, Errors | Infrastructure |
+
+---
+
+## 🚨 ALERTING
+
+### Alert Priority
+
+| Level | Response Time | Example                   |
+| ----- | ------------- | ------------------------- |
+| P1    | < 5 min       | Service down, data loss   |
+| P2    | < 30 min      | High error rate, degraded |
+| P3    | < 4 hours     | Performance degradation   |
+| P4    | Next day      | Warning thresholds        |
+
+### Recommended Thresholds
+
+| Metric              | Warning | Critical |
+| ------------------- | ------- | -------- |
+| Error rate          | > 1%    | > 5%     |
+| Response time (p95) | > 500ms | > 2s     |
+| CPU usage           | > 70%   | > 90%    |
+| Memory usage        | > 80%   | > 95%    |
+| Disk usage          | > 75%   | > 90%    |

package/.agent/workflows/onboard.md

@@ -0,0 +1,144 @@
+---
+description: "📦 Project onboarding: discover architecture, map dependencies, generate getting-started guide"
+skills: { required: [], contextual: [auto] }
+---
+
+# 📦 /onboard — Project Discovery
+
+> Understand Any Codebase in Minutes
+> 📚 Architecture Mapping • Dependency Analysis • Getting Started Guide
+
+---
+
+## ONBOARD FLOW
+
+1. **DETECT** — Stack detection (`hsa_detect_stack`), count files/dirs, identify entry points & configs. Show: `[Step 1/6] Detecting stack...`
+2. **ANALYZE** — Parse architecture: folder structure, key modules, dependency graph, build system. Show: `[Step 2/6] Analyzing 342 files...`
+3. **MAP** — Generate Mermaid architecture diagram + module dependency graph. Show: `[Step 3/6] Mapping architecture...`
+4. **ASSESS** — Identify code health: test coverage, lint score, outdated deps, known issues. Show: `[Step 4/6] Assessing code health...`
+5. **GUIDE** — Create "Getting Started" guide: setup steps, key files, conventions, common tasks. Show: `[Step 5/6] Generating guide...`
+6. **SYNC** — Save onboard report to `.domyh/onboard_YYYY-MM-DD.md`. Show: `[Step 6/6] Saving report...`
+
+---
+
+## COMMANDS
+
+| Command                 | Description               | Output                        |
+| ----------------------- | ------------------------- | ----------------------------- |
+| `/onboard`              | Full project discovery    | Architecture diagram + guide  |
+| `/onboard quick`        | 2-minute overview         | Stack + key files + setup     |
+| `/onboard architecture` | Architecture diagram only | Mermaid diagram               |
+| `/onboard deps`         | Dependency analysis       | Dep graph + outdated check    |
+| `/onboard conventions`  | Coding conventions        | Detected patterns + rules     |
+| `/onboard share`        | Export onboard guide      | Markdown doc for team sharing |
+
+---
+
+## 📊 OUTPUT FORMAT
+
+```
+📦 PROJECT ONBOARD — [project] — [date]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🏗️ Stack: [detected framework + language + tools]
+📁 Structure: [total files] | [total dirs] | [src LoC]
+🧪 Tests: [test files] | Coverage: [%]
+🔒 Security: [npm audit / cargo audit / go vuln] summary
+
+📊 Architecture Diagram:
+[Mermaid graph TD diagram of key modules]
+
+📋 Key Files:
+  • Entry: [entry point files]
+  • Config: [config files]
+  • API: [API route pattern]
+  • State: [state management files]
+
+🚀 Getting Started:
+  1. [env setup command]
+  2. [install command]
+  3. [dev server command] → [URL]
+
+📝 Conventions Detected:
+  • Naming: [camelCase / snake_case / PascalCase]
+  • Structure: [feature-based / layer-based]
+  • Imports: [relative / alias / barrel]
+```
+
+---
+
+## 🏗️ ARCHITECTURE MAPPING
+
+### Auto-Generated Mermaid Diagram
+
+```mermaid
+graph TD
+    subgraph frontend["Frontend"]
+        pages["pages/"]
+        components["components/"]
+        composables["composables/"]
+    end
+
+    subgraph backend["Backend"]
+        api["server/api/"]
+        middleware["server/middleware/"]
+        services["services/"]
+    end
+
+    subgraph data["Data Layer"]
+        db["database/"]
+        models["models/"]
+    end
+
+    pages --> components
+    pages --> composables
+    pages --> api
+    api --> services
+    services --> models
+    models --> db
+```
+
+### Dependency Graph
+
+- Parse `package.json` / `go.mod` / `Cargo.toml` / `requirements.txt`
+- Show: direct deps, dev deps, outdated count, vulnerability count
+- Highlight: circular dependencies, unused dependencies
+
+---
+
+## 🔍 DETECTION RULES
+
+### Entry Points (by framework)
+
+| Framework  | Entry Point                       |
+| ---------- | --------------------------------- |
+| Next.js    | `app/page.tsx`, `pages/index.tsx` |
+| Nuxt       | `app.vue`, `pages/index.vue`      |
+| Vite/React | `src/main.tsx`, `src/App.tsx`     |
+| Flutter    | `lib/main.dart`                   |
+| Go         | `main.go`, `cmd/*/main.go`        |
+| .NET       | `Program.cs`, `Startup.cs`        |
+| Rust       | `src/main.rs`, `src/lib.rs`       |
+
+### Architecture Pattern Detection
+
+| Pattern          | Indicators                            |
+| ---------------- | ------------------------------------- |
+| Monolith         | Single entry, shared DB               |
+| Modular Monolith | Feature folders, internal modules     |
+| Microservices    | Multiple `go.mod` / `package.json`    |
+| Monorepo         | `workspaces`, `nx.json`, `turbo.json` |
+| Serverless       | `serverless.yml`, `netlify.toml`      |
+
+---
+
+## 📈 CODE HEALTH ASSESSMENT
+
+| Metric         | Green      | Yellow     | Red         |
+| -------------- | ---------- | ---------- | ----------- |
+| Test Coverage  | ≥ 80%      | 50-80%     | < 50%       |
+| Lint Score     | 0 errors   | < 10 warns | > 10 errors |
+| Outdated Deps  | 0 major    | 1-3 major  | > 3 major   |
+| Security Vulns | 0 critical | moderate   | critical    |
+| Build Time     | < 30s      | 30-60s     | > 60s       |
+| Bundle Size    | < 200KB    | 200-500KB  | > 500KB     |

package/.agent/workflows/orchestrate.md

@@ -0,0 +1,117 @@
+---
+description: "🎭 Multi-Agent Orchestration: coordinate parallel tasks, delegate to specialists"
+skills: { required: [], contextual: [] }
+---
+
+# 🎭 /orchestrate — Orchestrate Pro
+
+> Multi-Agent Task Coordination
+> 📚 Parallel Execution • Fault Tolerance • Checkpoints • DAG-based Dependencies
+
+---
+
+## ORCHESTRATE FLOW
+
+1. **DECOMPOSE** — Break complex task into sub-tasks, identify dependencies, build DAG (Directed Acyclic Graph). Show: `[Step 1/5] Decomposing into 4 parallel tasks...`
+2. **ASSIGN** — Map sub-tasks to specialist personas, define interfaces between agents
+3. **PLAN** — Define execution order, checkpoints, rollback points → ⛔ STOP for user approval. Show task DAG visualization
+4. **EXECUTE** — Run parallel tasks, monitor progress, handle failures. Show: `[Task 2/4] Backend API ████████░░ 80%`
+5. **SYNTHESIZE** — Merge results, resolve conflicts, verify integration. Run cross-task tests
+
+---
+
+## COMMANDS
+
+| Command                 | Description             |
+| ----------------------- | ----------------------- |
+| `/orchestrate [task]`   | Coordinate complex task |
+| `/orchestrate status`   | Check progress          |
+| `/orchestrate merge`    | Synthesize results      |
+| `/orchestrate resume`   | Resume from checkpoint  |
+| `/orchestrate --visual` | Show DAG visualization  |
+
+---
+
+## 🔧 SPECIALIST ROLES
+
+| Specialist | Skills                      | Delegates To               |
+| ---------- | --------------------------- | -------------------------- |
+| Backend    | API, database, auth         | `/code`, `/test`, `/debug` |
+| Frontend   | UI, UX, components          | `/code`, `/visualize`      |
+| DevOps     | Deploy, infra, monitoring   | `/deploy`, `/monitor`      |
+| Quality    | Testing, review, audit      | `/test`, `/review`, `/ap`  |
+| Security   | Audit, scanning, hardening  | `/ap security`, `/review`  |
+| Data       | Migrations, seeding, schema | `/migrate`, `/generate`    |
+
+---
+
+## ⚡ ORCHESTRATION PATTERNS
+
+| Pattern                 | Description                            | Use When                    |
+| ----------------------- | -------------------------------------- | --------------------------- |
+| **Orchestrator-Worker** | Lead decomposes, delegates, aggregates | Default for complex tasks   |
+| **Pipeline**            | Sequential stages, parallel within     | Build/deploy/CI pipelines   |
+| **Fan-out/Fan-in**      | Distribute → collect → merge           | Multi-module refactoring    |
+| **Feedback Loop**       | Draft → review → refine → repeat       | Iterative quality work      |
+| **DAG-based**           | Dependency graph execution             | Tasks with prerequisites    |
+| **Peer-to-Peer**        | Agents communicate directly            | Distributed decision-making |
+
+### DAG Example
+
+```
+┌──────────┐     ┌──────────┐
+│  DB Model │────→│ API Route │
+└──────────┘     └────┬─────┘
+                      │
+┌──────────┐     ┌────▼─────┐     ┌──────────┐
+│ Auth Mid │────→│ Frontend │────→│ E2E Test │
+└──────────┘     └──────────┘     └──────────┘
+```
+
+---
+
+## 🛡️ FAULT TOLERANCE
+
+| Strategy             | Trigger           | Action                                |
+| -------------------- | ----------------- | ------------------------------------- |
+| Retry                | Task fails        | Retry 3x with exponential backoff     |
+| Graceful degradation | Partial failure   | Continue with available results       |
+| Circuit breaker      | Repeated failures | Stop after 3 fails in 5 attempts      |
+| Checkpoint/Resume    | Recovery          | `/orchestrate resume [checkpoint_id]` |
+| Compensation         | Late failure      | Undo completed sub-tasks              |
+
+---
+
+## 📊 EXECUTION MONITORING
+
+```yaml
+monitoring:
+  per_task:
+    - status: "pending | running | completed | failed"
+    - progress: "percentage or step count"
+    - duration: "elapsed time"
+    - dependencies: "blocked by / blocking"
+
+  overall:
+    - total_tasks: N
+    - completed: M
+    - failed: F
+    - eta: "estimated completion"
+
+  alerts:
+    - task_timeout: "30 minutes per sub-task"
+    - stuck_detection: "No progress for 5 minutes"
+    - loop_prevention: "Max 3 retries per task"
+```
+
+---
+
+## 📊 TOKEN BOUNDARIES
+
+| Rule            | Description                       |
+| --------------- | --------------------------------- |
+| Per-agent limit | Set explicit token caps per task  |
+| Timeout         | Max execution time per task (30m) |
+| Loop prevention | Detect recursive/circular calls   |
+| Alert           | Notify at 90% of limit            |
+| Budget tracking | Show token usage per specialist   |