@nockdev/awf 6.2.2 → 6.2.4

package/.agent/personas/planner.md

@@ -1,6 +1,6 @@
 ---
 name: planner
-version: "6.2.2"
+version: "6.2.4"
 persona_id: "plan-001"
 
 # =============================================================================
@@ -62,7 +62,10 @@ tools:
     - search_web
     - hsa_detect_stack
     - hsa_get_context
-    - hsa_search_patterns
+    - hsa_search_skills
+    - hsa_get_snapshot
+    - hsa_get_repo_map
+    - hsa_export
   restricted:
     - replace_file_content # Planners don't code
     - run_command

package/.agent/personas/researcher.md

@@ -1,6 +1,6 @@
 ---
 name: researcher
-version: "6.2.2"
+version: "6.2.4"
 persona_id: "res-001"
 
 # =============================================================================
@@ -71,7 +71,10 @@ tools:
     - list_dir
     - hsa_detect_stack
     - hsa_get_context
-    - hsa_search_patterns
+    - hsa_search_skills
+    - hsa_get_repo_map
+    - hsa_export
+    - hsa_status
   restricted:
     - replace_file_content
     - run_command

package/.agent/personas/security.md

@@ -1,6 +1,6 @@
 ---
 name: security
-version: "6.2.2"
+version: "6.2.4"
 persona_id: "sec-001"
 
 # =============================================================================
@@ -68,7 +68,9 @@ tools:
     - read_url_content
     - hsa_detect_stack
     - hsa_get_context
-    - hsa_search_patterns
+    - hsa_search_skills
+    - hsa_get_snapshot
+    - hsa_detect_environment
   restricted:
     - run_command # Security risk
     - delete_file

package/.agent/personas/tester.md

@@ -1,6 +1,6 @@
 ---
 name: tester
-version: "6.2.2"
+version: "6.2.4"
 persona_id: "tst-001"
 
 # =============================================================================
@@ -68,7 +68,9 @@ tools:
     - write_to_file
     - hsa_detect_stack
     - hsa_get_context
-    - hsa_search_patterns
+    - hsa_search_skills
+    - hsa_check_changes
+    - hsa_detect_environment
   restricted:
     - deploy
     - delete_file

package/.agent/rules/README.md

@@ -182,7 +182,7 @@ Each modular rule follows this schema:
 
 ```yaml
 name: rule-name
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-XXX-001"
 
 description: |

package/.agent/rules/SACRED_RULES.xml

@@ -59,13 +59,27 @@
   </requirement>
   
   <!-- ═══════════════════════════════════════════════════════════════════ -->
-  <!-- TIER 2: TOOL PREFERENCES -->
+  <!-- TIER 1: TOOL ENFORCEMENT -->
   <!-- ═══════════════════════════════════════════════════════════════════ -->
   
-  <requirement id="MCP_001" tier="2" severity="warn">
-    <text>Prefer MCP tools over browser/shell tools when available. Check available MCP servers at task start. Do not assume specific MCP tools exist — adapt to what the user has configured.</text>
-    <anchor>SHOULD • CLASS:TOOL_POLICY • LABEL:MCP_PREFERENCE</anchor>
-    <rationale>MCP tools provide better control, logging, and security</rationale>
+  <requirement id="MCP_001" tier="1" severity="block">
+    <text>When domyh-hsa MCP server is available:
+    MUST call hsa_detect_stack at the start of any code generation, debugging, testing, or analysis task.
+    MUST call hsa_check_changes after any file creation, modification, or deletion to keep indexes current.
+    MUST call hsa_get_context to retrieve relevant code context instead of manual file scanning for code-related tasks.
+    SHOULD call hsa_prefetch for files planned to be read or modified.
+    SHOULD call hsa_get_repo_map to understand codebase structure before large-scale changes.
+    SHOULD call hsa_get_snapshot for project overview at task start.
+    MUST call hsa_prepare_handoff before delegating sub-agent tasks (Orchestrator persona).
+    MUST call hsa_filter_tools to reduce prompt bloat when spawning sub-agents.
+    SHOULD call hsa_detect_environment to verify runtime/tool availability before running commands.
+    SHOULD call hsa_search_skills to find coding patterns before implementing.
+    SHOULD call hsa_export for structured data when generating reports or summaries.
+    SHOULD call hsa_status to verify engine health when troubleshooting tool failures.
+    SHOULD call hsa_get_agent_config to load commands/personas/rules when user asks about capabilities.
+    Do not assume specific MCP tools exist — check available servers at task start and adapt.</text>
+    <anchor>MUST • CLASS:TOOL_POLICY • LABEL:MCP_ENFORCEMENT</anchor>
+    <rationale>MCP tools provide intelligent indexing, hybrid search, and context optimization that outperform manual file scanning by 70-90% in token efficiency</rationale>
   </requirement>
   
   <!-- ═══════════════════════════════════════════════════════════════════ -->

package/.agent/rules/archive/constitutional/tier-0-core.yaml

@@ -1,7 +1,7 @@
 # 📜 Constitutional Rules - Tier 0: Core Principles
 
 > Immutable principles that cannot be overridden
-> version: 6.2.2
+> version: 6.2.3
 
 ---
 
@@ -16,7 +16,7 @@ They represent the fundamental safety and ethical principles of the agent.
 
 ```yaml
 rule: do_no_harm
