@nockdev/awf 6.2.0 → 6.2.2

package/.agent/rules/modules/performance-optimization.yaml

@@ -0,0 +1,141 @@
+# Performance Optimization Rule v6.2.2
+# Model selection, context management, token budget
+
+---
+name: performance-optimization
+version: "6.2.2"
+rule_id: "MOD-PERF-001"
+
+# =============================================================================
+# RULE METADATA
+# =============================================================================
+
+description: |
+  Guidelines for performance optimization of AI agent operations:
+  model selection, context window management, token budget,
+  and efficient tool usage patterns.
+
+category: "engineering"
+
+# =============================================================================
+# CONTEXT APPLICATION
+# =============================================================================
+
+context:
+  always_apply: true
+  personas: ["all"]
+  workflows: ["all"]
+
+# =============================================================================
+# MODEL SELECTION
+# =============================================================================
+
+model_selection:
+  guidelines:
+    - scenario: "Simple code generation, formatting"
+      recommended: "Fast model (flash/mini)"
+      reason: "Low complexity, speed matters"
+
+    - scenario: "Complex architecture, debugging"
+      recommended: "Strong model (opus/pro)"
+      reason: "Requires deep reasoning"
+
+    - scenario: "Code review, refactoring"
+      recommended: "Balanced model (sonnet/standard)"
+      reason: "Good reasoning at reasonable cost"
+
+    - scenario: "Data parsing, extraction"
+      recommended: "Fast model (flash/mini)"
+      reason: "Pattern matching, not reasoning"
+
+# =============================================================================
+# CONTEXT MANAGEMENT
+# =============================================================================
+
+context_management:
+  principles:
+    - name: "Minimal Context"
+      rule: "Include only relevant files/sections"
+      anti_pattern: "Loading entire codebase into context"
+
+    - name: "Progressive Loading"
+      rule: "Start with summary, load detail on demand"
+      technique: "Use file outline first, then view specific functions"
+
+    - name: "Context Freshness"
+      rule: "Re-read files that may have changed"
+      when: "After edits, before verification"
+
+    - name: "Compaction"
+      rule: "Summarize long context when approaching limits"
+      trigger: "Context exceeds 60% of window"
+
+# =============================================================================
+# TOKEN BUDGET
+# =============================================================================
+
+token_budget:
+  allocation:
+    system_prompt: "10%"
+    skill_loading: "15%"
+    code_context: "40%"
+    reasoning: "25%"
+    output: "10%"
+
+  optimization:
+    - "Use view_file_outline before full file read"
+    - "Grep for specific patterns instead of reading entire files"
+    - "Load META.yaml (T1) before SKILL.md (T2)"
+    - "Limit data file reads to relevant sections"
+    - "Avoid loading ADVANCED.md (T3) unless referenced"
+
+# =============================================================================
+# EFFICIENT TOOL USAGE
+# =============================================================================
+
+tool_efficiency:
+  patterns:
+    - name: "Parallel tool calls"
+      rule: "Call independent tools in parallel"
+      example: "Read 3 files simultaneously"
+
+    - name: "Targeted search"
+      rule: "Use grep before listing/reading directories"
+      anti_pattern: "list_dir → view_file for every file"
+
+    - name: "Batch edits"
+      rule: "Use multi_replace for multiple edits in same file"
+      anti_pattern: "Separate edit calls for each change"
+
+    - name: "Early termination"
+      rule: "Stop searching after finding the answer"
+      anti_pattern: "Reading all files when first match suffices"
+
+# =============================================================================
+# CHECKLIST
+# =============================================================================
+
+checklist:
+  - "Am I loading only necessary context?"
+  - "Could I use a lighter/faster model for this?"
+  - "Am I making parallel tool calls where possible?"
+  - "Have I used targeted search instead of browsing?"
+  - "Is my context within budget?"
+
+# =============================================================================
+# INTEGRATION
+# =============================================================================
+
+integration:
+  tier: 2
+  related_modules:
+    - yagni
+    - stop-conditions
+
+  reflection:
+    enabled: true
+    check_before: "tool_call"
+    question: "Is this the most efficient way to get the information I need?"
+
+---
+_DOMYH Awesome Code • Performance Optimization Rule_

