@nockdev/awf 6.2.0 → 6.2.1

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

@@ -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.1"
 tier: 0
 immutable: true
 
@@ -48,7 +48,7 @@ checks:
 
 ```yaml
 rule: truthfulness
-version: "6.1.2"
+version: "6.2.1"
 tier: 0
 immutable: true
 
@@ -75,7 +75,7 @@ uncertainty_markers:
 
 ```yaml
 rule: user_sovereignty
-version: "6.1.2"
+version: "6.2.1"
 tier: 0
 immutable: true
 
@@ -99,7 +99,7 @@ exceptions: []  # No exceptions to this rule
 
 ```yaml
 rule: transparency
-version: "6.1.2"
+version: "6.2.1"
 tier: 0
 immutable: true
 
@@ -120,7 +120,7 @@ requirements:
 
 ```yaml
 rule: privacy
-version: "6.1.2"
+version: "6.2.1"
 tier: 0
 immutable: true
 

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

@@ -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.1"
 tier: 1
 category: safety
 
@@ -65,7 +65,7 @@ override:
 
 ```yaml
 rule: scope_containment
-version: "6.1.2"
+version: "6.2.1"
 tier: 1
 category: safety
 
@@ -110,7 +110,7 @@ override:
 
 ```yaml
 rule: command_execution_safety
-version: "6.1.2"
+version: "6.2.1"
 tier: 1
 category: safety
 
@@ -162,7 +162,7 @@ verification_format: |
 
 ```yaml
 rule: information_boundaries
-version: "6.1.2"
+version: "6.2.1"
 tier: 1
 category: safety
 
@@ -201,7 +201,7 @@ cross_boundary_requests:
 
 ```yaml
 rule: error_recovery
-version: "6.1.2"
+version: "6.2.1"
 tier: 1
 category: safety
 

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

@@ -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.1"
 tier: 2
 category: quality
 
@@ -65,7 +65,7 @@ adjustment:
 
 ```yaml
 rule: self_critique
-version: "6.1.2"
+version: "6.2.1"
 tier: 2
 category: quality
 
@@ -103,7 +103,7 @@ adjustment:
 
 ```yaml
 rule: planning_before_action
-version: "6.1.2"
+version: "6.2.1"
 tier: 2
 category: quality
 
@@ -151,7 +151,7 @@ adjustment:
 
 ```yaml
 rule: incremental_verification
-version: "6.1.2"
+version: "6.2.1"
 tier: 2
 category: quality
 
@@ -188,7 +188,7 @@ adjustment:
 
 ```yaml
 rule: clear_communication
-version: "6.1.2"
+version: "6.2.1"
 tier: 2
 category: quality
 
@@ -230,7 +230,7 @@ adjustment:
 
 ```yaml
 rule: context_management
-version: "6.1.2"
+version: "6.2.1"
 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.1"
 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.1
 
 > 🌍 **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.1"
 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.1
 
 > 🌍 **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

@@ -16,7 +16,7 @@ enabling learning from both successes and failures.
 
 ```yaml
 name: reflection
-version: "6.1.2"
+version: "6.2.1"
 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.1"
 
 # 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.1"
+  version_short: "v6.2.1"
 ```
 
 ---

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

@@ -1,7 +1,7 @@
-# Build Systems Detection Data v6.2.0
+# Build Systems Detection Data v6.2.1
 # Externalized from project-detection.md
 
-version: "6.1.2"
+version: "6.2.1"
 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.1
+# When and how to delegate to specialized sub-agents
+
+---
+name: agent-delegation
+version: "6.2.1"
+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.1"
 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.1"
 rule_id: "MOD-GIT-001"
 
 # =============================================================================

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

@@ -3,7 +3,7 @@
 
 ---
 name: language
-version: "6.1.2"
+version: "6.2.1"
 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.1"
 rule_id: "MOD-RES-001"
 
 # =============================================================================

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

@@ -0,0 +1,141 @@
+# Performance Optimization Rule v6.2.1
+# Model selection, context management, token budget
+
+---
+name: performance-optimization
+version: "6.2.1"
+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.1"
 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.1"
 rule_id: "MOD-STP-001"
 
 # =============================================================================