@nockdev/awf 6.2.0

package/.agent/workflows/think.md

@@ -0,0 +1,126 @@
+---
+description: "💡 Think Pro : 6 methods, 5 tiers, multi-mode reasoning"
+skills: { required: [], contextual: [] }
+---
+
+# 💡 /think — Think Pro
+
+> 6 Thinking Methods • 5 Tiers • Multi-Mode Reasoning
+> 📚 Evidence-Based Decisions • Structured Analysis • Cognitive Frameworks
+
+---
+
+## THINK FLOW
+
+1. **CONTEXT** — Detect project, review constraints via HSA (`hsa_get_context`). Show: `[Step 1/5] Gathering context...`
+2. **BRAINSTORM** — Apply selected method, generate options
+3. **EVALUATE** — Score and compare ideas with evidence. Show: `[Step 3/5] Evaluating 4 options...`
+4. **DECIDE** — Recommend with rationale and confidence score
+5. **VALIDATE** — Present recommendation to user → ⛔ STOP: confirm direction
+
+---
+
+## COMMANDS
+
+### Core
+
+| Command                      | Method              | Token Budget |
+| ---------------------------- | ------------------- | ------------ |
+| `/think [topic]`             | Auto-select         | 2000-4000    |
+| `/think brainstorm [topic]`  | Mind Mapping        | 1000-2000    |
+| `/think analyze [decision]`  | Six Thinking Hats   | 4000-6000    |
+| `/think deep [architecture]` | Tree of Thought     | 10000-20000  |
+| `/think solve [problem]`     | Reverse + SCAMPER   | 3000-5000    |
+| `/think plan [feature]`      | Starbursting (5W1H) | 3000-5000    |
+| `/think tradeoff [options]`  | Weighted matrix     | 2000-4000    |
+
+### Mode
+
+| Command            | Mode    | Constraints                  |
+| ------------------ | ------- | ---------------------------- |
+| `/think --explore` | Explore | No criticism, quantity focus |
+| `/think --debate`  | Debate  | Argue both sides             |
+| `/think --plan`    | Plan    | Actionable steps only        |
+
+---
+
+## 📊 5-TIER SYSTEM
+
+| Tier | Name                   | Tokens | Method                           | Output                                     |
+| ---- | ---------------------- | ------ | -------------------------------- | ------------------------------------------ |
+| 1    | Quick Brainstorm       | 1-2K   | Mind Mapping                     | Branch tree → ⭐ Top Pick                  |
+| 2    | Structured Analysis    | 4-6K   | Six Thinking Hats (⚪🔴⚫🟡🟢🔵) | Per-hat analysis → ⭐ Recommendation       |
+| 3    | Deep Exploration       | 10-20K | Tree of Thought (3 paths)        | Path comparison → ⭐ Recommended Path      |
+| 4    | Problem Solving        | 3-5K   | Reverse + SCAMPER                | Anti-problem insights → ⭐ Recommended Fix |
+| 5    | Comprehensive Planning | 3-5K   | Starbursting (5W1H)              | Questions matrix → handoff to `/plan`      |
+
+---
+
+## 🧠 REASONING ARCHITECTURES
+
+| Architecture     | Use When             | Overhead  | Accuracy |
+| ---------------- | -------------------- | --------- | -------- |
+| Chain of Thought | Single-path problems | +20-30%   | +15-25%  |
+| Tree of Thought  | Multi-path decisions | +100-200% | +30-50%  |
+| ReAct Loop       | Investigation needed | +50-100%  | +20-40%  |
+
+ReAct Pattern: `Thought → Action [Search/Read/Test] → Observation → Repeat until conclusion`
+
+---
+
+## 🎭 MODE SYSTEM
+
+| Mode        | Allow                | Forbid                 | Output        |
+| ----------- | -------------------- | ---------------------- | ------------- |
+| **Explore** | Wild ideas, quantity | Criticism, feasibility | Bullet list   |
+| **Debate**  | All perspectives     | Bias, one-sided        | Pro/con table |
+| **Plan**    | Actionable steps     | Vague ideas            | Numbered plan |
+
+---
+
+## 🧮 DECISION FRAMEWORK
+
+### Weighted Scoring (for `/think tradeoff`)
+
+| Criteria          | Weight |
+| ----------------- | ------ |
+| Performance       | 30%    |
+| Maintainability   | 25%    |
+| Time to implement | 20%    |
+| Scalability       | 15%    |
+| Cost              | 10%    |
+
+### Quick Decision Rule
+
+- **Reversible** → Decide fast, iterate
+- **Irreversible** → Research deeper (Tier 3)
+
+### Output Format
+
+```
+## Recommendation: [Option B] (Confidence: 8/10)
+
+### Scoring Matrix
+| Criteria        | Option A | Option B | Option C |
+| --------------- | -------- | -------- | -------- |
+| Performance     | 7        | 9        | 6        |
+| Maintainability | 8        | 7        | 9        |
+| Weighted Score  | 7.3      | 8.1      | 7.0      |
+
+### Rationale
+[Evidence-based reasoning for recommendation]
+
+### Risks & Mitigations
+- Risk 1: [description] → Mitigation: [action]
+```
+
+---
+
+## ⚠️ ANTI-PATTERNS
+
+| Don't                    | Do Instead                 |
+| ------------------------ | -------------------------- |
+| Analysis paralysis       | Set time box, decide       |
+| Premature optimization   | Solve the problem first    |
+| Solution without problem | Define problem clearly     |
+| Bikeshedding             | Focus on high-impact items |

