@nockdev/awf 6.2.0 → 6.2.2

package/.agent/rules/SACRED_RULES.xml

@@ -4,8 +4,8 @@
   Research-backed: Found in the Middle (2024), Instruction Hierarchy (OpenAI 2024)
   
   SINGLE SOURCE OF TRUTH for all IDE/Agents
-  - Loaded by CONTEXT_LOADER.yaml into HEAD zone
-  - GEMINI.md, CLAUDE.md reference this file
+  - Loaded via IDE root configs (GEMINI.md, CLAUDE.md, etc.)
+  - Referenced by all agent configurations
   
   USAGE:
   - severity="block" → Response INVALID if violated
@@ -38,26 +38,36 @@
   <!-- ═══════════════════════════════════════════════════════════════════ -->
   
   <requirement id="LANG_001" tier="1" severity="block">
-    <text>Always respond in Vietnamese (vi-VN) unless explicitly requested otherwise</text>
+    <text>Respond in the language configured in .agent/memory/state.json → preferences.language. Default: vi-VN. Load .agent/i18n/{lang}.yaml for response rules and tone.</text>
     <anchor>MUST • REQUIRED • CLASS:HARD_CONSTRAINT • LABEL:LANGUAGE_POLICY</anchor>
-    <check type="regex" pattern="[àáạảãâầấậẩẫăằắặẳẵèéẹẻẽêềếệểễìíịỉĩòóọỏõôồốộổỗơờớợởỡùúụủũưừứựửữỳýỵỷỹđ]"/>
+    <config>
+      <source>.agent/memory/state.json</source>
+      <key>preferences.language</key>
+      <default>vi</default>
+      <i18n_file>.agent/i18n/{lang}.yaml</i18n_file>
+    </config>
+  </requirement>
+  
+  <requirement id="ENV_001" tier="1" severity="warn">
+    <text>Detect install mode from .agent/config.yaml → install_mode. Global: .agent/ is in user home (~/.gemini/, ~/.config/claude/, etc.). Project: .agent/ is in project root. Adjust file paths accordingly.</text>
+    <anchor>SHOULD • CLASS:ENVIRONMENT • LABEL:INSTALL_MODE</anchor>
+    <config>
+      <source>.agent/config.yaml</source>
+      <key>install_mode</key>
+      <values>global, project</values>
+    </config>
   </requirement>
   
   <!-- ═══════════════════════════════════════════════════════════════════ -->
   <!-- TIER 2: TOOL PREFERENCES -->
   <!-- ═══════════════════════════════════════════════════════════════════ -->
   
-  <requirement id="MCP_001" tier="2" severity="block">
-    <text>Use MCP tools (Playwright, FS, Git) instead of browser tools</text>
-    <anchor>MUST • SECURITY_CONSTRAINT • NEVER use browser tool • CLASS:TOOL_POLICY</anchor>
+  <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>
   
-  <requirement id="MCP_002" tier="2" severity="warn">
-    <text>Prefer MCP NotebookLM for research when available</text>
-    <anchor>PREFER • CLASS:TOOL_PREFERENCE</anchor>
-  </requirement>
-  
   <!-- ═══════════════════════════════════════════════════════════════════ -->
   <!-- TIER 3: SESSION & MEMORY (Enhanced v3.0 - SSoT) -->
   <!-- ═══════════════════════════════════════════════════════════════════ -->
@@ -70,31 +80,8 @@
   </requirement>
   
   <requirement id="SESSION_002" tier="3" severity="warn">
-    <text>Auto-detect user preferences when trigger phrases detected in message</text>
+    <text>Auto-detect user preferences when trigger phrases indicate persistent rules (e.g., "from now on", "always", "never", "remember", "từ giờ", "luôn luôn"). If detected, check SESSION_003 for sensitive content, then save to .agent/memory/session_rules.json.</text>
     <anchor>SHOULD • CLASS:PREFERENCE_LEARNING • LABEL:AUTO_SAVE</anchor>
