@nockdev/awf 6.2.0

package/.agent/workflows/dev.md

@@ -0,0 +1,137 @@
+---
+description: "▶️ Start development server: detect stack, run dev commands, validate output"
+skills: { required: [], contextual: [auto] }
+---
+
+# ▶️ /dev — Dev Pro
+
+> Intelligent Development Runner
+> 📚 Auto-detect Stack • HMR 2025 • Error Recovery • Multi-service
+
+---
+
+## DEV FLOW
+
+1. **DETECT** — Identify stack via HSA (`hsa_detect_stack`), find dev commands, check monorepo (nx.json, turbo.json, pnpm-workspace.yaml, package.json workspaces). Show: `[Step 1/6] Detecting stack...`
+2. **DEPS CHECK** — Verify dependencies installed:
+   - Node.js: `node_modules/` exists? → If not: auto-run `npm install` (or yarn/pnpm/bun)
+   - Go: `go.sum` exists? → If not: `go mod download`
+   - Python: `venv/` or `.venv/` exists? → If not: `python -m venv .venv && pip install -r requirements.txt`
+   - Rust: Run `cargo check` to verify
+     → Show: `[Step 2/6] Dependencies ✅` or `Installing dependencies...`
+3. **SERVICES** — Check required services (DB, Redis, message queue):
+   - Docker Compose found? → Offer `docker-compose up -d`
+   - `.env` references DB_HOST? → Check if DB accessible
+   - Redis required? → Check `redis-cli ping`
+     → Show: `[Step 3/6] Services: PostgreSQL ✅ | Redis ✅`
+4. **SETUP** — Set environment, check ports:
+   - Load `.env` / `.env.local`
+   - Check if default port available (3000, 8080, etc.)
+   - If port in use: suggest next available or show what's using it
+     → Show: `[Step 4/6] Port 3000 available ✅`
+5. **START** — Run dev command, watch output:
+   - On crash/error: show error + common fixes + offer auto-restart
+   - On monorepo: offer parallel start for multiple packages
+     → Show: `[Step 5/6] Starting server...`
+6. **VALIDATE** — Confirm server running, show access URL:
+   - Check health endpoint responds
+   - Show URL for browser access
+     → Show: `[Step 6/6] ✅ Server running at http://localhost:3000`
+
+---
+
+## ERROR RECOVERY
+
+```yaml
+on_crash:
+  1_show_error: "Display clear error message"
+  2_common_fixes:
+    port_in_use: "Kill process on port: npx kill-port 3000"
+    missing_env: "Create .env from .env.example"
+    missing_deps: "Run: npm install"
+    db_not_running: "Start DB: docker-compose up -d db"
+    permission: "Check file permissions"
+  3_auto_restart: "Offer: Restart server? (y/n)"
+  4_max_retries: 3 # Stop after 3 consecutive crashes
+
+on_port_in_use:
+  detect: "lsof -i :PORT (Unix) | netstat -ano | findstr PORT (Windows)"
+  options:
+    - "Kill existing process"
+    - "Use next available port"
+    - "Show what's using the port"
+```
+
+---
+
+## COMMANDS
+
+| Command           | Description           |
+| ----------------- | --------------------- |
+| `/dev`            | Start dev server      |
+| `/dev stop`       | Stop server           |
+| `/dev restart`    | Restart server        |
+| `/dev logs`       | View logs             |
+| `/dev port [num]` | Use specific port     |
+| `/dev --all`      | Start all services    |
+| `/dev --clean`    | Clean install + start |
+
+---
+
+## 🔧 DEV COMMANDS BY STACK
+
+| Framework            | Dev Command                  | Alt                     |
+| -------------------- | ---------------------------- | ----------------------- |
+| **Next.js**          | `next dev`                   | `npm run dev`           |
+| **Vite**             | `vite`                       | `npm run dev`           |
+| **Remix**            | `remix dev`                  | `npm run dev`           |
+| **Nuxt**             | `nuxt dev`                   | `npm run dev`           |
+| **Angular**          | `ng serve`                   | `npm start`             |
+| **Go (Air)**         | `air`                        | `go run .`              |
+| **Go (Gin)**         | `go run main.go`             | `air`                   |
+| **Python (Django)**  | `python manage.py runserver` | `./manage.py runserver` |
+| **Python (FastAPI)** | `uvicorn main:app --reload`  | `fastapi dev`           |
+| **Python (Flask)**   | `flask run --debug`          | `python app.py`         |
+| **Rust (Cargo)**     | `cargo run`                  | `cargo watch -x run`    |
+| **Java (Spring)**    | `./mvnw spring-boot:run`     | `./gradlew bootRun`     |
+| **PHP (Laravel)**    | `php artisan serve`          | `valet`                 |
+| **PHP (Symfony)**    | `symfony server:start`       | `php -S localhost:8000` |
+| **Ruby (Rails)**     | `rails server`               | `bin/dev`               |
+
+---
+
+## 🐳 MULTI-SERVICE / MONOREPO
+
+```yaml
+monorepo_detection:
+  nx: "nx.json → nx run-many --target=dev"
+  turbo: "turbo.json → turbo dev"
+  pnpm: "pnpm-workspace.yaml → pnpm -r dev"
+  npm: "package.json workspaces → npm run dev --workspaces"
+  lerna: "lerna.json → lerna run dev --parallel"
+
+docker_compose:
+  detected: "docker-compose.yml exists"
+  action: "Offer: Start all services with docker-compose up -d?"
+  selective: "Or start specific: docker-compose up -d db redis"
+```
+
+---
+
+## ⚡ HMR 2025 STANDARDS
+
+| Metric             | Target                     |
+| ------------------ | -------------------------- |
+| Module update      | < 100ms                    |
+| Full reload        | < 1s                       |
+| State preservation | React/Vue state maintained |
+| Cold start         | < 3s                       |
+
+### Modern Bundlers
+
+| Tool      | Speed        | Use Case                 |
+| --------- | ------------ | ------------------------ |
+| Vite      | ⚡ Fast      | Default for new projects |
+| Turbopack | ⚡⚡ Fastest | Next.js 15+              |
+| Rspack    | ⚡⚡ Fast    | webpack migration        |
+| esbuild   | ⚡⚡ Fastest | Build-only               |

