@nockdev/awf 6.2.0

package/.agent/rules/shell-commands.md

@@ -0,0 +1,210 @@
+---
+trigger: always_on
+---
+
+# 🖥️ Shell-Aware Commands
+
+> 🌍 **Language / Ngôn ngữ**: English (default) | [Tiếng Việt](#tiếng-việt)
+> 📚 **Based on**: Microsoft PowerShell Docs, POSIX Shell Standards
+
+## ⚠️ CRITICAL: Shell Detection First
+
+Agent MUST detect shell BEFORE generating any terminal command.
+
+---
+
+## 🔍 Shell Detection
+
+### Detection Logic
+
+```yaml
+detect_shell:
+  powershell:
+    indicators:
+      - "$env:PSModulePath exists"
+      - "Terminal shows 'PS C:\\'"
+      - "$PSVersionTable.PSVersion"
+    version_check: "$PSVersionTable.PSVersion.Major"
+
+  cmd:
+    indicators:
+      - "COMSPEC contains cmd.exe"
+      - "Terminal shows 'C:\\>'"
+      - "No $ prefix in prompt"
+
+  bash:
+    indicators:
+      - "$SHELL contains 'bash' or 'zsh'"
+      - "Path starts with '/'"
+      - "uname command available"
+
+  action:
+    detected: "Use shell-specific syntax"
+    unknown: "Default to PowerShell on Windows, Bash on Unix"
+```
+
+---
+
+## 📋 Command Chaining Syntax
+
+### ✅ Correct Syntax by Shell
+
+| Shell              | Conditional (AND)        | Always Run    |
+| ------------------ | ------------------------ | ------------- |
+| **PowerShell 7+**  | `cmd1 && cmd2`           | `cmd1; cmd2`  |
+| **PowerShell 5.x** | `cmd1; if ($?) { cmd2 }` | `cmd1; cmd2`  |
+| **CMD**            | `cmd1 && cmd2`           | `cmd1 & cmd2` |
+| **Bash/Zsh**       | `cmd1 && cmd2`           | `cmd1; cmd2`  |
+
+### ❌ Common Mistakes
+
+```yaml
+# PowerShell 5.x (Windows default!)
+wrong: "git add . && git commit -m 'msg'"  # ❌ Fails!
+right: "git add .; git commit -m 'msg'"    # ✅ Works
+
+# CMD
+wrong: "npm install && npm start"   # ❌ Works but different
+right: "npm install & npm start"    # ✅ Native CMD
+```
+
+---
+
+## 🔄 Command Conversion Table
+
+### Git Commands
+
+| Operation     | PowerShell 5.x                         | PowerShell 7+/Bash                       | CMD                                      |
+| ------------- | -------------------------------------- | ---------------------------------------- | ---------------------------------------- |
+| Add + Commit  | `git add .; git commit -m 'msg'`       | `git add . && git commit -m 'msg'`       | `git add . & git commit -m "msg"`        |
+| Init + Remote | `git init; git remote add origin $url` | `git init && git remote add origin $url` | `git init & git remote add origin %url%` |
+
+### NPM Commands
+
+| Operation       | PowerShell 5.x               | PowerShell 7+/Bash             | CMD                           |
+| --------------- | ---------------------------- | ------------------------------ | ----------------------------- |
+| Install + Build | `npm install; npm run build` | `npm install && npm run build` | `npm install & npm run build` |
+| Test + Lint     | `npm test; npm run lint`     | `npm test && npm run lint`     | `npm test & npm run lint`     |
+
+### File Operations
+
+| Operation        | PowerShell               | Bash           | CMD             |
+| ---------------- | ------------------------ | -------------- | --------------- |
+| Check dir exists | `Test-Path .git`         | `test -d .git` | `if exist .git` |
+| List files       | `Get-ChildItem` or `ls`  | `ls -la`       | `dir`           |
+| Current dir      | `$PWD` or `Get-Location` | `pwd`          | `cd`            |
+| Remove dir       | `Remove-Item -Recurse`   | `rm -rf`       | `rmdir /s /q`   |
+
+---
+
+## 🧪 Environment Checks
+
+### Pre-Flight Commands by Shell
+
+#### PowerShell
+
+```powershell
+# Environment check
+Write-Host "=== ENVIRONMENT CHECK ==="
+$PWD                           # Working directory
+$PSVersionTable.PSVersion      # PowerShell version
+node -v 2>$null               # Node version
+go version 2>$null            # Go version
+```
+
+#### Bash
+
+```bash
+# Environment check
+echo "=== ENVIRONMENT CHECK ==="
+pwd                           # Working directory
+uname -a                      # OS info
+node -v 2>/dev/null          # Node version
+go version 2>/dev/null       # Go version
+```
+
+#### CMD
+
+```cmd
+:: Environment check
+echo === ENVIRONMENT CHECK ===
+cd                            :: Working directory
+ver                           :: Windows version
+node -v 2>nul                :: Node version
+go version 2>nul             :: Go version
+```
+
+---
+
+## 📋 Agent Decision Flow
+
+```
+Before generating ANY terminal command:
+    │
+    ▼
+┌───────────────────────────────────────┐
+│ 1. Which shell is active?             │
+│    ├── Check $PSVersionTable → PS     │
+│    ├── Check COMSPEC → CMD            │
+│    └── Check $SHELL → Bash/Zsh        │
+└───────────────────────────────────────┘
+    │
+    ▼
+┌───────────────────────────────────────┐
+│ 2. If PowerShell, check version       │
+│    ├── Major >= 7 → Use && syntax     │
+│    └── Major < 7 → Use ; syntax       │
+└───────────────────────────────────────┘
+    │
+    ▼
+┌───────────────────────────────────────┐
+│ 3. Generate shell-appropriate command │
+└───────────────────────────────────────┘
+```
+
+---
+
+## 📋 Checklist
+
+- [ ] Detected active shell?
+- [ ] Checked PowerShell version if PS?
+- [ ] Used correct chaining syntax?
+- [ ] Tested path separators (\ vs /)?
+- [ ] Environment variables correct ($var vs %var%)?
+
+---
+
+# Tiếng Việt
+
+> 🇻🇳 Phiên bản Tiếng Việt
+
+## Mô Tả
+
+Agent PHẢI phát hiện shell TRƯỚC khi tạo bất kỳ lệnh terminal nào.
+
+## Syntax Chaining
+
+| Shell          | Conditional              | Always        |
+| -------------- | ------------------------ | ------------- |
+| PowerShell 5.x | `cmd1; if ($?) { cmd2 }` | `cmd1; cmd2`  |
+| PowerShell 7+  | `cmd1 && cmd2`           | `cmd1; cmd2`  |
+| CMD            | `cmd1 && cmd2`           | `cmd1 & cmd2` |
+| Bash           | `cmd1 && cmd2`           | `cmd1; cmd2`  |
+
+## Lỗi Thường Gặp
+
+```
+# PowerShell 5.x (mặc định trên Windows!)
+❌ Sai: git add . && git commit -m 'msg'
+✅ Đúng: git add .; git commit -m 'msg'
+```
+
+## Checklist
+
+- [ ] Đã phát hiện shell đang dùng?
+- [ ] Đã check version PowerShell?
+- [ ] Đã dùng đúng syntax chaining?
+
+---
+
+_DOMYH Awesome Code • Shell-Aware Commands_

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

@@ -0,0 +1,189 @@
+---
+name: validation-framework
+priority: 0
+always_apply: true
+category: quality
+version: "4.5"
+---
+
+# ✅ Validation Framework v6.2.0
+
+> 🌍 **Language / Ngôn ngữ**: English (default) | [Tiếng Việt](#tiếng-việt)
+> 📝 **Note**: Consolidates `pre-check-validation.md` + `architecture-aware-implementation.md`
+
+## Enforcement Level: BLOCK
+
+## Description
+
+Before creating ANY new code, agent MUST pass 6-phase validation.
+
+---
+
+## 🔴 6-Phase Pre-Implementation Validation
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│ Phase 1: NECESSITY — Is it needed?                           │
+│ → Check user request, YAGNI principle                        │
+├──────────────────────────────────────────────────────────────┤
+│ Phase 2: DISCOVERY — What exists?                            │
+│ → Search for similar files, patterns, utilities              │
+├──────────────────────────────────────────────────────────────┤
+│ Phase 3: SCOPE — Does request cover this?                    │
+│ → Verify against original request, avoid scope creep         │
+├──────────────────────────────────────────────────────────────┤
+│ Phase 4: PLACEMENT — Where does it fit?                      │
+│ → Determine layer, file, module location                     │
+├──────────────────────────────────────────────────────────────┤
+│ Phase 5: CONNECTIVITY — How will it be used?                 │
+│ → Trace imports, exports, consumers                          │
+├──────────────────────────────────────────────────────────────┤
+│ Phase 6: REGISTRATION — What needs update?                   │
+│ → index.json, manifests, exports                             │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Phase 1: Necessity (YAGNI)
+
+| Question                   | If NO          |
+| -------------------------- | -------------- |
+| User explicitly requested? | ❌ STOP        |
+| Will be used immediately?  | ❌ STOP        |
+| No library solution?       | ⚠️ Use library |
+
+```yaml
+red_flags:
+  - "Nice to have" features
+  - "While I'm here..." changes
+  - Building for hypothetical future
+  - Adding unused dependencies
+```
+
+---
+
+## Phase 2: Discovery
+
+```yaml
+search_checklist:
+  - grep_search: similar function names
+  - Check: utils/, shared/, lib/ directories
+  - Review: index files for existing components
+  - Verify: no deprecated/moved version exists
+```
+
+---
+
+## Phase 3: Scope Validation
+
+| Requested?            | Action     |
+| --------------------- | ---------- |
+| Explicitly in request | ✅ Proceed |
+| Implied by request    | ⚠️ Clarify |
+| Not mentioned         | ❌ STOP    |
+
+---
+
+## Phase 4: Placement
+
+### Layer Decision
+
+| Code Type      | Location                    |
+| -------------- | --------------------------- |
+| Shared utility | `utils/`, `lib/`, `shared/` |
+| Domain logic   | `services/`, `domain/`      |
+| API handler    | `handlers/`, `routes/`      |
+| Data access    | `repositories/`, `store/`   |
+| View/UI        | `components/`, `views/`     |
+
+---
+
+## Phase 5: Connectivity
+
+Before creating file, trace:
+
+```yaml
+connectivity_check:
+  imports:
+    - What modules will import this?
+    - Are import paths correct?
+  exports:
+    - What needs to be exported?
+    - Default vs named exports?
+  consumers:
+    - Who will call these functions?
+    - What parameters needed?
+```
+
+---
+
+## Phase 6: Registration
+
+After creating file, update:
+
+```yaml
+registration_checklist:
+  - [ ] index.json or manifest.yaml
+  - [ ] Export from parent module
+  - [ ] Type definitions if TypeScript
+  - [ ] README if significant
+```
+
+---
+
+## 📋 Quick Checklist
+
+- [ ] User requested this? (Phase 1)
+- [ ] Searched for similar? (Phase 2)
+- [ ] Within scope? (Phase 3)
+- [ ] Know where to place? (Phase 4)
+- [ ] Know who uses it? (Phase 5)
+- [ ] Will update registry? (Phase 6)
+
+---
+
+## ❌ BLOCK Conditions
+
+Agent MUST NOT proceed if:
+
+```yaml
+block_conditions:
+  - No explicit user request
+  - Similar code already exists
+  - Out of scope for request
+  - Placement unclear
+  - YAGNI violation detected
+```
+
+---
+
+# Tiếng Việt
+
+> 🇻🇳 Phiên bản Tiếng Việt
+
+## Mô Tả
+
+Trước khi tạo BẤT KỲ code mới nào, agent PHẢI qua 6 phase validation.
+
+## 6 Phase
+
+1. **Necessity** — Có thực sự cần không? (YAGNI)
+2. **Discovery** — Có gì tương tự chưa?
+3. **Scope** — Có trong phạm vi yêu cầu không?
+4. **Placement** — Đặt ở đâu?
+5. **Connectivity** — Ai sẽ dùng?
+6. **Registration** — Cần update index nào?
+
+## Checklist Nhanh
+
+- [ ] User yêu cầu? (Phase 1)
+- [ ] Đã tìm tương tự? (Phase 2)
+- [ ] Trong scope? (Phase 3)
+- [ ] Biết đặt ở đâu? (Phase 4)
+- [ ] Biết ai dùng? (Phase 5)
+- [ ] Sẽ update registry? (Phase 6)
+
+---
+
+_DOMYH Awesome Code • Consolidated Validation Framework_

package/.agent/skills/DEVELOPMENT.yaml

@@ -0,0 +1,226 @@
+# DOMYH Awesome Code — Skill Development Guide
+# How to create and maintain skills
+# Version: 6.1.2
+
+# =============================================================================
+# 📋 OVERVIEW
+# =============================================================================
+
+# Skills provide language/framework-specific patterns and best practices.
+# They use a 3-tier Progressive Disclosure system for token efficiency.
+
+# =============================================================================
+# 🏗️ SKILL STRUCTURE
+# =============================================================================
+
+structure:
+  description: "Each skill folder contains 3 files"
+
+  files:
+    META.yaml:
+      purpose: "Tier 1 - Always loaded metadata"
+      size: "~100 tokens"
+      contents:
+        - name # Skill identifier
+        - display # Human-readable name
+        - category # Classification
+        - priority # Loading priority (0=highest)
+        - desc # Brief description
+        - keywords # Trigger keywords
+        - detect # File patterns for auto-detection
+        - caps # Core capabilities
+
+    SKILL.md:
+      purpose: "Tier 2 - On-demand patterns"
+      size: "~1,500 tokens"
+      contents:
+        - Core patterns with examples
+        - Project structure recommendations
+        - Checklists for verification
+
+    ADVANCED.md:
+      purpose: "Tier 3 - Reference only"
+      size: "~4,000 tokens"
+      contents:
+        - Deep dive patterns
+        - Edge cases
+        - Performance optimizations
+        - Troubleshooting guides
+
+# =============================================================================
+# 🔄 CREATION WORKFLOW
+# =============================================================================
+
+workflow:
+  steps:
+    1_create_folder:
+      action: "Create folder in skills/"
+      naming: "lowercase, hyphen-separated"
+      example: "skills/new-skill/"
+
+    2_write_meta:
+      action: "Create META.yaml"
+      template: |
+        name: new-skill
+        display: New Skill Name
+        category: language  # or framework, devops, support
+        priority: 2
+        desc: "Brief description under 80 chars"
+        keywords:
+          - keyword1
+          - keyword2
+        detect: ["*.ext", "config.file"]
+        caps:
+          - Core capability 1
+          - Core capability 2
+      validation:
+        - Under 500 bytes
+        - All required fields present
+        - Description under 80 chars
+
+    3_write_skill:
+      action: "Create SKILL.md"
+      sections:
+        - "Frontmatter (name, detect)"
+        - "# Title"
+        - "## Project Structure"
+        - "## Core Patterns"
+        - "## Checklist"
+      validation:
+        - Under 150 lines
+        - Has checklist
+        - Has code examples
+
+    4_write_advanced:
+      action: "Create ADVANCED.md (optional but recommended)"
+      sections:
+        - "# DOMYH Awesome Code  — Tier 3 Reference"
+        - "## Overview"
+        - "## Advanced Patterns"
+        - "## Edge Cases"
+        - "## Troubleshooting"
+      validation:
+        - Under 300 lines
+        - Has footer
+
+    5_register:
+      action: "Add to index.json"
+      example: |
+        {
+          "id": "new-skill",
+          "path": "skills/new-skill/",
+          "category": "language",
+          "files": {
+            "meta": "META.yaml",
+            "skill": "SKILL.md",
+            "advanced": "ADVANCED.md"
+          }
+        }
+
+    6_update_embeddings:
+      action: "Regenerate embeddings.json"
+      note: "TF-IDF vectors auto-generated from keywords and content"
+
+    7_validate:
+      action: "Run validation checks"
+      command: "Verify skill against SKILL_SCHEMA.yaml"
+
+# =============================================================================
+# 📚 CATEGORIES
+# =============================================================================
+
+categories:
+  core:
+    priority: 0
+    description: "Always active, security-focused"
+    examples: [security]
+
+  language:
+    priority: 1
+    description: "Programming languages"
+    examples: [go, python, typescript, rust]
+
+  framework:
+    priority: 2
+    description: "Frontend/Backend frameworks"
+    examples: [react, vue, nextjs]
+
+  devops:
+    priority: 3
+    description: "Infrastructure and deployment"
+    examples: [docker, kubernetes, aws, ci-cd]
+
+  support:
+    priority: 2
+    description: "Cross-cutting concerns"
+    examples: [database, testing]
+
+# =============================================================================
+# 🎯 BEST PRACTICES
+# =============================================================================
+
+best_practices:
+  meta_yaml:
+    - "Keep under 500 bytes"
+    - "Use 5-10 keywords, prioritize unique terms"
+    - "Detect patterns should be specific"
+    - "Capabilities should be actionable"
+
+  skill_md:
+    - "Focus on 5-7 most important patterns"
+    - "Include runnable code examples"
+    - "Checklist should be verification-oriented"
+    - "Use tables for quick reference"
+
+  advanced_md:
+    - "Only reference from SKILL.md"
+    - "Include edge cases"
+    - "Add troubleshooting section"
+    - "Deep dive into complex patterns"
+
+  naming:
+    - "Use lowercase"
+    - "Prefer hyphens over underscores"
+    - "Match common terminology"
+
+  keywords:
+    - "Include variations (js, javascript)"
+    - "Include framework names"
+    - "Include common commands"
+    - "Include file extensions"
+
+# =============================================================================
+# 🔍 DETECTION PATTERNS
+# =============================================================================
+
+detection:
+  file_patterns:
+    description: "Match file names or extensions"
+    examples:
+      - "*.go" # Go files
+      - "go.mod" # Go module
+      - "*.tsx" # TypeScript React
+      - "Dockerfile" # Docker
+
+  config_files:
+    description: "Match configuration files"
+    examples:
+      - "package.json"
+      - "tsconfig.json"
+      - "Cargo.toml"
+      - ".eslintrc"
+
+# =============================================================================
+# 🧪 TESTING
+# =============================================================================
+
+testing:
+  validation:
+    - "Run SKILL_SCHEMA.yaml validation"
+    - "Check size limits"
+    - "Verify all links work"
+
+  manual:
+    - "Test keyword detection"
+    - "Verify patterns are correct"
+    - "Check code examples compile"

package/.agent/skills/README.md

@@ -0,0 +1,69 @@
+# 📁 Skills — DOMYH Awesome Code
+
+> Tech-specific patterns loaded via Progressive Disclosure
+
+---
+
+## Quick Reference
+
+| Metric          | Value                  |
+| --------------- | ---------------------- |
+| Total Skills    | 60                     |
+| Total META Size | 18.2KB                 |
+| Avg per skill   | 325 bytes (~81 tokens) |
+| Max active      | 3 skills               |
+
+---
+
+## 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          |
+
+---
+
+## 3-Tier Progressive Disclosure
+
+| Tier | File        | Tokens | When       |
+| ---- | ----------- | ------ | ---------- |
+| T1   | META.yaml   | ~100   | Always     |
+| T2   | SKILL.md    | ~1,500 | On-demand  |
+| T3   | ADVANCED.md | ~4,000 | Referenced |
+
+---
+
+## META.yaml Schema (v6.2.0)
+
+```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)
+desc: "Short desc"      # Max 80 chars
+keywords: [kw1, kw2]    # Max 5-7 keywords
+detect: [*.ext, file]   # File patterns
+caps: [cap1, cap2]      # Max 3 capabilities
+```
+
+**Target:** ≤400 bytes per META.yaml
+
+---
+
+## Skill Detection Flow
+
+```
+1. Scan project files
+2. Match against detect patterns
+3. Calculate TF-IDF similarity
+4. Load Top-5 matching skills
+5. Apply LRU cache (max 3)
+```
+
+---
+
+_DOMYH Awesome Code _