package/.agent/rules/modules/quality.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: quality
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-QLT-001"
 
 # =============================================================================

package/.agent/rules/modules/stop-conditions.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: stop-conditions
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-STP-001"
 
 # =============================================================================

package/.agent/rules/modules/terminal-safety.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: terminal-safety
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-TRM-001"
 
 # =============================================================================
@@ -173,6 +173,50 @@ output_verification:
     - relevant_output
     - any_errors
 
+# =============================================================================
+# OUTPUT FORMATTING (CLI COMMANDS)
+# =============================================================================
+
+output_formatting:
+  rule_id: "MOD-TRM-002"
+  description: |
+    CLI/terminal output MUST use ASCII-safe characters only.
+    Emoji and Unicode icons render incorrectly on:
+    - Windows CMD and older PowerShell (< 7)
+    - CI/CD pipeline logs (GitHub Actions, Jenkins, GitLab CI)
+    - SSH remote terminals
+    - Screen readers (accessibility)
+
+  cli_output_rules:
+    - id: "TRM-002-001"
+      rule: "NO emoji or Unicode icons in console.log/Write-Host terminal output"
+      wrong: 'console.log("✅ Done") or console.log("📋 Summary")'
+      right: 'console.log(pc.green("[OK]") + " Done") or console.log(pc.bold("[i] Summary"))'
+
+    - id: "TRM-002-002"
+      rule: "Use text markers with color (picocolors/chalk) instead of emoji icons"
+      mapping:
+        success: 'pc.green("[OK]") or pc.green("+")'
+        warning: 'pc.yellow("[!]") or pc.yellow("WARN")'
+        error: 'pc.red("[X]") or pc.red("ERR")'
+        info: 'pc.cyan("[i]") or pc.blue(">")'
+        check_pass: 'pc.green("[v]")'
+        check_fail: 'pc.red("[x]")'
+        skip: 'pc.dim("[-]") or pc.dim("~")'
+        progress: 'pc.cyan("[*]") or pc.cyan("...")'
+
+    - id: "TRM-002-003"
+      rule: "Exception: Emoji in documentation and config files is allowed"
+      details: |
+        Emoji in rootConfig files (.cursorrules, GEMINI.md, etc.), SKILL.md,
+        workflow descriptions, and other files READ BY LLM (not displayed in terminal)
+        is acceptable. This rule only applies to console.log/terminal output.
+
+  checklist:
+    - "No emoji or Unicode icons in console.log()?"
+    - "Using picocolors/chalk for status indicators?"
+    - "Text markers are ASCII-only ([OK], [!], [X])?"
+
 # =============================================================================
 # SHELL INTEGRATION
 # =============================================================================

package/.agent/rules/modules/yagni.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: yagni-enforcement
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-YAG-001"
 
 # =============================================================================

package/.agent/rules/validation-framework.md

@@ -6,7 +6,7 @@ category: quality
 version: "4.5"
 ---
 