package/.agent/workflows/upgrade.md

@@ -0,0 +1,109 @@
+---
+description: "📦 Update dependencies: check outdated, apply safe updates, review breaking changes"
+skills: { required: [], contextual: [auto] }
+---
+
+# 📦 /upgrade — Upgrade Pro
+
+> Security-First Dependency Updates
+> 📚 Multi-language • Vulnerability Scanning • Safe Update Order • Changelog Review
+
+---
+
+## UPGRADE FLOW
+
+1. **DETECT** — Detect stack via HSA (`hsa_detect_stack`), detect package manager, list outdated. Show: `[Step 1/5] Scanning 127 dependencies...`
+2. **PLAN** — Check changelogs, identify breaking changes, classify by semver. Show: `Found: 3 security, 8 patch, 4 minor, 2 major`
+3. **EXECUTE** — Apply patches first, then minor, then major → ⛔ STOP before major updates
+4. **VERIFY** — Run tests, build, lint after each batch. Show: `[Step 4/5] Tests: ✅ 42/42 passed`
+5. **SYNC** — Summary of updates, failed updates, breaking changes noted. `hsa_check_changes`
+
+---
+
+## COMMANDS
+
+| Command             | Description         | Scope     |
+| ------------------- | ------------------- | --------- |
+| `/upgrade`          | Check outdated      | List only |
+| `/upgrade patch`    | Apply patches       | Safe      |
+| `/upgrade minor`    | Apply minor updates | Review    |
+| `/upgrade major`    | Major update guide  | Manual    |
+| `/upgrade security` | Security fixes only | Critical  |
+| `/upgrade --dry`    | Preview only        | Safe      |
+| `/upgrade lockfile` | Regenerate lockfile | Lockfile  |
+
+---
+
+## 🔧 DEPENDENCY TOOLS
+
+| Language   | Check Outdated                            | Update                             | Security Scan                      |
+| ---------- | ----------------------------------------- | ---------------------------------- | ---------------------------------- |
+| Go         | `go list -m -u all`                       | `go get -u`                        | `govulncheck ./...`                |
+| TypeScript | `npm outdated`                            | `npm update`                       | `npm audit`                        |
+| Python     | `pip list --outdated`                     | `pip install -U`                   | `pip-audit`                        |
+| Rust       | `cargo outdated`                          | `cargo update`                     | `cargo audit`                      |
+| Java       | `mvn versions:display-dependency-updates` | `mvn versions:use-latest-versions` | `mvn dependency-check:check`       |
+| C#         | `dotnet list package --outdated`          | `dotnet add package`               | `dotnet list package --vulnerable` |
+| Ruby       | `bundle outdated`                         | `bundle update`                    | `bundle audit`                     |
+| PHP        | `composer outdated`                       | `composer update`                  | `composer audit`                   |
+
+---
+
+## 📊 UPDATE ORDER (Safety First)
+
+| Priority | Type             | Risk        | Action                            |
+| -------- | ---------------- | ----------- | --------------------------------- |
+| 1        | Security patches | 🔴 Critical | Update immediately                |
+| 2        | Bug fix patches  | 🟢 Low      | Batch update                      |
+| 3        | Minor updates    | 🟡 Medium   | One at a time, test               |
+| 4        | Major updates    | 🔴 High     | Separate branch, review changelog |
+
+---
+
+## 🔒 SECURITY WORKFLOW
+
+| Severity | Response Time | Action               |
+| -------- | ------------- | -------------------- |
+| Critical | Immediately   | Update, deploy       |
+| High     | Within 24h    | Update, test, deploy |
+| Medium   | Within 1 week | Schedule update      |
+| Low      | Next cycle    | Track                |
+
+---
+
+## 🤖 AUTOMATION
+
+| Tool           | Purpose        | Config File              |
+| -------------- | -------------- | ------------------------ |
+| **Dependabot** | GitHub native  | `.github/dependabot.yml` |
+| **Renovate**   | Multi-platform | `renovate.json`          |
+| **Socket**     | Supply chain   | `.socket.yml`            |
+
+> Best practice: Auto-merge patches, review minor, block major
+
+---
+
+## ✅ UPGRADE CHECKLIST
+
+- Before: Tests passing, clean git, backup lockfile
+- During: Security first, check changelog, one at a time for major
+- After: Tests pass, build OK, no new vulns, commit w/ lockfile
+
+---
+
+## 📊 REPORT FORMAT
+
+```
+📦 Upgrade Report
+
+✅ Updated: 11 packages
+  - 3 security patches (critical)
+  - 5 bug fix patches
+  - 3 minor updates
+
+⚠️ Skipped: 2 major updates (require review)
+  - react 18 → 19 (breaking: new JSX transform)
+  - prisma 4 → 5 (breaking: client generation)
+
+Tests: ✅ 42/42 | Build: ✅ Pass | Lint: ✅ 0 issues
+```