package/.agent/workflows/doc.md

@@ -0,0 +1,124 @@
+---
+description: "📝 Generate documentation: API docs, README, code comments, and changelogs"
+skills: { required: [], contextual: [auto] }
+---
+
+# 📝 /doc — Doc Pro
+
+> AI-Powered Documentation Generation
+> 📚 20+ Languages • Docs-as-Code • Auto-API Specs
+
+---
+
+## DOCUMENTATION FLOW
+
+1. **ANALYZE** (Auto) — Detect stack via HSA (`hsa_detect_stack`), load code context (`hsa_get_context`), scan codebase, identify undocumented items
+2. **PLAN** — Show documentation gaps, estimate scope → ⛔ STOP if large: confirm scope
+3. **GENERATE** — Create doc content, use language-specific format, add examples & diagrams
+4. **VALIDATE** — Check links/references, verify code examples compile, lint docs
+5. **OUTPUT** — Generate files (MD/HTML/PDF), update existing docs, show summary
+
+---
+
+## DOC TOOLS BY LANGUAGE
+
+```yaml
+# language: inline format | generator | api docs | command
+go:         "// GoDoc"              | godoc, pkgsite     | swaggo/swag          | swag init; go doc ./...
+rust:       "/// Rustdoc"           | rustdoc             | utoipa               | cargo doc --open
+java:       "/** Javadoc */"        | javadoc             | springdoc-openapi    | mvn javadoc:javadoc
+kotlin:     "/** KDoc */"           | Dokka               | springdoc-kotlin     | gradle dokkaHtml
+csharp:     "/// XML comments"      | DocFX, Sandcastle   | Swashbuckle          | dotnet build /p:GenerateDocumentationFile=true
+cpp:        "/// Doxygen"           | Doxygen             | —                    | doxygen Doxyfile
+c:          "/** Doxygen */"        | Doxygen             | —                    | doxygen
+python:     '"""Docstrings"""'      | Sphinx, MkDocs      | FastAPI auto-OpenAPI | sphinx-build -b html docs/ _build/
+ruby:       "# YARD"               | YARD, RDoc          | rswag                | yard doc
+php:        "/** PHPDoc */"         | phpDocumentor       | L5-Swagger, Scramble | phpDocumentor -d src -t docs
+perl:       "=head1 POD"           | Pod::Simple         | —                    | pod2html
+lua:        "--- LDoc"             | LDoc                | —                    | ldoc .
+javascript: "/** JSDoc */"         | JSDoc               | swagger-jsdoc        | npx jsdoc -c jsdoc.json
+typescript: "/** TSDoc */"         | TypeDoc             | tsoa                 | npx typedoc --out docs src
+react:      "/** JSDoc + TS */"    | Storybook           | —                    | npx storybook build
+swift:      "/// DocC"             | DocC, Jazzy         | —                    | swift package generate-documentation
+dart:       "/// DartDoc"          | dartdoc             | —                    | dart doc
+elixir:     '@doc """..."""'       | ExDoc               | OpenApiSpex          | mix docs
+haskell:    "-- | Haddock"         | Haddock             | servant-swagger      | cabal haddock
+scala:      "/** Scaladoc */"      | Scaladoc            | tapir                | sbt doc
+```
+
+### API Spec Formats
+
+```yaml
+openapi: "OpenAPI 3.1 (YAML/JSON)" | tools: Swagger UI, Redoc, Stoplight
+graphql: "GraphQL SDL + descriptions" | tools: Playground, Apollo Studio
+```
+
+---
+
+## DOCSTRING STYLES (Python)
+
+| Style  | Used By                       |
+| ------ | ----------------------------- |
+| Google | Google projects, most popular |
+| NumPy  | Scientific Python             |
+| Sphinx | Official Sphinx format        |
+
+---
+
+## README TEMPLATE
+
+```markdown
+# Project Name
+
+> One-line description
+
+## 🚀 Quick Start
+
+## 📖 Documentation
+
+## 🔧 Configuration (env table)
+
+## 📝 License
+```
+
+## CHANGELOG FORMAT
+
+```
+## [Unreleased]
+### Added / Changed / Fixed
+## [1.0.0] - YYYY-MM-DD
+```
+
+---
+
+## VALIDATION CHECKS
+
+```yaml
+links: Check internal + external URLs, verify anchors
+code_examples: Syntax valid, examples compile/run, output matches
+formatting: Consistent headers, no orphan images, tables formatted
+completeness: All public APIs documented, params described, return values, examples
+```
+
+---
+
+## AI-OPTIMIZED DOCS
+
+```yaml
+llms_txt: "Help AI understand project" → /llms.txt (overview, architecture, API list, key concepts)
+docs_as_code: "Docs live with code, version controlled, CI validated, auto-generated"
+```
+
+---
+
+## SUB-COMMANDS
+
+| Command              | Description        |
+| -------------------- | ------------------ |
+| `/doc`               | Auto-generate all  |
+| `/doc readme`        | README only        |
+| `/doc api`           | API spec (OpenAPI) |
+| `/doc code`          | Inline code docs   |
+| `/doc changelog`     | CHANGELOG from git |
+| `/doc --check`       | Audit coverage     |
+| `/doc --format html` | Output as HTML     |

