@nockdev/awf 6.2.0

package/.agent/core/TEMPLATES.yaml

@@ -0,0 +1,364 @@
+# DOMYH Awesome Code — Templates Registry v6.0
+# Version: 6.1.2
+# Purpose: Comprehensive template system for prompts, tasks, outputs, and infrastructure
+
+# =============================================================================
+# SYSTEM PROMPT TEMPLATES (NEW in v6.0)
+# =============================================================================
+
+prompts:
+  # Base persona template (composable)
+  persona_base:
+    path: .agent/templates/prompts/persona_base.md
+    description: "Core system prompt template for persona instantiation"
+    placeholders:
+      - "{{PERSONA_NAME}}"
+      - "{{PERSONA_ROLE}}"
+      - "{{PERSONA_GOAL}}"
+      - "{{PERSONA_BACKSTORY}}"
+      - "{{TRAITS}}"
+      - "{{ALLOWED_TOOLS}}"
+      - "{{RESTRICTED_TOOLS}}"
+      - "{{CURRENT_PROJECT}}"
+      - "{{ACTIVE_RULES}}"
+    compose_with:
+      - context_block
+      - guardrails_block
+      - tools_block
+
+  # Context injection template
+  context_block:
+    path: .agent/templates/prompts/context_block.md
+    description: "Dynamic project context injection"
+    placeholders:
+      - "{{ACTIVE_FILES}}"
+      - "{{RECENT_CHANGES}}"
+      - "{{PROJECT_STRUCTURE}}"
+      - "{{CURRENT_BRANCH}}"
+
+  # Guardrails template
+  guardrails_block:
+    path: .agent/templates/prompts/guardrails_block.md
+    description: "Safety guardrails from constitutional rules"
+    include_rules:
+      - .agent/rules/constitutional/tier-0-core.yaml
+      - .agent/rules/constitutional/tier-1-safety.yaml
+
+  # Tools instruction template
+  tools_block:
+    path: .agent/templates/prompts/tools_block.md
+    description: "Tool usage instructions"
+
+# =============================================================================
+# REFLECTION TEMPLATES (NEW in v6.0)
+# =============================================================================
+
+reflection:
+  # Self-critique before output
+  critic:
+    path: .agent/templates/reflection/critic.md
+    description: "Self-critique template based on Reflexion pattern"
+    use_before: ["code_output", "recommendations", "architecture"]
+
+  # Error analysis for learning
+  error_analysis:
+    path: .agent/templates/reflection/error_analysis.md
+    description: "Analyze failures and extract patterns"
+    triggers: ["user_correction", "task_failure"]
+    storage: ".agent/memory/patterns/errors.json"
+
+  # Success reinforcement
+  success_analysis:
+    path: .agent/templates/reflection/success_analysis.md
+    description: "Analyze successes and reinforce patterns"
+    triggers: ["user_satisfaction", "task_complete"]
+    storage: ".agent/memory/patterns/successes.json"
+
+# =============================================================================
+# TASK TEMPLATES (NEW in v6.0)
+# =============================================================================
+
+tasks:
+  # Code implementation task
+  code_implementation:
+    path: .agent/templates/tasks/code_implementation.yaml
+    description: "Template for code implementation tasks"
+    schema:
+      description: string
+      expected_output: string
+      constraints: list
+      success_criteria: list
+
+  # Bug fix task
+  bug_fix:
+    path: .agent/templates/tasks/bug_fix.yaml
+    description: "Template for bug fixing tasks"
+    schema:
+      symptom: string
+      reproduction_steps: list
+      expected_behavior: string
+      investigation_areas: list
+
+  # Audit task
+  audit:
+    path: .agent/templates/tasks/audit.yaml
+    description: "Template for audit tasks"
+    schema:
+      scope: string
+      experts: list
+      checklist: reference
+      output_format: reference
+
+  # Refactoring task
+  refactor:
+    path: .agent/templates/tasks/refactor.yaml
+    description: "Template for refactoring tasks"
+    schema:
+      target: string
+      pattern: string
+      constraints: list
+
+# =============================================================================
+# OUTPUT TEMPLATES (ENHANCED in v6.0)
+# =============================================================================
+
+output:
+  # Implementation result
+  implementation:
+    path: .agent/templates/output/implementation.md
+    description: "Structured implementation output"
+    sections:
+      - plan
+      - changes_made
+      - files_modified
+      - test_results
+      - next_steps
+
+  # Finding report
+  finding:
+    path: .agent/templates/output/finding.md
+    description: "Security/quality finding format"
+    schema:
+      severity: "enum[P0, P1, P2, P3]"
+      title: string
+      file: string
+      line: number
+      evidence: code_block
+      recommendation: string
+      confidence: "enum[high, medium, low]"
+
+  # Architecture proposal
+  architecture:
+    path: .agent/templates/output/architecture.md
+    description: "Architecture decision format"
+    sections:
+      - context
+      - options_analysis
+      - recommendation
+      - diagram
+      - adr
+
+  # JSON structured output
+  json_structured:
+    path: .agent/templates/output/structured.json.tmpl
+    description: "Machine-readable JSON output"
+    validate_schema: true
+
+# =============================================================================
+# PROMPT CHAINS (NEW in v6.0)
+# =============================================================================
+
+chains:
+  # Code review chain
+  code_review:
+    description: "Multi-step code review process"
+    steps:
+      - name: understand
+        template: .agent/templates/chains/review/1_understand.md
+        output_key: understanding
+      - name: analyze
+        template: .agent/templates/chains/review/2_analyze.md
+        input_from: understanding
+        output_key: analysis
+      - name: recommend
+        template: .agent/templates/chains/review/3_recommend.md
+        input_from: analysis
+        output_key: recommendations
+      - name: summarize
+        template: .agent/templates/chains/review/4_summarize.md
+        input_from: recommendations
+
+  # Debugging chain
+  debug:
+    description: "Systematic debugging process"
+    steps:
+      - name: reproduce
+        template: .agent/templates/chains/debug/1_reproduce.md
+        output_key: reproduction
+      - name: isolate
+        template: .agent/templates/chains/debug/2_isolate.md
+        input_from: reproduction
+        output_key: isolation
+      - name: analyze
+        template: .agent/templates/chains/debug/3_analyze.md
+        input_from: isolation
+        output_key: root_cause
+      - name: fix
+        template: .agent/templates/chains/debug/4_fix.md
+        input_from: root_cause
+        output_key: fix
+      - name: verify
+        template: .agent/templates/chains/debug/5_verify.md
+        input_from: fix
+
+  # Implementation chain
+  implement:
+    description: "Structured implementation process"
+    steps:
+      - name: plan
+        template: .agent/templates/chains/implement/1_plan.md
+        output_key: plan
+      - name: implement
+        template: .agent/templates/chains/implement/2_implement.md
+        input_from: plan
+        output_key: code
+      - name: test
+        template: .agent/templates/chains/implement/3_test.md
+        input_from: code
+        output_key: tests
+      - name: review
+        template: .agent/templates/chains/implement/4_review.md
+        input_from: [code, tests]
+
+# =============================================================================
+# DOCKER TEMPLATES (Existing)
+# =============================================================================
+
+docker:
+  compose_dev:
+    path: templates/docker/docker-compose.dev.yaml
+    description: "Development docker-compose with hot reload"
+
+  compose_prod:
+    path: templates/docker/docker-compose.prod.yaml
+    description: "Production docker-compose with health checks"
+
+  compose_observability:
+    path: templates/docker/docker-compose.observability.yaml
+    description: "Prometheus + Grafana + Loki + Tempo stack"
+
+# =============================================================================
+# CI/CD TEMPLATES (Existing)
+# =============================================================================
+
+cicd:
+  github:
+    ci: templates/cicd/github/ci.yaml
+    deploy: templates/cicd/github/deploy.yaml
+    release: templates/cicd/github/release.yaml
+
+  gitlab:
+    ci: templates/cicd/gitlab/.gitlab-ci.yml
+
+  azure:
+    pipeline: templates/cicd/azure/azure-pipelines.yml
+
+# =============================================================================
+# DATABASE MIGRATION TEMPLATES (Existing)
+# =============================================================================
+
+database:
+  atlas:
+    config: templates/db/atlas.hcl
+    migration: templates/db/migrations/
+
+  prisma:
+    schema: templates/db/prisma/schema.prisma
+
+  goose:
+    config: templates/db/goose/dbconf.yml
+
+  seeds:
+    path: templates/db/seeds/
+    formats: [sql, json, yaml]
+
+# =============================================================================
+# API DOCUMENTATION TEMPLATES (Existing)
+# =============================================================================
+
+api:
+  openapi:
+    base: templates/api/openapi.yaml
+    components: templates/api/components/
+
+  asyncapi:
+    base: templates/api/asyncapi.yaml
+
+  graphql:
+    schema: templates/api/schema.graphql
+
+# =============================================================================
+# ENVIRONMENT TEMPLATES (Existing)
+# =============================================================================
+
+environment:
+  local: templates/env/.env.local.template
+  development: templates/env/.env.development.template
+  staging: templates/env/.env.staging.template
+  production: templates/env/.env.production.template
+  common: templates/env/.env.common
+
+# =============================================================================
+# MONITORING TEMPLATES (Existing)
+# =============================================================================
+
+monitoring:
+  prometheus:
+    config: templates/monitoring/prometheus/prometheus.yml
+    rules: templates/monitoring/prometheus/rules/
+
+  grafana:
+    dashboards: templates/monitoring/grafana/dashboards/
+    datasources: templates/monitoring/grafana/datasources/
+
+  alertmanager:
+    config: templates/monitoring/alertmanager/alertmanager.yml
+
+# =============================================================================
+# CODE TEMPLATES (Existing)
+# =============================================================================
+
+code:
+  golang:
+    service: templates/code/go/service.go.tmpl
+    handler: templates/code/go/handler.go.tmpl
+    repository: templates/code/go/repository.go.tmpl
+    test: templates/code/go/test.go.tmpl
+
+  typescript:
+    component: templates/code/ts/component.tsx.tmpl
+    hook: templates/code/ts/hook.ts.tmpl
+    service: templates/code/ts/service.ts.tmpl
+    test: templates/code/ts/test.ts.tmpl
+
+  python:
+    fastapi_route: templates/code/python/route.py.tmpl
+    model: templates/code/python/model.py.tmpl
+    test: templates/code/python/test.py.tmpl
+
+# =============================================================================
+# USAGE REFERENCE
+# =============================================================================
+
+# Reference templates in workflows:
+#   template: $ref:prompts.persona_base
+#   template: $ref:reflection.critic
+#   template: $ref:chains.code_review
+#
+# Compose templates:
+#   base: $ref:prompts.persona_base
+#   with: [prompts.context_block, prompts.guardrails_block]
+#
+# Chain execution:
+#   chain: $ref:chains.debug
+#   input: { symptom: "...", steps: [...] }