package/.agent/workflows/visualize.md

@@ -0,0 +1,295 @@
+---
+description: "🖼️ UI/UX Design: mockups, wireframes, component design, visual prototyping"
+skills: { required: [ui-ux-pro-max], contextual: [] }
+---
+
+# 🖼️ /visualize — Visualize Pro
+
+> Component-First UI Design with Research-Backed Standards
+> 📚 Multi-platform • Design Tokens (DTCG 2025.10) • A11y (WCAG 2.2) • VRT
+
+---
+
+## VISUALIZE FLOW
+
+1. **DETECT** — Detect stack via HSA (`hsa_detect_stack`), load UI context (`hsa_get_context`), search existing components FIRST (70-90% token savings). Show: `[Step 1/8] Found 12 reusable components`
+2. **PLAN** — Generate props/layout, not full code. Choose wireframe template, define a11y requirements. Show: `[Step 2/8] Designing Dashboard layout...`
+3. **TOKENS** — Generate/load design tokens (W3C DTCG 2025.10 format). Apply platform-specific tokens (M3/HIG/Web). Show: `[Step 3/8] Loading design tokens...`
+4. **PREVIEW** — Show wireframe/mockup → ⛔ **STOP — confirm before building**
+5. **EXECUTE** — Build using mapped components + new ones, apply design system
+6. **RESPONSIVE** — Container query verification + fluid typography check + breakpoint validation
+7. **VERIFY** — A11y audit (axe-core) + contrast ratio + Lighthouse score + VRT baseline
+8. **SYNC** — `hsa_check_changes` to update index, save design decisions to memory
+
+---
+
+## COMMANDS
+
+| Command                        | Platform           | Output                  |
+| ------------------------------ | ------------------ | ----------------------- |
+| `/visualize web [page]`        | React/Vue/Svelte   | JSX + CSS               |
+| `/visualize mobile [screen]`   | Flutter/RN/SwiftUI | Dart/JSX/Swift          |
+| `/visualize desktop [window]`  | WPF/Qt/Electron    | XAML/QML/HTML           |
+| `/visualize component [name]`  | Auto-detect        | Component code          |
+| `/visualize system`            | All                | Design tokens + docs    |
+| `/visualize dark-mode`         | All                | Dark tokens + toggle    |
+| `/visualize responsive [page]` | Web                | Container query check   |
+| `/visualize a11y [page]`       | All                | WCAG 2.2 audit report   |
+| `/visualize animation [type]`  | Web/Mobile         | Micro-interaction code  |
+| `/visualize tokens`            | All                | Export/import DTCG JSON |
+| `/visualize migrate [from]`    | All                | Design token migration  |
+| `/visualize compare`           | All                | VRT screenshot diff     |
+
+---
+
+## 🧩 COMPONENT MAPPING (KEY FEATURE)
+
+### Priority: Map BEFORE Generate
+
+1. **Index** — Scan `src/components`, `components`, `src/ui`
+2. **Match** — Request → existing components (70-90% reuse)
+3. **Gap** — Only generate missing components
+
+---
+
+## 🎨 DESIGN TOKENS (W3C DTCG 2025.10)
+
+> Standard: [W3C Design Tokens Community Group 2025.10 Stable](https://w3.org/groups/cg/design-tokens/)
+
+### Token Format
+
+```json
+{
+  "$name": "color.primary",
+  "$type": "color",
+  "$value": "oklch(60% 0.15 250)",
+  "$description": "Primary brand color",
+  "$extensions": {
+    "com.domyh.platforms": ["web", "ios", "android", "flutter"]
+  }
+}
+```
+
+### Color System (Modern CSS)
+
+| Token   | Web CSS (OKLCH)       | Tailwind      | Flutter (`fromSeed`)   | SwiftUI    |
+| ------- | --------------------- | ------------- | ---------------------- | ---------- |
+| primary | `oklch(60% 0.15 250)` | bg-blue-600   | `ColorScheme.fromSeed` | .blue      |
+| surface | `oklch(98% 0.01 250)` | bg-gray-100   | `Colors.grey[100]`     | .secondary |
+| error   | `oklch(55% 0.22 27)`  | bg-red-500    | `Colors.red`           | .red       |
+| text    | `oklch(15% 0.01 250)` | text-gray-900 | —                      | .primary   |
+
+### Spacing
+
+| Token | Web  | Tailwind | Flutter | SwiftUI |
+| ----- | ---- | -------- | ------- | ------- |
+| xs    | 4px  | p-1      | 4       | 4       |
+| sm    | 8px  | p-2      | 8       | 8       |
+| md    | 16px | p-4      | 16      | 16      |
+| lg    | 24px | p-6      | 24      | 24      |
+| xl    | 32px | p-8      | 32      | 32      |
+
+### Typography (Fluid via `clamp()`)
+
+| Token    | Web CSS                         | Flutter |
+| -------- | ------------------------------- | ------- |
+| heading1 | `clamp(2rem, 4vw, 3.5rem)`      | 32sp    |
+| heading2 | `clamp(1.5rem, 3vw, 2.5rem)`    | 24sp    |
+| body     | `clamp(1rem, 1.5vw, 1.125rem)`  | 16sp    |
+| caption  | `clamp(0.75rem, 1vw, 0.875rem)` | 12sp    |
+
+---
+
+## 🌗 DARK MODE STRATEGY
+
+### Implementation
+
+```css
+/* CSS Custom Properties + prefers-color-scheme */
+:root {
+  --bg: oklch(98% 0.01 250); /* Light: off-white (NOT #fff) */
+  --text: oklch(15% 0.01 250); /* Light: near-black (NOT #000) */
+  --surface: oklch(95% 0.01 250);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: oklch(15% 0.01 250); /* Dark: deep gray (NOT #000) */
+    --text: oklch(90% 0.01 250); /* Dark: off-white */
+    --surface: oklch(20% 0.01 250);
+  }
+}
+```
+
+### Rules
+
+- ❌ Never pure black `#000` / pure white `#fff` — causes eye strain
+- ✅ Use deep grays `oklch(15%)` and off-whites `oklch(90%)`
+- ✅ Re-evaluate brand colors for dark backgrounds
+- ✅ Provide user toggle + persist preference (localStorage)
+- ✅ Prevent "white flash" — apply theme before body loads
+
+---
+
+## 📱 PLATFORM GUIDELINES
+
+### Android — Material Design 3 Expressive
+
+| Aspect       | Standard                                            |
+| ------------ | --------------------------------------------------- |
+| Color System | Dynamic Color via `ColorScheme.fromSeed(seedColor)` |
+| Components   | NavigationBar, SegmentedButton, FilledButton        |
+| Typography   | Material Type Scale (M3)                            |
+| Navigation   | NavigationBar (bottom), NavigationDrawer (side)     |
+| Flutter      | `useMaterial3: true` + `dynamic_color` package      |
+| Shapes       | Rounded corners (M3 shape system)                   |
+
+### iOS — Apple HIG + Liquid Glass (2025)
+
+| Aspect          | Standard                                           |
+| --------------- | -------------------------------------------------- |
+| Principles      | Clarity, Consistency, Deference, Depth             |
+| Design Language | Liquid Glass (translucency, depth, fluid response) |
+| SwiftUI         | Preview-driven development                         |
+| Navigation      | TabView, NavigationSplitView                       |
+| Typography      | SF Pro (system), Dynamic Type sizes                |
+| Touch Targets   | Minimum 44pt                                       |
+
+---
+
+## 📐 WIREFRAME TEMPLATES
+
+| Pattern       | Layout                     | Use Case       |
+| ------------- | -------------------------- | -------------- |
+| Dashboard     | Header + Sidebar + Grid    | Admin panels   |
+| Detail Page   | Header + Content + Actions | Entity view    |
+| List + Filter | FilterBar + Table/Cards    | Data browsing  |
+| Auth Flow     | Centered card              | Login/Register |
+| Settings      | Sidebar nav + Form         | App settings   |
+| Landing       | Hero + Features + CTA      | Marketing      |
+
+---
+
+## 📱 RESPONSIVE STRATEGY
+
+### Container Queries (Component-Level)
+
+```css
+.card-container {
+  container-type: inline-size;
+  container-name: card;
+}
+@container card (min-width: 400px) {
+  .card {
+    flex-direction: row;
+  }
+}
+```
+
+### Breakpoints (Content-First)
+
+| Breakpoint | Width   | Target           |
+| ---------- | ------- | ---------------- |
+| mobile     | < 640px | Phones           |
+| tablet     | 768px   | Tablets          |
+| desktop    | 1024px  | Laptops          |
+| wide       | 1280px  | Full HD          |
+| ultra      | 1536px  | Ultra-wide / 2K+ |
+
+### Touch Targets
+
+| Platform | Minimum Size | Standard        |
+| -------- | ------------ | --------------- |
+| Web      | 44×44px      | WCAG 2.2        |
+| Android  | 48×48dp      | Material Design |
+| iOS      | 44×44pt      | Apple HIG       |
+
+---
+
+## ♿ ACCESSIBILITY (WCAG 2.2)
+
+### Automated Testing Tools
+
+| Tool       | Command                                                | Use Case        |
+| ---------- | ------------------------------------------------------ | --------------- |
+| axe-core   | `npx @axe-core/cli <url>`                              | Single page     |
+| Pa11y CI   | `npx pa11y-ci --config .pa11yci.json`                  | Batch pages     |
+| Lighthouse | `npx lighthouse <url> --only-categories=accessibility` | Full audit      |
+| Storybook  | Built-in axe-core addon (Storybook 9)                  | Component-level |
+
+### Checklist
+
+- Color contrast ≥ 4.5:1 (WCAG AA) / ≥ 7:1 (WCAG AAA)
+- Focus indicators visible (2px+ outline)
+- Keyboard navigable (Tab order, Enter/Space activation)
+- Touch targets ≥ platform minimum
+- Screen reader labels (aria-label, role, alt text)
+- Reduced motion support (`prefers-reduced-motion`)
+- Semantic HTML (heading hierarchy, landmarks)
+
+---
+
+## 🔍 VISUAL REGRESSION TESTING (VRT)
+
+| Tool       | Type        | Engine     | Best For                    |
+| ---------- | ----------- | ---------- | --------------------------- |
+| Playwright | Built-in    | pixelmatch | Free, integrated with E2E   |
+| Chromatic  | Cloud SaaS  | Storybook  | CDD teams (5k free/mo)      |
+| Percy      | Cloud SaaS  | AI-powered | Cross-browser (5k free/mo)  |
+| BackstopJS | Self-hosted | Puppeteer  | OSS, configurable scenarios |
+
+### Playwright VRT (recommended — free)
+
+```typescript
+await expect(page).toHaveScreenshot("dashboard.png");
+// On failure: generates actual, expected, diff images
+```
+
+---
+
+## 🖼️ AI IMAGE GENERATION
+
+| Command                      | Tool             | Formats                      |
+| ---------------------------- | ---------------- | ---------------------------- |
+| `/visualize generate [desc]` | `generate_image` | PNG, JPG, WebP               |
+| `/visualize mockup [comp]`   | `generate_image` | 1920×1080, 1280×720, 375×812 |
+
+---
+
+## 🔌 SKILL INTEGRATION (ui-ux-pro-max)
+
+> Auto-loaded via `skills: { required: [ui-ux-pro-max] }` in frontmatter
+
+### Script Invocation Per Command
+
+```bash
+SKILL_PATH=".agent/skills/cross-cutting/ui-ux-pro-max/scripts"
+
+# /visualize system — Generate complete design system
+python3 $SKILL_PATH/search.py "<product> <industry> <style>" --design-system -p "ProjectName"
+
+# /visualize web/mobile/desktop — Stack-specific guidelines
+python3 $SKILL_PATH/search.py "<query>" --stack html-tailwind   # web
+python3 $SKILL_PATH/search.py "<query>" --stack flutter          # mobile (Flutter)
+python3 $SKILL_PATH/search.py "<query>" --stack swiftui          # mobile (iOS)
+python3 $SKILL_PATH/search.py "<query>" --stack react-native     # mobile (RN)
+python3 $SKILL_PATH/search.py "<query>" --stack desktop          # desktop
+
+# /visualize component — Component decision + mapping
+python3 $SKILL_PATH/search.py "<component>" --domain ux
+
+# /visualize a11y — Accessibility guidelines
+python3 $SKILL_PATH/search.py "accessibility contrast focus" --domain ux
+
+# /visualize animation — Animation patterns
+python3 $SKILL_PATH/search.py "animation duration easing" --domain ux
+```
+
+### Direct Data Lookup (no script needed)
+
+| Command                 | Data File                       | Format                    |
+| ----------------------- | ------------------------------- | ------------------------- |
+| `/visualize tokens`     | `data/design-tokens.yaml`       | 46 tokens × 8 platforms   |
+| `/visualize responsive` | `data/platform-guidelines.yaml` | 12 platform breakpoints   |
+| `/visualize component`  | `data/component-mapping.yaml`   | 30 components with scores |
+| `/visualize dark-mode`  | `data/ux-guidelines.yaml`       | Dark mode contrast rules  |