package/.agent/workflows/env.md

@@ -0,0 +1,98 @@
+---
+description: "🔐 Environment management: configure variables, secrets, and multi-environment setup"
+skills: { required: [security], contextual: [auto] }
+---
+
+# 🔐 /env — Env Pro
+
+> Secure Configuration Management
+> 📚 Multi-environment • Secrets vault • Drift detection
+
+---
+
+## ENV FLOW
+
+1. **SCAN** (Auto) — Detect stack via HSA (`hsa_detect_stack`), find all .env\* files, check .gitignore rules, detect exposed secrets
+2. **VALIDATE** — Validate format/types, detect missing/deprecated vars
+3. **SYNC** — Sync .env.example template, drift detection between envs
+4. **REPORT** — Security recommendations, next steps
+
+---
+
+## COMMANDS
+
+| Command                   | Description           | Risk      |
+| ------------------------- | --------------------- | --------- |
+| `/env`                    | Full audit & status   | 🟢 Safe   |
+| `/env scan`               | Security scan only    | 🟢 Safe   |
+| `/env add [KEY=val]`      | Add new variable      | 🟡 Medium |
+| `/env sync`               | Sync .env.example     | 🟡 Medium |
+| `/env rotate [KEY]`       | Rotate secret         | 🔴 High   |
+| `/env validate`           | Type/format check     | 🟢 Safe   |
+| `/env diff [env1] [env2]` | Compare environments  | 🟢 Safe   |
+| `/env vault`              | Setup secrets manager | 🔴 High   |
+
+---
+
+## 📁 FILE STRUCTURE
+
+### Standard Files
+
+| File               | Purpose                            | Commit?      |
+| ------------------ | ---------------------------------- | ------------ |
+| `.env.example`     | Template with placeholders         | ✅ Yes       |
+| `.env`             | Local development values           | ❌ No        |
+| `.env.local`       | Local overrides (highest priority) | ❌ No        |
+| `.env.development` | Development environment            | ❌ No        |
+| `.env.staging`     | Staging server                     | ❌ No        |
+| `.env.production`  | Production (use vault instead)     | ❌ No        |
+| `.env.test`        | Test environment                   | ⚠️ Sometimes |
+
+### Load Priority (By Framework)
+
+| Framework | Priority Order                                                      |
+| --------- | ------------------------------------------------------------------- |
+| Next.js   | `.env.local` → `.env.{NODE_ENV}.local` → `.env.{NODE_ENV}` → `.env` |
+| Vite      | `.env.{mode}.local` → `.env.{mode}` → `.env.local` → `.env`         |
+| Nuxt      | `nuxt.config.ts` → `.env`                                           |
+| Go        | `godotenv.Load()` + env struct parsing                              |
+| Python    | `pydantic-settings` with env file precedence                        |
+
+---
+
+## 🔑 Validation Libraries
+
+| Language       | Library                | Validation                         |
+| -------------- | ---------------------- | ---------------------------------- |
+| **Go**         | godotenv, caarlos0/env | Struct tags + Parse                |
+| **Rust**       | dotenvy, config        | Serde + envy                       |
+| **Python**     | python-dotenv          | pydantic-settings                  |
+| **TypeScript** | dotenv                 | envalid, zod, t3-env               |
+| **Java**       | Spring Profiles        | @Value, @ConfigurationProperties   |
+| **C#**         | DotNetEnv              | Microsoft.Extensions.Configuration |
+| **PHP**        | vlucas/phpdotenv       | Laravel config()                   |
+| **Ruby**       | dotenv                 | figaro                             |
+
+---
+
+## 🔒 SECRETS MANAGEMENT
+
+### Recommended Vaults
+
+| Tool                   | Best For       | Key Feature     |
+| ---------------------- | -------------- | --------------- |
+| **HashiCorp Vault**    | Multi-cloud    | Dynamic secrets |
+| **AWS SSM**            | AWS native     | Parameter Store |
+| **GCP Secret Manager** | GCP native     | Auto-rotation   |
+| **Azure Key Vault**    | Azure native   | HSM-backed      |
+| **Doppler**            | Multi-platform | Auto-sync       |
+| **1Password CLI**      | Teams          | Code references |
+
+### Variable Categories
+
+| Category     | Example                      | Security Level |
+| ------------ | ---------------------------- | -------------- |
+| App Config   | `PORT`, `LOG_LEVEL`          | 🟢 Low         |
+| Service URLs | `DATABASE_URL`, `API_BASE`   | 🟡 Medium      |
+| API Keys     | `STRIPE_KEY`, `GITHUB_TOKEN` | 🔴 High        |
+| Credentials  | `DB_PASSWORD`, `JWT_SECRET`  | 🔴 Critical    |