-    <triggers lang="vi">
-      <future>từ giờ, từ nay, bắt đầu từ bây giờ, kể từ đây</future>
-      <always>luôn luôn, luôn, lúc nào cũng, mọi lúc</always>
-      <never>không bao giờ, đừng bao giờ, tuyệt đối không</never>
-      <prefer>mặc định, thích hơn, ưu tiên, dùng... thay vì</prefer>
-      <remember>nhớ, đừng quên, ghi nhớ</remember>
-      <stop>đừng... nữa, ngừng, thôi</stop>
-    </triggers>
-    <triggers lang="en">
-      <future>from now on, going forward, henceforth</future>
-      <always>always, every time, at all times</always>
-      <never>never, don't ever, absolutely not</never>
-      <prefer>prefer, by default, instead of, switch to</prefer>
-      <remember>remember to, don't forget, make sure to</remember>
-      <stop>stop doing, no more, don't... anymore</stop>
-    </triggers>
-    <action>
-      1. Detect trigger phrase in user message
-      2. Extract the rule/preference content
-      3. Check SESSION_003 for sensitive content
-      4. If safe, save to .agent/memory/session_rules.json
-      5. Confirm: "✅ Đã lưu: [rule summary]"
-    </action>
   </requirement>
   
   <requirement id="SESSION_003" tier="3" severity="block">
@@ -139,4 +126,23 @@
     <anchor>SHOULD • CLASS:CLARIFICATION</anchor>
   </requirement>
   