package/.agent/core/TOKEN_BUDGETS.yaml

@@ -0,0 +1,157 @@
+# DOMYH Awesome Code — Token Budgets v6.2.0
+# Single Source of Truth for all token budget definitions
+# Centralizes 49 max_tokens declarations across 10 config files
+
+version: "6.1.2"
+engine: token_budgets
+
+# =============================================================================
+# GLOBAL LIMITS
+# =============================================================================
+
+global:
+  context_window: 128000 # Claude 3.5 Sonnet
+  max_allowed: 25000 # Self-imposed limit per session
+  memory_budget: 5500 # Total memory allocation
+  memory_with_jit: 4000 # With JIT optimization (36% savings)
+
+# =============================================================================
+# MEMORY LAYERS (From MEMORY_ENGINE)
+# =============================================================================
+
+memory_layers:
+  layer_1_working: 500 # Always in context
+  layer_2_session: 2000 # Loaded on demand
+  layer_3_state: 500 # Structured JSON
+  layer_4_semantic: 2500 # Optional vector DB
+
+# =============================================================================
+# WORKFLOW LOADING (From TOKEN_LOADING)
+# =============================================================================
+
+workflow:
+  sections:
+    core: 500 # frontmatter, flow_diagram, commands_table
+    phase_content: 800 # Loaded when phase activates
+    reference: 2000 # language_specific, templates, examples
+
+  thresholds:
+    low_memory: 2500 # Warning threshold
+    medium_load: 5000 # Active workflow
+    high_load: 8000 # Multiple workflows
+    peak_usage: 12000 # Maximum before unload
+
+# =============================================================================
+# CONTENT INJECTION (From CONTEXT_INJECTOR)
+# =============================================================================
+
+injection:
+  priority:
+    task_context: 300 # Current task info
+    errors: 200 # Active error messages
+    decisions: 300 # Recent decisions
+    similar_issues: 400 # Related past issues
+    warnings: 150 # Active warnings
+    preferences: 200 # User preferences
+
+  layers:
+    session: 150 # Session notes
+    state: 200 # Project state
+    decisions: 250 # Decisions log
+    audit: 300 # Audit summary
+    patterns: 150 # Code patterns
+
+# =============================================================================
+# CONTEXT LOADING (From CONTEXT_LOADER)
+# =============================================================================
+
+context_loading:
+  workflow:
+    skeleton: 500 # Always loaded
+    details: 400 # On phase entry
+    examples: 300 # On-demand
+    templates: 200 # Reference only
+    language: 500 # Language-specific
+
+  memory:
+    recent: 200 # Recent context pointer
+
+  skill_queries:
+    code: 1000
+    debug: 800
+    audit: 300
+    deploy: 600
+
+# =============================================================================
+# SKILLS (From SKILL_SCHEMA)
+# =============================================================================
+
+skills:
+  tier_1_meta: 100 # META.yaml - always loaded
+  tier_2_skill: 1500 # SKILL.md - on-demand
+  tier_3_advanced: 4000 # ADVANCED.md - referenced only
+
+# =============================================================================
+# SUMMARIZATION (From SUMMARIZATION_ENGINE)
+# =============================================================================
+
+summarization:
+  brief: 200 # 1-liner summaries
+  compact: 500 # Key details
+  detailed: 300 # Full context
+
+# =============================================================================
+# CLEANUP (From CLEANUP_ENGINE)
+# =============================================================================
+
+cleanup:
+  session_summary: 150
+  error_summary: 200
+  phase_summary: 300
+  full_cleanup_budget: 2000
+
+# =============================================================================
+# SEMANTIC (From SEMANTIC_ENGINE)
+# =============================================================================
+
+semantic:
+  model_limit: 8000 # Embedding model limit
+  layer_budget: 2500 # Layer 4 allocation
+
+# =============================================================================
+# CONSOLIDATION (From MEMORY_CONSOLIDATION)
+# =============================================================================
+
+consolidation:
+  output_max: 2000 # Consolidated memory view
+
+# =============================================================================
+# QUEUE PROCESSING (From CONTEXT_PRIORITY)
+# =============================================================================
+
+queue:
+  processing_max: 2000 # Max tokens for priority queue
+
+# =============================================================================
+# ACTIVE MEMORY (From ACTIVE_MEMORY)
+# =============================================================================
+
+active_memory:
+  reflection_budget: 300 # Memory reflection output
+
+# =============================================================================
+# USAGE REFERENCE
+# =============================================================================
+
+usage:
+  reference: "core/TOKEN_BUDGETS.yaml"
+  import_examples:
+    - "TOKEN_LOADING.yaml → workflow.sections.core"
+    - "CONTEXT_INJECTOR.yaml → injection.priority.*"
+    - "MEMORY_ENGINE.yaml → memory_layers.*"
+    - "SKILL_SCHEMA.yaml → skills.*"
+
+  notes:
+    - "All values in tokens (approximate)"
+    - "Values can be adjusted per project needs"
+    - "JIT loading reduces actual usage by ~36%"