-# ✅ Validation Framework v6.2.0
+# ✅ Validation Framework v6.2.2
 
 > 🌍 **Language / Ngôn ngữ**: English (default) | [Tiếng Việt](#tiếng-việt)
 > 📝 **Note**: Consolidates `pre-check-validation.md` + `architecture-aware-implementation.md`

package/.agent/skills/DEVELOPMENT.yaml

@@ -1,6 +1,6 @@
 # DOMYH Awesome Code — Skill Development Guide
 # How to create and maintain skills
-# Version: 6.1.2
+# version: 6.2.2
 
 # =============================================================================
 # 📋 OVERVIEW
@@ -63,7 +63,7 @@ workflow:
       template: |
         name: new-skill
         display: New Skill Name
-        category: language  # or framework, devops, support
+        category: language  # or framework, devops, cross-cutting, tooling, ai-ml
         priority: 2
         desc: "Brief description under 80 chars"
         keywords:
@@ -148,12 +148,23 @@ categories:
   devops:
     priority: 3
     description: "Infrastructure and deployment"
-    examples: [docker, kubernetes, aws, ci-cd]
+    examples: [docker, kubernetes, aws, ci-cd, terraform, gcp, azure]
 
-  support:
-    priority: 2
+  cross-cutting:
+    priority: 4
     description: "Cross-cutting concerns"
-    examples: [database, testing]
+    examples: [database, testing, tailwind, audit-pro, playwright]
+
+  tooling:
+    priority: 5
+    description: "Developer tools, protocols, and extensions"
+    examples: [mcp, api-protocols, ide-extension, cli-dev, browser-agent]
+
+  ai-ml:
+    priority: 6
+    description: "AI/ML agent systems, Gemini APIs, and RAG patterns"
+    examples:
+      [ai-agents, prompt-engineering, gemini-media-gen, gemini-tts, gemini-live]
 
 # =============================================================================
 # 🎯 BEST PRACTICES

package/.agent/skills/README.md

@@ -6,24 +6,27 @@
 
 ## Quick Reference
 
-| Metric          | Value                  |
-| --------------- | ---------------------- |
-| Total Skills    | 60                     |
-| Total META Size | 18.2KB                 |
-| Avg per skill   | 325 bytes (~81 tokens) |
-| Max active      | 3 skills               |
+| Metric          | Value                 |
+| --------------- | --------------------- |
+| Total Skills    | 82                    |
+| Total META Size | ~17KB                 |
+| Avg per skill   | ~300 bytes (~100 tok) |
+| Max detected    | 5 META.yaml           |
+| Max active T2   | 3 SKILL.md            |
 
 ---
 
 ## Categories
 
-| Category               | Skills                                                                                                     | Priority   |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ---------- |
-| **Core** (6)           | security, api-design, error-handling, logging, observability, authentication                               | 0 (always) |
-| **Language** (28)      | go, python, typescript, javascript, rust, cpp, c, csharp, java, php, kotlin, swift, lua, asm               | 1          |
-| **Framework** (8)      | react, vue, nextjs, nuxt, angular, svelte, flutter, react-native                                           | 2          |
-| **DevOps** (4)         | docker, kubernetes, aws, ci-cd                                                                             | 3          |
-| **Cross-cutting** (14) | database, testing, tailwind, ui-ux-pro-max, web-perf, sql, bun, deno, coding-rules, electron, react-native | 2          |
+| Category               | Skills                                                                                                | Priority   |
+| ---------------------- | ----------------------------------------------------------------------------------------------------- | ---------- |
+| **Core** (6)           | security, api-design, error-handling, logging, observability, authentication                          | 0 (always) |
+| **Language** (28)      | go, python, typescript, javascript, rust, cpp, c, csharp, java, php, kotlin, swift, lua, asm, ...     | 1          |
+| **Framework** (8)      | react, vue, nextjs, nuxt, angular, svelte, flutter, react-native                                      | 2          |
+| **DevOps** (7)         | docker, kubernetes, aws, ci-cd, terraform, gcp, azure                                                 | 3          |
+| **Cross-cutting** (21) | testing, database, sql, tailwind, electron, coding-rules, domyh-design, web-perf, playwright, ...     | 4          |
+| **Tooling** (5)        | mcp, api-protocols, ide-extension, cli-dev, browser-agent                                             | 5          |
+| **AI-ML** (7)          | ai-agents, prompt-engineering, rag-patterns, vector-search, gemini-media-gen, gemini-tts, gemini-live | 6          |
 
 ---
 
@@ -37,13 +40,13 @@
 
 ---
 
-## META.yaml Schema (v6.2.0)
+## META.yaml Schema (v6.2.2)
 
 ```yaml
 name: skill-id          # lowercase, hyphen-separated
 display: Display Name   # Human-readable
-category: language      # core|language|framework|devops|support
-priority: 1             # 0-5 (lower = higher)
+category: language      # core|language|framework|devops|cross-cutting|tooling|ai-ml
+priority: 1             # 0-6 (lower = higher)
 desc: "Short desc"      # Max 80 chars
 keywords: [kw1, kw2]    # Max 5-7 keywords
 detect: [*.ext, file]   # File patterns

package/.agent/skills/_categories.yaml

@@ -79,7 +79,7 @@ categories:
       - react-native
 
   # ==========================================================================
-  # DEVOPS (4 skills)
+  # DEVOPS (7 skills)
   # ==========================================================================
   devops:
     description: "Infrastructure and deployment"
@@ -90,6 +90,10 @@ categories:
       - kubernetes
       - aws
       - ci-cd
+      # v6.3 New
+      - terraform
+      - gcp
+      - azure
 
   # ==========================================================================
   # CORE (6 skills - always loaded)
@@ -108,7 +112,7 @@ categories:
       - authentication
 
   # ==========================================================================
-  # CROSS-CUTTING (10 skills)
+  # CROSS-CUTTING (21 skills)
   # ==========================================================================
   cross-cutting:
     description: "Cross-cutting concerns and utilities"
@@ -121,25 +125,73 @@ categories:
       - tailwind
       - electron
       - coding-rules
-      - ui-ux-pro-max
+      - domyh-design
       - web-perf
       - deno
       - bun
       - audit-pro
 
+      # P0 Skills (v6.2.2)
+      - tdd-workflow
+      - accessibility
+      - seo
+
+      # P1 Skills (v6.2.2)
+      - microservices
+      - monorepo
+
+      # v6.3 New
+      - tauri
+      - real-time
+      - event-driven
+      - wasm
+      - playwright
+
+  # ==========================================================================
+  # TOOLING (5 skills) — NEW v6.3
+  # ==========================================================================
+  tooling:
+    description: "Development tools, protocols, and extensions"
+    path: "tooling/"
+    priority: 2
+    skills:
+      - mcp
+      - ide-extension
+      - cli-dev
+      - api-protocols
+      - browser-agent
+
+  # ==========================================================================
+  # AI-ML (7 skills) — v6.3 + Google AI
+  # ==========================================================================
+  ai-ml:
+    description: "AI/ML agent systems, vector search, prompt engineering, and Gemini APIs"
+    path: "ai-ml/"
+    priority: 3
+    skills:
+      - ai-agents
+      - vector-search
+      # Migrated from cross-cutting
+      - prompt-engineering
+      - rag-patterns
+      # v6.3 New — Google AI
+      - gemini-media-gen
+      - gemini-tts
+      - gemini-live
+
 # =============================================================================
 # STATISTICS
 # =============================================================================
 
 stats:
-  total_skills: 56
-  categories: 5
+  total_skills: 82
+  categories: 7
   estimated_tokens:
-    all_meta: 5600 # ~100 tokens × 56
+    all_meta: 8200 # ~100 tokens × 82
     router_only: 500 # Router + core META
-    typical_session: 2500 # Router + 2 language + 1 framework
+    typical_session: 3000 # Router + 2 language + 1 framework + 1 tooling
 
 
 # =============================================================================
-# _DOMYH Awesome Code • Category Definitions_
+# _DOMYH Awesome Code • Category Definitions v6.3_
 # =============================================================================

package/.agent/skills/_router.yaml

@@ -54,20 +54,14 @@ strategy:
     - "ADVANCED.md" # Reference only when explicitly needed
 
 # =============================================================================
-# P0-P2 INTEGRATION (v1.1)
+# SELECTION CONFIG
 # =============================================================================
-# References core/ROUTER.yaml for full implementation
 
 selection:
-  # P0: Dynamic threshold (see core/ROUTER.yaml for full config)
-  threshold_config: "$ref:core/ROUTER.yaml#/selection/threshold"
-  default_threshold: 0.50
-
-  # P1: Query expansion (see core/ROUTER.yaml for synonyms)
-  query_expansion: "$ref:core/ROUTER.yaml#/query_expansion"
-
-  # P2: Confidence scoring
-  confidence_scoring: "$ref:core/ROUTER.yaml#/confidence_scoring"
+  default_threshold: 0.30
+  recency_boost: 0.15
+  max_active_skills: 5 # Max T1 META.yaml detected
+  max_active_t2: 3 # Max SKILL.md loaded simultaneously
 
 # =============================================================================
 # CATEGORY ROUTING
@@ -93,10 +87,10 @@ routing:
   devops:
     path: "skills/devops/"
     detect_by:
-      - "special_file" # Dockerfile, k8s/
+      - "special_file" # Dockerfile, k8s/, *.tf
       - "directory" # .github/workflows/
     priority: 3
-    count: 4
+    count: 7
 
   core:
     path: "skills/core/"
@@ -104,17 +98,27 @@ routing:
     priority: 0
     count: 6
 
+  private:
+    path: "private/"
+    detect_by:
+      - "keyword"
+      - "dependency"
+    priority: -1 # Highest priority — overrides public skills
+    count: 0 # Dynamic: read from private/_index.yaml
+    registry: "private/_index.yaml"
+    note: "Gitignored private skills, not in public repo"
+
   cross-cutting:
     path: "skills/cross-cutting/"
     detect_by:
       - "dependency"
       - "extension"
     priority: 4
-    count: 10
+    count: 21
 
-    # UI/UX Pro Max skill - integrated with HSA adapter
+    # HSA adapter overrides for cross-cutting skills
     skills:
-      ui-ux-pro-max:
+      domyh-design:
         adapter: "hsa.adapters.uiux_adapter"
         preload_data: true
         triggers:
@@ -138,7 +142,6 @@ routing:
             - "typography"
             - "font pairing"
 
-      # Electron skill - integrated with dedicated HSA YAML-based adapter
       electron:
         adapter: "hsa.adapters.electron_adapter"
         data_dir: "skills/cross-cutting/electron/data"
@@ -165,7 +168,6 @@ routing:
             - "better-sqlite3"
             - "electron-store"
 
-      # Tailwind skill - integrated with dedicated HSA YAML-based adapter
       tailwind:
         adapter: "hsa.adapters.tailwind_adapter"
         data_dir: "skills/cross-cutting/tailwind/data"
@@ -197,6 +199,22 @@ routing:
             - "lightning css"
             - "Vite plugin"
 
+  tooling:
+    path: "skills/tooling/"
+    detect_by:
+      - "special_file" # mcp.json, .vscode/extensions.json
+      - "dependency" # @modelcontextprotocol/sdk
+    priority: 5
+    count: 5
+
+  ai-ml:
+    path: "skills/ai-ml/"
+    detect_by:
+      - "dependency" # langchain, openai, pinecone
+      - "keyword" # RAG, embeddings, vector, gemini
+    priority: 6
+    count: 7
+
 # =============================================================================
 # SKILL RESOLUTION
 # =============================================================================
@@ -215,6 +233,29 @@ resolution:
     docker: "devops/docker"
     security: "core/security"
     testing: "cross-cutting/testing"
+    # v6.3 new aliases
+    mcp: "tooling/mcp"
+    graphql: "tooling/api-protocols"
+    trpc: "tooling/api-protocols"
+    grpc: "tooling/api-protocols"
+    ai-agents: "ai-ml/ai-agents"
+    langchain: "ai-ml/ai-agents"
+    vector-search: "ai-ml/vector-search"
+    tauri: "cross-cutting/tauri"
+    websocket: "cross-cutting/real-time"
+    sse: "cross-cutting/real-time"
+    kafka: "cross-cutting/event-driven"
+    rabbitmq: "cross-cutting/event-driven"
+    nats: "cross-cutting/event-driven"
+    terraform: "devops/terraform"
+    gcp: "devops/gcp"
+    azure: "devops/azure"
+    wasm: "cross-cutting/wasm"
+    webassembly: "cross-cutting/wasm"
+    playwright: "cross-cutting/playwright"
+    e2e: "cross-cutting/playwright"
+    browser-testing: "cross-cutting/playwright"
+    browser-agent: "tooling/browser-agent"
 
 # =============================================================================
 # TOKEN BUDGET
@@ -228,5 +269,6 @@ token_budget:
 
 
 # =============================================================================
-# _DOMYH Awesome Code • Hierarchical Skill Router_
+# _DOMYH Awesome Code • Hierarchical Skill Router v6.3_
 # =============================================================================
+