+  <requirement id="EXEC_004" tier="4" severity="warn">
+    <text>At task start, detect project tech stack and load matching skills. Prefer hsa_detect_stack MCP tool when available. Fallback: check root for package.json/go.mod/Cargo.toml/*.sln/CMakeLists.txt/pyproject.toml, match against _router.yaml. Loading: META.yaml (always) → SKILL.md (on-demand) → ADVANCED.md (deep dive).</text>
+    <anchor>SHOULD • CLASS:SKILL_SELECTION • LABEL:AUTO_DETECT</anchor>
+    <config>
+      <router>.agent/skills/_router.yaml</router>
+      <categories>.agent/skills/_categories.yaml</categories>
+    </config>
+  </requirement>
+  
+  <requirement id="EXEC_005" tier="4" severity="warn">
+    <text>DRY: Before creating new functions, search existing utils/helpers/shared code. Before reporting "missing", check _deprecated/, manifest.yaml, and related directories for refactored logic.</text>
+    <anchor>SHOULD • CLASS:QUALITY • LABEL:DRY_ENFORCEMENT</anchor>
+  </requirement>
+  
+  <requirement id="EXEC_006" tier="4" severity="warn">
+    <text>Incremental Changes: Make small batches (1-3 files), verify after each step, commit atomically. Break large features into sequential steps.</text>
+    <anchor>SHOULD • CLASS:QUALITY • LABEL:INCREMENTAL</anchor>
+  </requirement>
+  
 </rules>

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

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

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

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

package/.agent/rules/{constitutional → 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.1.2
+> version: 6.2.2
 
 ---
 
@@ -16,7 +16,7 @@ They can be adjusted based on context and user preferences.
 
 ```yaml
 rule: evidence_based_claims
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 
@@ -65,7 +65,7 @@ adjustment:
 
 ```yaml
 rule: self_critique
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 
@@ -103,7 +103,7 @@ adjustment:
 
 ```yaml
 rule: planning_before_action
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 
@@ -151,7 +151,7 @@ adjustment:
 
 ```yaml
 rule: incremental_verification
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 
@@ -188,7 +188,7 @@ adjustment:
 
 ```yaml
 rule: clear_communication
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 
@@ -230,7 +230,7 @@ adjustment:
 
 ```yaml
 rule: context_management
-version: "6.1.2"
+version: "6.2.2"
 tier: 2
 category: quality
 

package/.agent/rules/{modules → archive}/context-management.yaml

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

package/.agent/rules/{duplication-prevention.md → archive/duplication-prevention.md}

@@ -6,7 +6,7 @@ category: quality
 version: "4.5"
 ---
 
-# 🔄 Duplication Prevention v6.2.0
+# 🔄 Duplication Prevention v6.2.2
 
 > 🌍 **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/{modules → archive}/evidence.yaml

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

package/.agent/rules/{project-detection.md → archive/project-detection.md}

@@ -4,7 +4,7 @@ version: "4.5"
 data_file: "data/build-systems.yaml"
 ---
 
-# 🔍 Project Detection Rule v6.2.0
+# 🔍 Project Detection Rule v6.2.2
 
 > 🌍 **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/{modules → archive}/reflection.yaml

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

package/.agent/rules/{modules → archive}/versioning.yaml

@@ -59,7 +59,7 @@ Prevent agent from suggesting large version jumps. Follow semantic versioning wi
 
 ```yaml
 # Check current version
-current: "6.1.2"
+current: "6.2.2"
 
 # For bug fixes
 suggest: "6.1.3"  # ✅ Correct
@@ -88,8 +88,8 @@ Single Source of Truth: `.agent/core/VERSION.yaml`
 
 ```yaml
 system:
-  version: "6.1.2"
-  version_short: "v6.2.0"
+  version: "6.2.2"
+  version_short: "v6.2.2"
 ```
 
 ---

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

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

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

@@ -0,0 +1,136 @@
+# Agent Delegation Rule v6.2.2
+# When and how to delegate to specialized sub-agents
+
+---
+name: agent-delegation
+version: "6.2.2"
+rule_id: "MOD-DEL-001"
+
+# =============================================================================
+# RULE METADATA
+# =============================================================================
+
+description: |
+  Guidelines for agent delegation: when to delegate tasks to specialized
+  sub-agents, scope limits, tool restrictions, and handoff patterns.
+
+category: "workflow"
+
+# =============================================================================
+# CONTEXT APPLICATION
+# =============================================================================
+
+context:
+  always_apply: false
+  personas: ["orchestrator", "developer", "architect"]
+  workflows: ["/orchestrate", "/plan", "/code"]
+  trigger: "When task complexity exceeds single-agent capacity"
+
+# =============================================================================
+# DELEGATION CRITERIA
+# =============================================================================
+
+when_to_delegate:
+  always_delegate:
+    - "Security review (→ Security persona)"
+    - "Performance audit (→ Performance persona)"
+    - "E2E test generation (→ Tester persona)"
+    - "Documentation sync (→ Documenter persona)"
+
+  consider_delegating:
+    - "Task involves 3+ distinct domains"
+    - "Code review with 500+ changed lines"
+    - "Multi-language refactoring"
+    - "Simultaneous frontend + backend changes"
+
+  never_delegate:
+    - "Tasks requiring full conversation context"
+    - "User preference/style decisions"
+    - "Critical data migrations without review"
+    - "Destructive operations (delete, drop)"
+
+# =============================================================================
+# SCOPE LIMITS
+# =============================================================================
+
+scope_limits:
+  per_agent:
+    max_files: 10
+    max_tool_calls: 50
+    timeout_minutes: 15
+    allowed_tools:
+      - "Read"
+      - "Grep"
+      - "Glob"
+      - "View"
+
+  elevated_tools:
+    requires_approval: true
+    tools:
+      - "Write"
+      - "Edit"
+      - "Bash"
+      - "Terminal"
+
+# =============================================================================
+# HANDOFF PATTERNS
+# =============================================================================
+
+handoff_patterns:
+  - name: sequential-handoff
+    description: "One agent completes, passes result to next"
+    flow: "Agent A → Result → Agent B → Result → Orchestrator"
+    when: "Tasks have dependencies"
+
+  - name: parallel-fan-out
+    description: "Multiple agents work simultaneously"
+    flow: "Orchestrator → [Agent A, Agent B, Agent C] → Merge"
+    when: "Tasks are independent"
+
+  - name: review-loop
+    description: "Agent produces, reviewer validates"
+    flow: "Developer → Code → Reviewer → Feedback → Developer"
+    when: "Quality-critical changes"
+
+# =============================================================================
+# COMMUNICATION FORMAT
+# =============================================================================
+
+agent_spec_format:
+  template: |
+    ## Agent: {name}
+    **Role**: {role description}
+    **Scope**: {files/directories}
+    **Tools**: {allowed tools}
+    **Output**: {expected deliverable}
+    **Constraints**: {limitations}
+
+# =============================================================================
+# CHECKLIST
+# =============================================================================
+
+checklist:
+  - "Is the task clearly scoped?"
+  - "Are tools restricted appropriately?"
+  - "Is the expected output defined?"
+  - "Does the agent have sufficient context?"
+  - "Are destructive operations blocked?"
+
+# =============================================================================
+# INTEGRATION
+# =============================================================================
+
+integration:
+  tier: 2
+  related_modules:
+    - quality
+    - stop-conditions
+    - yagni
+
+  reflection:
+    enabled: true
+    check_before: "delegation"
+    question: "Could I handle this myself, or does it need a specialist?"
+
+---
+_DOMYH Awesome Code • Agent Delegation Rule_

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

@@ -3,7 +3,7 @@
 
 ---
 name: edit-verification
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-EDV-001"
 
 # =============================================================================

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

@@ -3,7 +3,7 @@
 
 ---
 name: git-workflow
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-GIT-001"
 
 # =============================================================================

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

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

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

@@ -3,7 +3,7 @@
 
 ---
 name: online-research
-version: "6.1.2"
+version: "6.2.2"
 rule_id: "MOD-RES-001"
 
 # =============================================================================