-version: "6.2.2"
+version: "6.2.4"
 tier: 0
 immutable: true
 
@@ -48,7 +48,7 @@ checks:
 
 ```yaml
 rule: truthfulness
-version: "6.2.2"
+version: "6.2.4"
 tier: 0
 immutable: true
 
@@ -75,7 +75,7 @@ uncertainty_markers:
 
 ```yaml
 rule: user_sovereignty
-version: "6.2.2"
+version: "6.2.4"
 tier: 0
 immutable: true
 
@@ -99,7 +99,7 @@ exceptions: []  # No exceptions to this rule
 
 ```yaml
 rule: transparency
-version: "6.2.2"
+version: "6.2.4"
 tier: 0
 immutable: true
 
@@ -120,7 +120,7 @@ requirements:
 
 ```yaml
 rule: privacy
-version: "6.2.2"
+version: "6.2.4"
 tier: 0
 immutable: true
 

package/.agent/rules/archive/constitutional/tier-1-safety.yaml

@@ -1,7 +1,7 @@
 # 🛡️ Constitutional Rules - Tier 1: Safety
 
 > Critical safety rules with limited override capability
-> version: 6.2.2
+> version: 6.2.3
 
 ---
 
@@ -16,7 +16,7 @@ They can be overridden ONLY with explicit user approval for specific cases.
 
 ```yaml
 rule: destructive_action_prevention
-version: "6.2.2"
+version: "6.2.4"
 tier: 1
 category: safety
 
@@ -65,7 +65,7 @@ override:
 
 ```yaml
 rule: scope_containment
-version: "6.2.2"
+version: "6.2.4"
 tier: 1
 category: safety
 
@@ -110,7 +110,7 @@ override:
 
 ```yaml
 rule: command_execution_safety
-version: "6.2.2"
+version: "6.2.4"
 tier: 1
 category: safety
 
@@ -162,7 +162,7 @@ verification_format: |
 
 ```yaml
 rule: information_boundaries
-version: "6.2.2"
+version: "6.2.4"
 tier: 1
 category: safety
 