package/.agent/workflows/fix.md

@@ -0,0 +1,76 @@
+---
+description: "⚡ Quick-fix pipeline: capture error → identify → fix → verify (max 60s)"
+skills: { required: [], contextual: [auto] }
+---
+
+# ⚡ /fix — Fix Pro
+
+> Fast, Targeted Error Resolution
+> 📚 Single-Pass Fix • Auto-Retry • Max 60s
+
+---
+
+## FIX FLOW
+
+1. **DETECT** (5s) — Parse error, detect stack via HSA (`hsa_detect_stack`), load context (`hsa_get_context`), locate file + line, read surrounding code, classify fix category
+2. **EXECUTE** (30s) — Apply targeted fix, minimal changes only, preserve existing behavior
+3. **VERIFY** (15s) — Build/syntax check, run affected tests → If FAIL: retry (max 2) → If still FAIL: escalate to `/debug`
+4. **SYNC** — `hsa_check_changes` to update index after edits
+
+---
+
+## COMMANDS
+
+| Command        | Description             | Speed     |
+| -------------- | ----------------------- | --------- |
+| `/fix [error]` | Fix specific error      | ⚡ Fast   |
+| `/fix last`    | Fix last terminal error | ⚡ Fast   |
+| `/fix build`   | Fix build errors        | ⚡ Fast   |
+| `/fix lint`    | Fix all lint errors     | ⚡ Fast   |
+| `/fix types`   | Fix type errors         | ⚡ Fast   |
+| `/fix imports` | Fix import errors       | ⚡ Fast   |
+| `/fix tests`   | Fix failing tests       | 🔧 Medium |
+
+---
+
+## ⚡ vs 🐛 Khi nào dùng /fix vs /debug?
+
+| Use `/fix` when                               | Use `/debug` when                        |
+| --------------------------------------------- | ---------------------------------------- |
+| Error message rõ ràng (compile, type, import) | Lỗi logic phức tạp, không rõ nguyên nhân |
+| Biết file nào lỗi                             | Runtime error intermittent               |
+| Fix đơn giản (< 10 lines)                     | Need root cause analysis                 |
+| Cần fix nhanh để unblock                      | Multiple files involved                  |
+| —                                             | `/fix` đã thử 2 lần vẫn fail             |
+
+---
+
+## 🔧 FIX CATEGORIES
+
+| Category    | Detect Pattern                          | Approach                       | Confidence |
+| ----------- | --------------------------------------- | ------------------------------ | ---------- |
+| Syntax      | SyntaxError, unexpected token           | Auto-fix syntax                | 95%        |
+| Types       | TypeError, type mismatch, TS errors     | Add/update types               | 90%        |
+| Imports     | ModuleNotFoundError, Cannot find module | Fix paths, add missing         | 95%        |
+| Null safety | Cannot read property of null/undefined  | Null checks, optional chaining | 85%        |
+| Build       | Build failed, compilation error         | Fix config, missing deps       | 80%        |
+| Lint        | ESLint, golangci-lint, ruff             | Auto-fix or recommended        | 90%        |
+| Dependency  | Version mismatch, peer dependency       | Update/install correct         | 85%        |
+
+---
+
+## 🔄 ESCALATION
+
+After 2 retries fail:
+
+- 1️⃣ Gọi `/debug` để phân tích sâu
+- 2️⃣ Thử cách khác
+- 3️⃣ Bỏ qua, làm tiếp
+
+---
+
+## ⛔ SAFETY
+
+- Max changed files: 3
+- Max changed lines: 30
+- Require confirmation if: > 3 files, > 30 lines, modifies test/config files