package/.agent/core/TOKEN_LOADING.yaml

@@ -0,0 +1,197 @@
+# DOMYH Awesome Code — Token Loading Strategy v6.2.0
+# Optimizes workflow loading for minimal token consumption
+
+# =============================================================================
+# LOADING CONFIGURATION
+# =============================================================================
+
+version: "6.1.2"
+strategy: lazy_sections
+
+# Section-based lazy loading
+# Instead of loading entire workflow files, load sections on-demand
+
+sections:
+  # Always loaded (minimal tokens)
+  core:
+    includes:
+      - frontmatter
+      - flow_diagram
+      - commands_table
+    max_tokens: 500
+
+  # Loaded when phase activates
+  phase_content:
+    trigger: "on_phase_start"
+    max_tokens: 800
+
+  # Loaded only when needed
+  reference:
+    includes:
+      - language_specific
+      - templates
+      - examples
+    trigger: "on_request"
+    max_tokens: 2000
+
+# =============================================================================
+# WORKFLOW OPTIMIZATION REGISTRY
+# =============================================================================
+
+optimized_workflows:
+  # Large workflows (>20KB) - use section loading
+  generate:
+    strategy: section_loading
+    core_sections: [flow, commands]
+    deferred: [templates_by_language, examples]
+
+  monitor:
+    strategy: section_loading
+    core_sections: [flow, commands, pillars]
+    deferred: [docker_compose, alertmanager, grafana]
+
+  env:
+    strategy: section_loading
+    core_sections: [flow, commands]
+    deferred: [templates, language_configs]
+
+  doc:
+    strategy: section_loading
+    core_sections: [flow, commands, types]
+    deferred: [templates, examples]
+
+  migrate:
+    strategy: section_loading
+    core_sections: [flow, commands]
+    deferred: [tool_configs, examples]
+
+  modify:
+    strategy: section_loading
+    core_sections: [flow, commands]
+    deferred: [language_patterns, modernization]
+
+  # Medium workflows (10-20KB) - full load OK
+  debug: { strategy: full_load }
+  deploy: { strategy: full_load }
+  clean: { strategy: full_load }
+  init: { strategy: full_load }
+  perf: { strategy: full_load }
+  code: { strategy: full_load }
+  plan: { strategy: full_load }
+
+  # Small workflows (<10KB) - always full load
+  ap: { strategy: full_load }
+  help: { strategy: full_load }
+  refactor: { strategy: full_load }
+  test: { strategy: full_load }
+  upgrade: { strategy: full_load }
+  orchestrate: { strategy: full_load }
+  review: { strategy: full_load }
+  status: { strategy: full_load }
+  suggest: { strategy: full_load }
+  think: { strategy: full_load }
+  visualize: { strategy: full_load }
+  dev: { strategy: full_load }
+  revert: { strategy: full_load }
+  recap: { strategy: full_load }
+
+# =============================================================================
+# TOKEN BUDGET ENFORCEMENT
+# =============================================================================
+
+budgets:
+  idle:
+    max_tokens: 2500
+    includes: [core_rules, t1_metadata]
+
+  single_workflow:
+    max_tokens: 5000
+    includes: [idle, workflow_core]
+
+  workflow_plus_skills:
+    max_tokens: 8000
+    includes: [single_workflow, up_to_3_skills]
+
+  peak:
+    max_tokens: 12000
+    includes: [workflow_plus_skills, deferred_sections]
+    warning_at: 10000
+
+# =============================================================================
+# CLEANUP TRIGGERS
+# =============================================================================
+
+cleanup:
+  # Auto-cleanup triggers
+  triggers:
+    - on_workflow_switch
+    - on_phase_complete
+    - at_token_threshold
+
+  # What to clean
+  actions:
+    on_workflow_switch:
+      - unload_previous_workflow
+      - unload_unused_skills
+      - summarize_history
+
+    on_phase_complete:
+      - unload_phase_specific_content
+      - keep_only_outputs
+
+    at_token_threshold:
+      threshold: 10000
+      actions:
+        - aggressive_summarization
+        - unload_all_deferred
+        - keep_core_only
+
+# =============================================================================
+# CACHING
+# =============================================================================
+
+cache:
+  enabled: true
+
+  # Cache frequently used workflows
+  preload_on_session:
+    - help # Users often start with help
+    - code # Most common workflow
+
+  # Cache TTL by workflow type
+  ttl:
+    development: 3600 # 1 hour
+    planning: 3600
+    deployment: 1800 # 30 min (changes more often)
+    quality: 3600
+    utility: 7200 # 2 hours (rarely changes)
+
+# =============================================================================
+# MEMORY ENGINE INTEGRATION
+# =============================================================================
+
+memory:
+  enabled: true
+  config_file: core/MEMORY_ENGINE.yaml
+
+  # Layer token budgets (must fit within peak budget)
+  layer_budgets:
+    working: 500
+    session: 2000
+    state: 500
+    semantic: 2500 # Only if enabled
+
+  # Auto-load on session start
+  auto_load:
+    - state.json
+    - session.md
+
+  # Sync with token budgets
+  sync:
+    respect_cleanup_triggers: true
+    include_in_token_count: true
+
+  # Memory files location
+  storage:
+    base_dir: memory/
+    session_cache: core/session_cache.json