@nockdev/awf 6.2.5 → 6.2.7

package/.agent/skills/cross-cutting/skill-creator/SKILL.md

@@ -0,0 +1,163 @@
+# Skill Creator — DOMYH Awesome Code
+
+Guide for creating new domyh-awf skills with proper schema, progressive disclosure, and quality standards.
+
+## Decision Tree
+
+```
+Task → Creating a new skill?
+  ├─ Simple skill (patterns only)
+  │   └─ META.yaml + SKILL.md (< 300 lines)
+  ├─ Standard skill
+  │   └─ META.yaml + SKILL.md + data/*.yaml
+  ├─ Complex skill (deep-dive content)
+  │   └─ META.yaml + SKILL.md + ADVANCED.md + data/ + references/
+  └─ Expanding existing skill?
+      └─ Check line count → Split if > 500 lines
+```
+
+## Quick Start — 6-Step Workflow
+
+### Step 1: Choose Category & Directory
+
+```yaml
+categories:
+  core: # Foundation skills (security, coding-rules)
+  languages: # Programming languages (typescript, python, go)
+  frameworks: # Frameworks (react, nextjs, vue)
+  cross-cutting: # Multi-domain skills (testing, database, docker)
+  devops: # Infrastructure (aws, kubernetes, ci-cd)
+  tooling: # Dev tools (git, vscode)
+  ai-ml: # AI/ML patterns (rag-patterns, prompt-engineering)
+```
+
+### Step 2: Create META.yaml
+
+```yaml
+# Template — META.yaml v2
+name: my-skill # lowercase, hyphen-separated
+version: "6.2.7"
+display: My Skill # Human-readable name
+category: cross-cutting # One of the 7 categories
+tier: 2 # 1=core, 2=standard, 3=specialized
+priority: 3 # 0-6 (lower = higher priority)
+
+desc: "Short description — max 80 chars"
+
+trigger_desc: | # NEW v2: Rich description for semantic matching
+  When to activate this skill. Keywords, file patterns, common
+  user questions that should trigger this skill. Max 1024 chars.
+
+triggers:
+  file_patterns:
+    - "*.ext"
+    - "config.file"
+  keywords:
+    - keyword1
+    - keyword2
+    - keyword3
+  intents:
+    - "action description 1"
+    - "action description 2"
+
+caps:
+  - Capability 1
+  - Capability 2
+  - Capability 3
+
+compatibility: "Runtime >= version" # NEW v2: Environment requirements
+
+related_skills:
+  - related-skill-1
+  - related-skill-2
+
+data_files:
+  - data/patterns.yaml
+```
+
+### Step 3: Write SKILL.md (< 500 lines)
+
+```markdown
+# Skill Name
+
+Short description of what this skill covers.
+
+## Decision Tree ← REQUIRED: When to use which pattern
+
+## Quick Start ← REQUIRED: Most common workflow
+
+## Patterns ← Key patterns with code examples
+
+## Best Practices ← Checklist format preferred
+
+## Data Files ← Reference to data/ files
+
+## Deep-Dive References ← Links to references/ (if split)
+```
+
+### Step 4: Create data/ files (YAML patterns)
+
+```yaml
+# data/patterns.yaml
+patterns:
+  - name: pattern-name
+    description: "What this pattern does"
+    when: "When to use it"
+    example: |
+      Code example here
+```
+
+### Step 5: Add references/ (if > 500 lines)
+
+Split detailed content into `references/*.md` files:
+
+```
+my-skill/
+├── META.yaml
+├── SKILL.md (< 300 lines, core content)
+├── ADVANCED.md (optional, deep-dive)
+├── data/
+│   └── patterns.yaml
+└── references/
+    ├── advanced-patterns.md
+    └── migration-guide.md
+```
+
+### Step 6: Validate
+
+```yaml
+checklist:
+  - [ ] META.yaml has all required fields (name, version, category, desc)
+  - [ ] trigger_desc is under 1024 chars
+  - [ ] SKILL.md is under 500 lines
+  - [ ] Decision tree present in SKILL.md
+  - [ ] Quick start section with working examples
+  - [ ] data/ files use consistent YAML schema
+  - [ ] references/ files linked from SKILL.md
+  - [ ] No duplicate keywords with existing skills
+```
+
+## SKILL.md Best Practices
+
+| Practice                   | Rule                                         |
+| -------------------------- | -------------------------------------------- |
+| **Line limit**             | < 500 lines (split to references/ if larger) |
+| **Decision tree**          | Always include — guides agent routing        |
+| **Code examples**          | Working, copy-pasteable code                 |
+| **Checklist**              | Use `- [ ]` for actionable items             |
+| **Cross-refs**             | Link to related skills and data files        |
+| **Progressive disclosure** | Core in SKILL.md, details in references/     |
+
+## Common Mistakes
+
+❌ No decision tree → Agent doesn't know when to use patterns
+❌ SKILL.md > 500 lines → Context bloat, slow loading
+❌ Missing `desc` field → Broken HSA routing
+❌ Missing `triggers.file_patterns` → No auto-detection
+❌ Overlapping keywords → Confused skill selection
+❌ Placeholder content → Wasted token budget
+
+## References
+
+- [META.yaml v2 Schema](references/schema-v2.md)
+- [Progressive Disclosure Patterns](references/patterns.md)