package/.agent/workflows/generate.md

@@ -0,0 +1,28 @@
+---
+description: "🏗️ Code generation: models, APIs, components, services, and tests from templates"
+skills: { required: [], contextual: [auto] }
+---
+
+# 🏗️ /generate — Alias for /scaffold
+
+> ℹ️ **This command is an alias for `/scaffold`.**
+> All generation features have been unified into `/scaffold` — Scaffold Pro.
+
+## Usage
+
+All `/generate` commands map directly to `/scaffold`:
+
+| Type this...                   | Same as...                     |
+| ------------------------------ | ------------------------------ |
+| `/generate model User`         | `/scaffold model User`         |
+| `/generate api /users`         | `/scaffold api /users`         |
+| `/generate component UserCard` | `/scaffold component UserCard` |
+| `/generate service Auth`       | `/scaffold service Auth`       |
+| `/generate test auth.service`  | `/scaffold test auth.service`  |
+| `/generate crud Product`       | `/scaffold module Product`     |
+| `/generate hook useAuth`       | `/scaffold hook useAuth`       |
+| `/generate page Dashboard`     | `/scaffold page Dashboard`     |
+| `/generate middleware Auth`    | `/scaffold middleware Auth`    |
+| `/generate dto CreateUser`     | `/scaffold dto CreateUser`     |
+
+> 📖 See `/scaffold` for full documentation, framework templates, and convention matching.