@@ -201,7 +201,7 @@ cross_boundary_requests:
 
 ```yaml
 rule: error_recovery
-version: "6.2.2"
+version: "6.2.4"
 tier: 1
 category: safety
 

package/.agent/rules/archive/constitutional/tier-2-execution.yaml

@@ -1,7 +1,7 @@
 # ⚙️ Constitutional Rules - Tier 2: Execution Quality
 
 > Quality and execution guidelines with flexible application
-> version: 6.2.2
+> version: 6.2.3
 
 ---
 
@@ -16,7 +16,7 @@ They can be adjusted based on context and user preferences.
 
 ```yaml
 rule: evidence_based_claims
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 
@@ -65,7 +65,7 @@ adjustment:
 
 ```yaml
 rule: self_critique
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 
@@ -103,7 +103,7 @@ adjustment:
 
 ```yaml
 rule: planning_before_action
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 
@@ -151,7 +151,7 @@ adjustment:
 
 ```yaml
 rule: incremental_verification
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 
@@ -188,7 +188,7 @@ adjustment:
 
 ```yaml
 rule: clear_communication
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 
@@ -230,7 +230,7 @@ adjustment:
 
 ```yaml
 rule: context_management
-version: "6.2.2"
+version: "6.2.4"
 tier: 2
 category: quality
 

package/.agent/rules/archive/context-management.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: context-management
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-CTX-001"
 
 # =============================================================================

package/.agent/rules/archive/duplication-prevention.md

@@ -6,7 +6,7 @@ category: quality
 version: "4.5"
 ---
 
-# 🔄 Duplication Prevention v6.2.2
+# 🔄 Duplication Prevention v6.2.4
 
 > 🌍 **Language / Ngôn ngữ**: English (default) | [Tiếng Việt](#tiếng-việt)
 > 📝 **Note**: Consolidates `code-deduplication.md` + `logic-duplication-check.md`

package/.agent/rules/archive/evidence.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: evidence
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-EVD-001"
 
 # =============================================================================
@@ -168,9 +168,9 @@ integration:
     hsa_get_context:
       purpose: "Gather code context as evidence for findings"
       usage: "hsa_get_context files=[target] → retrieve relevant code snippets"
-    hsa_search_patterns:
+    hsa_search_skills:
       purpose: "Find best-practice patterns to validate claims"
-      usage: "hsa_search_patterns query=[topic] → cross-reference against 730+ patterns"
+      usage: "hsa_search_skills query=[topic] → cross-reference against skill knowledge"
 
   reflection:
     enabled: true

package/.agent/rules/archive/project-detection.md

@@ -4,7 +4,7 @@ version: "4.5"
 data_file: "data/build-systems.yaml"
 ---
 
-# 🔍 Project Detection Rule v6.2.2
+# 🔍 Project Detection Rule v6.2.4
 
 > 🌍 **Language / Ngôn ngữ**: English (default) | [Tiếng Việt](#tiếng-việt)
 > 📦 **Data**: See `data/build-systems.yaml` for detection patterns

package/.agent/rules/archive/reflection.yaml

@@ -1,7 +1,7 @@
 # 🔧 Modular Rule: Reflection Integration
 
 > Self-improvement through reflection patterns
-> version: 6.2.2
+> version: 6.2.3
 
 ---
 
@@ -16,7 +16,7 @@ enabling learning from both successes and failures.
 
 ```yaml
 name: reflection
-version: "6.2.2"
+version: "6.2.4"
 category: improvement
 priority: 2
 

package/.agent/rules/archive/versioning.yaml

@@ -19,7 +19,7 @@ Prevent agent from suggesting large version jumps. Follow semantic versioning wi
 | Component | When to Increment | Example |
 |:----------|:------------------|:--------|
 | **PATCH** | Bug fixes, small improvements | `6.1.2` → `6.1.3` |
-| **MINOR** | New features (backward compatible) | `6.1.2` → `6.2.0` |
+| **MINOR** | New features (backward compatible) | `6.1.2` → `6.2.4` |
 | **MAJOR** | Breaking changes only | `6.1.2` → `7.0.0` |
 
 ---
@@ -59,13 +59,13 @@ Prevent agent from suggesting large version jumps. Follow semantic versioning wi
 
 ```yaml
 # Check current version
-current: "6.2.2"
+current: "6.2.4"
 
 # For bug fixes
 suggest: "6.1.3"  # ✅ Correct
 
 # For new features  
-suggest: "6.2.0"  # ✅ Correct
+suggest: "6.2.4"  # ✅ Correct
 
 # WRONG suggestions
 wrong: "7.0.0"    # ❌ Only for breaking changes
@@ -88,8 +88,8 @@ Single Source of Truth: `.agent/core/VERSION.yaml`
 
 ```yaml
 system:
-  version: "6.2.2"
-  version_short: "v6.2.2"
+  version: "6.2.4"
+  version_short: v6.2.4
 ```
 
 ---

package/.agent/rules/data/build-systems.yaml

@@ -1,7 +1,7 @@
-# Build Systems Detection Data v6.2.2
+# Build Systems Detection Data v6.2.4
 # Externalized from project-detection.md
 
-version: "6.2.2"
+version: "6.2.4"
 last_updated: "2026-02-01"
 
 # Root file patterns for project detection

package/.agent/rules/modules/agent-delegation.yaml

@@ -1,9 +1,9 @@
-# Agent Delegation Rule v6.2.2
+# Agent Delegation Rule v6.2.4
 # When and how to delegate to specialized sub-agents
 
 ---
 name: agent-delegation
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-DEL-001"
 
 # =============================================================================
@@ -132,5 +132,16 @@ integration:
     check_before: "delegation"
     question: "Could I handle this myself, or does it need a specialist?"
 
+  hsa_tools:
+    hsa_prepare_handoff:
+      purpose: "Generate context packet for sub-agent with project snapshot and relevant files"
+      usage: "hsa_prepare_handoff task_type=[code|test|review|debug] focus_files=[paths] → context packet"
+    hsa_filter_tools:
+      purpose: "Reduce prompt bloat by pruning tool catalog per sub-agent task type (93-97% token savings)"
+      usage: "hsa_filter_tools task_type=[code|test|review] → include/exclude tool lists"
+    hsa_get_snapshot:
+      purpose: "Provide project overview for sub-agent context injection"
+      usage: "hsa_get_snapshot → file tree, detected stack, key symbols"
+
 ---
 _DOMYH Awesome Code • Agent Delegation Rule_

package/.agent/rules/modules/edit-verification.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: edit-verification
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-EDV-001"
 
 # =============================================================================
@@ -187,6 +187,9 @@ integration:
     hsa_get_context:
       purpose: "Pre-edit context to assess impact before modifying code"
       usage: "hsa_get_context files=[target] → understand dependencies and callers"
+    hsa_check_changes:
+      purpose: "Sync indexes after file edits to keep search results accurate"
+      usage: "hsa_check_changes paths=[edited_files] → incremental re-index of BM25/CodeGraph/VectorIndex"
 
   reflection:
     enabled: true

package/.agent/rules/modules/git-workflow.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: git-workflow
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-GIT-001"
 
 # =============================================================================
@@ -161,5 +161,10 @@ integration:
   reflection:
     enabled: false
 
+  hsa_tools:
+    hsa_check_changes:
+      purpose: "Re-index changed files after git operations to keep BM25/CodeGraph/VectorIndex current"
+      usage: "hsa_check_changes → after commit, merge, rebase, checkout, or any branch operation"
+
 ---
 _DOMYH Awesome Code • Git Workflow Rule_

package/.agent/rules/modules/language.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: language
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-LNG-001"
 
 # =============================================================================

package/.agent/rules/modules/online-research.yaml

@@ -3,7 +3,7 @@
 
 ---
 name: online-research
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-RES-001"
 
 # =============================================================================
@@ -181,9 +181,9 @@ integration:
     - evidence
 
   hsa_tools:
-    hsa_search_patterns:
-      purpose: "Check local pattern database BEFORE searching online"
-      usage: "hsa_search_patterns query=[topic] → may answer without web search"
+    hsa_search_skills:
+      purpose: "Check local skill knowledge database BEFORE searching online"
+      usage: "hsa_search_skills query=[topic] → may answer without web search"
     hsa_get_context:
       purpose: "Gather project context to formulate better search queries"
       usage: "hsa_get_context files=[relevant] → understand what to search for"

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

@@ -1,9 +1,9 @@
-# Performance Optimization Rule v6.2.2
+# Performance Optimization Rule v6.2.4
 # Model selection, context management, token budget
 
 ---
 name: performance-optimization
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-PERF-001"
 
 # =============================================================================
@@ -137,5 +137,13 @@ integration:
     check_before: "tool_call"
     question: "Is this the most efficient way to get the information I need?"
 
+  hsa_tools:
+    hsa_detect_stack:
+      purpose: "Determine available profiling and benchmark tools for the detected stack"
+      usage: "hsa_detect_stack → identifies runtime, framework, available perf tools"
+    hsa_get_context:
+      purpose: "Focus optimization efforts on the right code areas"
+      usage: "hsa_get_context query=[bottleneck|performance] → find related code for optimization"
+
 ---
 _DOMYH Awesome Code • Performance Optimization Rule_

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

@@ -3,7 +3,7 @@
 
 ---
 name: quality
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-QLT-001"
 
 # =============================================================================
@@ -169,9 +169,9 @@ integration:
     - evidence
 
   hsa_tools:
-    hsa_search_patterns:
+    hsa_search_skills:
       purpose: "Retrieve language-specific best practices and anti-patterns"
-      usage: "hsa_search_patterns query=[pattern] domain=[lang] → quality guidance from 730+ patterns"
+      usage: "hsa_search_skills query=[pattern] domain=[lang] → quality guidance from skill knowledge"
     hsa_detect_stack:
       purpose: "Auto-detect correct lint/format tools for quality gates"
       usage: "hsa_detect_stack → determines lint_check, format_check commands"

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

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

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

@@ -3,7 +3,7 @@
 
 ---
 name: terminal-safety
-version: "6.2.2"
+version: "6.2.4"
 rule_id: "MOD-TRM-001"
 
 # =============================================================================
@@ -260,9 +260,9 @@ integration:
     hsa_detect_stack:
       purpose: "Auto-detect runtime versions and correct shell for pre-flight checks"
       usage: "hsa_detect_stack → determines OS, shell type, package manager, runtime versions"
-    hsa_search_patterns:
+    hsa_search_skills:
       purpose: "Lookup safe command patterns for the detected stack"
-      usage: "hsa_search_patterns query=[command] domain=[infra] → safe alternatives"
+      usage: "hsa_search_skills query=[command] domain=[infra] → safe alternatives"
 
   reflection:
     enabled: true

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

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

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

@@ -6,7 +6,7 @@ category: quality
 version: "4.5"
 ---
 
-# ✅ Validation Framework v6.2.2
+# ✅ Validation Framework v6.2.4
 
 > 🌍 **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.2.2
+# version: 6.2.3
 
 # =============================================================================
 # 📋 OVERVIEW

package/.agent/skills/README.md

@@ -40,7 +40,7 @@
 
 ---
 
-## META.yaml Schema (v6.2.2)
+## META.yaml Schema (v6.2.4)
 
 ```yaml
 name: skill-id          # lowercase, hyphen-separated