package/.agent/skills/cross-cutting/skill-creator/references/patterns.md

@@ -0,0 +1,58 @@
+# Progressive Disclosure Patterns
+
+## 3-Tier Loading System
+
+```
+Tier 1: META.yaml     (~100 tokens)  — Always loaded for routing
+Tier 2: SKILL.md      (~1,500 tokens) — Loaded on-demand when skill activated
+Tier 3: ADVANCED.md   (~4,000 tokens) — Referenced only when deep-dive needed
+```
+
+## When to Split
+
+| Condition              | Action                                 |
+| ---------------------- | -------------------------------------- |
+| SKILL.md < 300 lines   | Keep as-is                             |
+| SKILL.md 300-500 lines | Consider splitting heavy sections      |
+| SKILL.md > 500 lines   | **Must split** into core + references/ |
+
+## Split Strategy
+
+1. **Keep in SKILL.md** (core, < 300 lines):
+   - Decision tree
+   - Quick start / most common workflow
+   - Essential patterns overview
+   - Production checklist
+   - Data file references
+
+2. **Move to references/** (on-demand):
+   - Detailed code examples
+   - Platform-specific content
+   - Migration guides
+   - Advanced patterns
+   - API reference tables
+
+3. **Keep in ADVANCED.md** (rare access):
+   - Deep architectural patterns
+   - Performance tuning guides
+   - Edge cases and gotchas
+   - Historical context
+
+## Reference File Naming
+
+```
+references/
+├── {topic}-patterns.md     # Pattern collections
+├── {platform}-specific.md  # Platform guides
+├── migration-guide.md      # Version migration
+└── api-reference.md        # API documentation
+```
+
+## Linking Pattern
+
+```markdown
+## 📚 Deep-Dive References
+
+- **Topic Name** — Brief description
+  → See [references/topic-name.md](references/topic-name.md)
+```

package/.agent/skills/cross-cutting/skill-creator/references/schema-v2.md

@@ -0,0 +1,44 @@
+# META.yaml v2 Schema Reference
+
+## Required Fields
+
+| Field      | Type   | Max Length | Description                                                                |
+| ---------- | ------ | ---------- | -------------------------------------------------------------------------- |
+| `name`     | string | 30 chars   | Lowercase, hyphen-separated identifier                                     |
+| `version`  | string | -          | Semver string (e.g., "6.2.7")                                              |
+| `category` | enum   | -          | One of: core, languages, frameworks, cross-cutting, devops, tooling, ai-ml |
+| `desc`     | string | 80 chars   | Short description for listings                                             |
+
+## Recommended Fields
+
+| Field                    | Type   | Max Length | Description                                |
+| ------------------------ | ------ | ---------- | ------------------------------------------ |
+| `display`                | string | 50 chars   | Human-readable display name                |
+| `tier`                   | int    | -          | 1=core, 2=standard, 3=specialized          |
+| `priority`               | int    | -          | 0-6 (lower = higher priority)              |
+| `trigger_desc`           | string | 1024 chars | Rich semantic description for HSA matching |
+| `triggers.file_patterns` | list   | -          | File globs for auto-detection              |
+| `triggers.keywords`      | list   | 30 items   | Keywords for BM25 matching                 |
+| `triggers.intents`       | list   | 10 items   | User intent descriptions                   |
+| `caps`                   | list   | 6 items    | Capability descriptions                    |
+| `compatibility`          | string | 100 chars  | Environment requirements                   |
+
+## Optional Fields
+
+| Field                    | Type | Description                        |
+| ------------------------ | ---- | ---------------------------------- |
+| `related_skills`         | list | Other skills to cross-reference    |
+| `prevent_confusion_with` | map  | Disambiguation from similar skills |
+| `data_files`             | list | Paths to data/ YAML files          |
+| `patterns.total`         | int  | Total pattern count                |
+| `patterns.domains`       | map  | Domain breakdown                   |
+
+## Validation Rules
+
+1. `name` must be unique across all skills
+2. `desc` must not exceed 80 characters
+3. `trigger_desc` must not exceed 1024 characters
+4. `triggers.keywords` should have 5-30 items
+5. `caps` should have 3-6 items
+6. `compatibility` should specify minimum versions
+7. File patterns must use standard glob syntax

package/.agent/skills/cross-cutting/sql/META.yaml

@@ -1,5 +1,5 @@
 name: sql
-version: "6.2.5"
+version: "6.2.7"
 category: database
 tier: 3
 

package/.agent/skills/cross-cutting/sql/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: sql
 detect: ["*.sql", "migrations/*.sql", "*.pgsql"]
-version: "6.2.5"
+version: "6.2.7"
 category: database
 tier: 1
 ---

package/.agent/skills/cross-cutting/tailwind/META.yaml

@@ -1,5 +1,5 @@
 name: tailwind
-version: "6.2.5"
+version: "6.2.7"
 display: Tailwind CSS 4.0
 category: cross-cutting
 tier: 1

package/.agent/skills/cross-cutting/tailwind/SKILL.md

@@ -7,7 +7,7 @@ detect:
     "@tailwind",
     '@import "tailwindcss"',
   ]
-version: "6.2.5"
+version: "6.2.7"
 category: styling
 tier: 1
 ---

package/.agent/skills/cross-cutting/tdd-workflow/META.yaml

@@ -1,5 +1,5 @@
 name: tdd-workflow
-version: "6.2.5"
+version: "6.2.7"
 display: Test-Driven Development
 category: cross-cutting
 tier: 1

package/.agent/skills/cross-cutting/testing/META.yaml

@@ -1,5 +1,5 @@
 name: testing
-version: "6.2.5"
+version: "6.2.7"
 display: Testing
 category: support
 tier: 1
@@ -7,6 +7,12 @@ priority: 2
 
 desc: "Testing patterns: unit tests, integration tests, mocking, TDD, coverage, e2e"
 
+trigger_desc: |
+  Activate when user asks about writing tests, test coverage, mocking,
+  test-driven development (TDD), integration tests, e2e tests, test
+  fixtures, assertions, or testing framework selection (Vitest, Jest,
+  pytest, Go testing). Also for CI test pipeline setup.
+
 triggers:
   file_patterns:
     - "tests/"

package/.agent/skills/cross-cutting/testing/SKILL.md

@@ -8,7 +8,7 @@ detect:
     "vitest.config.*",
     "playwright.config.*",
   ]
-version: "6.2.5"
+version: "6.2.7"
 ---
 
 # Testing Patterns (2026)

package/.agent/skills/cross-cutting/testing/data/frameworks.yaml

@@ -55,7 +55,7 @@ patterns:
     mocking: vi.fn(), vi.mock()
     coverage: --coverage
     docs_url: https://vitest.dev
-    # v6.2.5: Version-specific info
+    # v6.2.7: Version-specific info
     version_info:
       current: "4.0.0"
       min_supported: "2.0.0"

package/.agent/skills/cross-cutting/web-perf/META.yaml

@@ -1,5 +1,5 @@
 name: web-perf
-version: "6.2.5"
+version: "6.2.7"
 category: support
 tier: 3
 

package/.agent/skills/cross-cutting/web-perf/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: web-perf
 detect: ["lighthouse.json", "web-vitals.*", ".lighthouserc.js"]
-version: "6.2.5"
+version: "6.2.7"
 category: support
 tier: 1
 ---

package/.agent/skills/devops/aws/META.yaml

@@ -1,5 +1,5 @@
 name: aws
-version: "6.2.5"
+version: "6.2.7"
 category: infrastructure
 tier: 3
 

package/.agent/skills/devops/aws/SKILL.md

@@ -2,6 +2,101 @@
 
 AWS cloud services patterns for serverless, containers, and AI/ML. Covers Lambda, S3, ECS, EKS, Bedrock, and SageMaker.
 
+## Decision Tree
+
+```
+Task → What are you deploying?
+  ├─ API/Microservice
+  │   ├─ Low traffic / event-driven → Lambda + API Gateway
+  │   ├─ Medium traffic → ECS Fargate (containers)
+  │   └─ High traffic / complex → EKS (Kubernetes)
+  ├─ Static website
+  │   └─ S3 + CloudFront (CDN)
+  ├─ Data processing
+  │   ├─ Batch → Step Functions + Lambda
+  │   ├─ Stream → Kinesis + Lambda
+  │   └─ ETL → Glue
+  ├─ AI/ML
+  │   ├─ Foundation models → Bedrock
+  │   ├─ Custom training → SageMaker
+  │   └─ RAG → Bedrock + OpenSearch Serverless
+  └─ Database
+      ├─ Relational → RDS (PostgreSQL/MySQL) or Aurora
+      ├─ Key-value → DynamoDB
+      ├─ Cache → ElastiCache (Redis/Valkey)
+      └─ Vector → OpenSearch Serverless
+```
+
+## Quick Start — Lambda + API Gateway
+
+```yaml
+# template.yaml (SAM)
+AWSTemplateFormatVersion: "2010-09-09"
+Transform: AWS::Serverless-2016-10-31
+
+Globals:
+  Function:
+    Timeout: 30
+    Runtime: nodejs22.x
+    MemorySize: 256
+    Architectures: [arm64] # Graviton = cheaper + faster
+    Environment:
+      Variables:
+        NODE_ENV: production
+
+Resources:
+  ApiFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      CodeUri: src/
+      Handler: index.handler
+      Events:
+        Api:
+          Type: HttpApi
+          Properties:
+            Path: /api/{proxy+}
+            Method: ANY
+```
+
+```bash
+# Deploy
+sam build
+sam deploy --guided
+```
+
+## Quick Start — ECS Fargate
+
+```bash
+# Create cluster + service
+aws ecs create-cluster --cluster-name myapp
+aws ecs create-service \
+  --cluster myapp \
+  --service-name api \
+  --task-definition myapp:1 \
+  --desired-count 2 \
+  --launch-type FARGATE \
+  --network-configuration "awsvpcConfiguration={subnets=[subnet-xxx],securityGroups=[sg-xxx],assignPublicIp=ENABLED}"
+```
+
+## Quick Start — Bedrock
+
+```python
+import boto3
+import json
+
+bedrock = boto3.client('bedrock-runtime', region_name='us-east-1')
+
+response = bedrock.invoke_model(
+    modelId='anthropic.claude-3-5-sonnet-20241022-v2:0',
+    body=json.dumps({
+        "anthropic_version": "bedrock-2023-05-31",
+        "max_tokens": 1024,
+        "messages": [{"role": "user", "content": "Hello"}]
+    })
+)
+result = json.loads(response['body'].read())
+```
+
 ## Patterns (25 total)
 
 ### Compute (6)
@@ -17,32 +112,22 @@ AWS cloud services patterns for serverless, containers, and AI/ML. Covers Lambda
 
 - S3 Vectors (vector embeddings in S3)
 - S3 Tables (Apache Iceberg format)
-- S3 metadata management
-- S3 lifecycle policies
-- Cross-region replication
+- S3 lifecycle policies and replication
 
 ### Kubernetes (5)
 
-- EKS cluster configuration
-- EKS Pod Identity (replaces IRSA)
-- EKS capabilities and add-ons
-- Fargate profiles for EKS
-- EKS auto-mode
+- EKS cluster configuration + Pod Identity
+- Fargate profiles, auto-mode, add-ons
 
 ### AI/ML (5)
 
-- Bedrock foundation models integration
-- SageMaker model training pipeline
-- MLFlow experiment tracking
-- Bedrock Agents for autonomous tasks
-- SageMaker inference endpoints
+- Bedrock foundation models + Agents
+- SageMaker training + inference endpoints
 
 ### Serverless (4)
 
 - API Gateway + Lambda patterns
-- Step Functions orchestration
-- DynamoDB single-table design
-- CloudFront edge functions
+- Step Functions, DynamoDB single-table design
 
 ## Data Files
 

package/.agent/skills/devops/azure/SKILL.md

@@ -1,43 +1,109 @@
-# Microsoft Azure
+# Azure Cloud Services
 
-> Azure Functions • Azure DevOps • Cosmos DB • AKS
+Azure cloud services patterns for enterprise workloads. Covers App Service, AKS, Functions, Cosmos DB, Azure AI.
 
----
+## Decision Tree
 
-## Khi Nào Dùng
+```
+Task → What are you deploying?
+  ├─ Web API
+  │   ├─ Simple → App Service (PaaS)
+  │   ├─ Event-driven → Azure Functions
+  │   └─ Complex / microservices → AKS (Kubernetes)
+  ├─ Static website
+  │   └─ Azure Static Web Apps + CDN
+  ├─ Database
+  │   ├─ Relational → Azure SQL / PostgreSQL Flexible
+  │   ├─ NoSQL → Cosmos DB
+  │   └─ Cache → Azure Cache for Redis
+  ├─ AI/ML
+  │   ├─ OpenAI models → Azure OpenAI Service
+  │   ├─ Custom models → Azure ML
+  │   └─ Search → Azure AI Search (vector + hybrid)
+  └─ DevOps
+      ├─ CI/CD → Azure DevOps Pipelines or GitHub Actions
+      └─ IaC → Bicep (Azure-native) or Terraform
+```
 
-- Deploy serverless functions (Azure Functions)
-- CI/CD pipelines (Azure DevOps)
-- NoSQL database (Cosmos DB)
-- Enterprise app deployment
+## Quick Start — App Service
 
-## Service Selection
+```bash
+# Create and deploy
+az group create --name myapp-rg --location eastus
+az appservice plan create --name myplan --resource-group myapp-rg --sku B1 --is-linux
+az webapp create --name myapp --resource-group myapp-rg --plan myplan --runtime "NODE:22-lts"
+az webapp up --name myapp --resource-group myapp-rg
+```
 
-| Service             | Type                 | Best For               |
-| ------------------- | -------------------- | ---------------------- |
-| **Azure Functions** | Serverless functions | Event-driven, webhooks |
-| **App Service**     | Managed web apps     | APIs, web apps         |
-| **AKS**             | Managed Kubernetes   | Microservices          |
-| **Cosmos DB**       | Multi-model NoSQL    | Global distribution    |
-| **Azure SQL**       | Managed SQL          | Relational data        |
+## Quick Start — Azure Functions
 
-## Azure Functions Quick Start
+```typescript
+// src/functions/httpTrigger.ts
+import { app, HttpRequest, HttpResponseInit } from "@azure/functions";
 
-```bash
-func init MyProject --typescript
-func new --name HttpTrigger --template "HTTP trigger"
-func start  # Local development
-az functionapp publish MyFunctionApp  # Deploy
+app.http("hello", {
+  methods: ["GET", "POST"],
+  authLevel: "anonymous",
+  handler: async (request: HttpRequest): Promise<HttpResponseInit> => {
+    const name = request.query.get("name") || "World";
+    return { body: `Hello, ${name}!` };
+  },
+});
 ```
 
-## Common Traps
+## Quick Start — Azure OpenAI
+
+```python
+from openai import AzureOpenAI
+
+client = AzureOpenAI(
+    api_key=os.getenv("AZURE_OPENAI_API_KEY"),
+    api_version="2024-10-21",
+    azure_endpoint=os.getenv("AZURE_OPENAI_ENDPOINT")
+)
+
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello"}]
+)
+```
+
+## Patterns (20 total)
+
+### Compute (5)
+
+- App Service deployment slots (zero-downtime)
+- Azure Functions with Durable Functions
+- AKS cluster with managed identity
+- Container Apps (serverless containers)
+- Azure Spring Apps for Java
+
+### Data (5)
+
+- Cosmos DB partition strategies
+- Azure SQL Hyperscale
+- PostgreSQL Flexible Server
+- Azure Cache for Redis
+- Event Hubs for streaming
+
+### AI (5)
+
+- Azure OpenAI GPT-4o integration
+- Azure AI Search (vector + hybrid)
+- Azure ML endpoints
+- Prompt Flow orchestration
+- Content Safety filters
+
+### Infrastructure (5)
 
-| Trap            | Fix                                          |
-| --------------- | -------------------------------------------- |
-| Cold starts     | Premium plan, keep-alive pings               |
-| Entra ID config | Use managed identity, DefaultAzureCredential |
-| Cost management | Azure Cost Management + budget alerts        |
+- Bicep modules (IaC)
+- Azure DevOps pipelines
+- Managed Identity (passwordless)
+- Key Vault integration
+- Private Endpoints
 
----
+## Data Files
 
-_DOMYH Awesome Code • Azure Skill v1.0.0_
+- `data/compute.yaml` — App Service, Functions, AKS patterns
+- `data/data.yaml` — Cosmos DB, SQL, Redis patterns
+- `data/ai.yaml` — Azure OpenAI, AI Search patterns

package/.agent/skills/devops/ci-cd/META.yaml

@@ -1,5 +1,5 @@
 name: ci-cd
-version: "6.2.5"
+version: "6.2.7"
 category: infrastructure
 tier: 3