package/.agent/workflows/git.md

@@ -0,0 +1,97 @@
+---
+description: "🔀 Git operations: commit, branch, stash, log, diff, merge, rebase"
+skills: { required: [], contextual: [] }
+---
+
+# 🔀 /git — Git Pro
+
+> Intelligent Git Operations Hub
+> 📚 Conventional Commits • Branch Strategy • Safe Merge
+
+---
+
+## GIT FLOW
+
+1. **PARSE** — Identify git command intent, check current repo state, detect branch strategy
+2. **DETECT** — Current branch & status, uncommitted changes, remote sync state
+3. **EXECUTE** — Run git operations, handle conflicts → ⛔ STOP on destructive actions
+4. **SYNC** — `hsa_check_changes` after commit/merge/rebase/checkout to update index
+5. **VERIFY** — Confirm state after operation, show summary
+
+---
+
+## COMMANDS
+
+| Command                | Description                            | Risk      |
+| ---------------------- | -------------------------------------- | --------- |
+| `/git commit`          | Smart commit with conventional message | 🟢 Safe   |
+| `/git commit --auto`   | Auto-generate commit message from diff | 🟢 Safe   |
+| `/git branch [name]`   | Create branch with naming convention   | 🟢 Safe   |
+| `/git stash`           | Stash current changes                  | 🟢 Safe   |
+| `/git stash pop`       | Pop last stash                         | 🟡 Medium |
+| `/git log`             | Pretty log (last 10)                   | 🟢 Safe   |
+| `/git diff`            | Show diff summary                      | 🟢 Safe   |
+| `/git merge [branch]`  | Merge with conflict resolution         | 🟡 Medium |
+| `/git rebase [branch]` | Interactive rebase                     | 🟠 High   |
+| `/git undo`            | Undo last commit (soft)                | 🟡 Medium |
+| `/git undo --hard`     | Hard reset (destructive)               | 🔴 Danger |
+| `/git status`          | Full repo status                       | 🟢 Safe   |
+| `/git sync`            | Pull + push with rebase                | 🟡 Medium |
+
+---
+
+## 📝 CONVENTIONAL COMMITS
+
+| Type       | Description                  |
+| ---------- | ---------------------------- |
+| `feat`     | New feature                  |
+| `fix`      | Bug fix                      |
+| `docs`     | Documentation                |
+| `style`    | Formatting (no logic change) |
+| `refactor` | Code restructuring           |
+| `perf`     | Performance improvement      |
+| `test`     | Adding/updating tests        |
+| `build`    | Build system changes         |
+| `ci`       | CI/CD changes                |
+| `chore`    | Maintenance tasks            |
+| `revert`   | Revert previous commit       |
+
+Format: `{type}({scope}): {description}`
+
+Examples: `feat(auth): add JWT refresh token` • `fix(api): handle null response` • `docs(readme): update install guide`
+
+### Auto-Generate Commit Message
+
+1. `git diff --staged` → analyze changes
+2. Classify change type (feat/fix/refactor/...)
+3. Extract scope from file paths
+4. Generate concise description
+5. Present for user confirmation → ⛔ Commit with this message? (y/edit/n)
+
+---
+
+## 🌿 BRANCH NAMING
+
+| Type    | Convention                      | Example                        |
+| ------- | ------------------------------- | ------------------------------ |
+| feature | `feature/{ticket}-{short-desc}` | `feature/AUTH-123-jwt-refresh` |
+| bugfix  | `fix/{ticket}-{short-desc}`     | `fix/API-456-null-response`    |
+| hotfix  | `hotfix/{ticket}-{short-desc}`  | `hotfix/PROD-789-memory-leak`  |
+| release | `release/{version}`             | `release/v2.1.0`               |
+| docs    | `docs/{topic}`                  | `docs/api-reference`           |
+
+---
+
+## ⚠️ SAFETY RULES
+
+**Destructive commands** (⛔ require explicit user confirmation):
+
+- `git reset --hard`, `git push --force`, `git clean -fd`, `git branch -D`
+
+**Pre-checks**:
+
+- Check for uncommitted changes before branch switch
+- Verify remote exists before push
+- Confirm target branch before merge/rebase
+
+**Conflict resolution**: Show conflicting files → Offer: manual | theirs | ours → Run tests after resolution