package/.agent/skills/_categories.yaml

@@ -131,12 +131,12 @@ categories:
       - bun
       - audit-pro
 
-      # P0 Skills (v6.2.2)
+      # P0 Skills (v6.2.4)
       - tdd-workflow
       - accessibility
       - seo
 
-      # P1 Skills (v6.2.2)
+      # P1 Skills (v6.2.4)
       - microservices
       - monorepo
 

package/.agent/skills/_router.yaml

@@ -256,6 +256,18 @@ resolution:
     e2e: "cross-cutting/playwright"
     browser-testing: "cross-cutting/playwright"
     browser-agent: "tooling/browser-agent"
+    # Workflow-required skill aliases (synced with manifest.yaml)
+    coding-rules: "cross-cutting/coding-rules"
+    audit-pro: "cross-cutting/audit-pro"
+    domyh-design: "cross-cutting/domyh-design"
+    tdd-workflow: "cross-cutting/tdd-workflow"
+    database: "cross-cutting/database"
+    web-perf: "cross-cutting/web-perf"
+    error-handling: "core/error-handling"
+    logging: "core/logging"
+    observability: "core/observability"
+    ci-cd: "devops/ci-cd"
+    prompt-engineering: "cross-cutting/prompt-engineering"
 
 # =============================================================================
 # TOKEN BUDGET