package/.agent/workflows/help.md

@@ -0,0 +1,75 @@
+---
+description: "❓ Show all available commands, usage examples, and language settings"
+skills: { required: [], contextual: [] }
+---
+
+# ❓ /help — Command Reference
+
+> 📋 See `core/COMMANDS.md` for full registry with skill requirements
+
+---
+
+## Quick Reference
+
+### Development
+
+| Command              | Description             | Example                   |
+| -------------------- | ----------------------- | ------------------------- |
+| `/code [task]`       | 💻 Write & fix code     | `/code add login form`    |
+| `/debug [error]`     | 🐛 Systematic debugging | `/debug timeout error`    |
+| `/test`              | ✅ Run & write tests    | `/test write UserService` |
+| `/refactor [target]` | 🔧 Code refactoring     | `/refactor extract utils` |
+| `/fix [error]`       | ⚡ Quick-fix (<60s)     | `/fix build error`        |
+| `/dev`               | ▶️ Start dev server     | `/dev`                    |
+| `/git [cmd]`         | 🔀 Git operations       | `/git commit`             |
+
+### Planning & Design
+
+| Command             | Description         | Example                |
+| ------------------- | ------------------- | ---------------------- |
+| `/plan [feature]`   | 📋 Feature planning | `/plan shopping cart`  |
+| `/think [topic]`    | 💡 Brainstorming    | `/think architecture`  |
+| `/visualize [page]` | 🖼️ UI/UX mockups    | `/visualize dashboard` |
+
+### Quality & Ops
+
+| Command    | Description              | Example           |
+| ---------- | ------------------------ | ----------------- |
+| `/ap`      | 🔬 Full 5-expert audit   | `/ap`             |
+| `/review`  | 👀 Code review           | `/review pr #123` |
+| `/perf`    | ⚡ Performance profiling | `/perf cpu`       |
+| `/deploy`  | 🚀 Deploy to production  | `/deploy staging` |
+| `/monitor` | 📡 Observability setup   | `/monitor logs`   |
+
+### Generation & Scaffold
+
+| Command                   | Description              | Example                  |
+| ------------------------- | ------------------------ | ------------------------ |
+| `/generate [type] [name]` | 🏗️ Code generation       | `/generate api Users`    |
+| `/scaffold [pattern]`     | 🏗️ From project patterns | `/scaffold crud Product` |
+| `/doc`                    | 📚 Documentation         | `/doc api`               |
+
+### Management
+
+| Command    | Description           | Example        |
+| ---------- | --------------------- | -------------- |
+| `/status`  | 📊 Project health     | `/status`      |
+| `/recap`   | 📖 Session summary    | `/recap`       |
+| `/upgrade` | 📦 Update deps        | `/upgrade`     |
+| `/env`     | 🔐 Environment config | `/env scan`    |
+| `/revert`  | ⏪ Rollback changes   | `/revert last` |
+
+---
+
+## 💡 Tips
+
+- Commands auto-detect your tech stack
+- Use `/help [command]` for details
+- `/status` shows project health at a glance
+- `/recap` summarizes your session
+
+### Having Issues?
+
+1. `/debug` with error message
+2. `/status` for project health
+3. `/recap` to see context