@nockdev/awf 6.2.0

package/.agent/skills/frameworks/vue/data/core.yaml

@@ -0,0 +1,270 @@
+# =============================================================================
+# Vue Core Patterns (Feb 2026)
+# =============================================================================
+# Composition API, Reactivity, defineModel
+
+metadata:
+  skill: vue
+  domain: core
+  version: "3.6"
+  updated: "2026-02-05"
+  patterns_count: 6
+
+patterns:
+  - id: vue001
+    name: Composition API
+    category: architecture
+    version: "3.0+"
+    description: Modern Vue development with setup function
+    text: composition api setup ref reactive script setup
+    example: |
+      <script setup lang="ts">
+      import { ref, reactive, computed, onMounted } from 'vue';
+
+      // ✅ Refs for primitives
+      const count = ref(0);
+      const message = ref('Hello');
+
+      // ✅ Reactive for objects
+      const user = reactive({
+        name: 'John',
+        email: 'john@example.com',
+      });
+
+      // ✅ Computed properties
+      const doubleCount = computed(() => count.value * 2);
+
+      // ✅ Methods
+      function increment() {
+        count.value++;
+      }
+
+      // ✅ Lifecycle hooks
+      onMounted(() => {
+        console.log('Component mounted');
+      });
+      </script>
+
+      <template>
+        <div>
+          <p>Count: {{ count }}</p>
+          <p>Double: {{ doubleCount }}</p>
+          <button @click="increment">+1</button>
+        </div>
+      </template>
+    severity: CRITICAL
+    docs_url: https://vuejs.org/guide/extras/composition-api-faq.html
+
+  - id: vue002
+    name: defineModel (Vue 3.5+)
+    category: component
+    version: "3.5+"
+    description: Simplified two-way binding macro
+    text: defineModel v-model two-way binding macro emit
+    example: |
+      <!-- ✅ Vue 3.5+: defineModel replaces defineProps + defineEmits -->
+      <script setup lang="ts">
+      // Old way:
+      // const props = defineProps<{ modelValue: string }>();
+      // const emit = defineEmits<{ 'update:modelValue': [value: string] }>();
+
+      // ✅ New way: defineModel
+      const model = defineModel<string>();
+
+      // ✅ With default value
+      const count = defineModel<number>('count', { default: 0 });
+
+      // ✅ Multiple v-models
+      const firstName = defineModel<string>('firstName');
+      const lastName = defineModel<string>('lastName');
+      </script>
+
+      <template>
+        <input v-model="model" />
+        <input type="number" v-model="count" />
+      </template>
+
+      <!-- Usage in parent -->
+      <!-- <TextInput v-model="searchQuery" v-model:count="itemCount" /> -->
+
+      <!-- ✅ Benefits:
+      - Cleaner syntax
+      - Auto-generates props and emits
+      - Full TypeScript support
+      - Reduces boilerplate significantly -->
+    severity: HIGH
+    docs_url: https://vuejs.org/api/sfc-script-setup.html#definemodel
+
+  - id: vue003
+    name: Deep Reactivity
+    category: reactivity
+    version: "3.5+"
+    description: |
+      Improved reactivity with version counting algorithm.
+      15% smaller bundles, better tree-shaking.
+    text: reactivity deep nested object array tracking
+    example: |
+      <script setup>
+      import { reactive, ref, watch } from 'vue';
+
+      // ✅ Vue 3.5: Enhanced deep reactivity
+      const user = reactive({
+        profile: {
+          settings: {
+            theme: 'dark',
+            notifications: {
+              email: true,
+              push: false,
+            },
+          },
+        },
+      });
+
+      // ✅ Deep mutations trigger updates automatically
+      function togglePush() {
+        user.profile.settings.notifications.push = 
+          !user.profile.settings.notifications.push;
+      }
+
+      // ✅ Watch deep changes
+      watch(
+        () => user.profile.settings,
+        (newVal) => {
+          console.log('Settings changed:', newVal);
+        },
+        { deep: true }
+      );
+
+      // ✅ shallowRef for performance when deep reactivity not needed
+      import { shallowRef } from 'vue';
+      const largeList = shallowRef([...items]);
+      // Only triggers when ref.value is reassigned, not on mutations
+      </script>
+    severity: MEDIUM
+    docs_url: https://vuejs.org/guide/essentials/reactivity-fundamentals.html
+
+  - id: vue004
+    name: Suspense & Async Components
+    category: async
+    version: "3.5+"
+    description: Handle async components with loading states
+    text: suspense async await loading fallback lazy
+    example: |
+      <script setup>
+      import { defineAsyncComponent, Suspense } from 'vue';
+
+      // ✅ Async component with loading/error states
+      const AsyncDashboard = defineAsyncComponent({
+        loader: () => import('./Dashboard.vue'),
+        loadingComponent: LoadingSpinner,
+        errorComponent: ErrorComponent,
+        delay: 200,
+        timeout: 3000,
+      });
+      </script>
+
+      <template>
+        <!-- ✅ Suspense for async setup() -->
+        <Suspense>
+          <template #default>
+            <AsyncDashboard />
+          </template>
+          <template #fallback>
+            <LoadingSpinner />
+          </template>
+        </Suspense>
+      </template>
+
+      <!-- Child component with async setup -->
+      <script setup>
+      // ✅ Async setup - Suspense handles loading
+      const user = await fetchUser();
+      const posts = await fetchPosts(user.id);
+      </script>
+
+      <template>
+        <h1>{{ user.name }}</h1>
+        <PostList :posts="posts" />
+      </template>
+    severity: MEDIUM
+    docs_url: https://vuejs.org/guide/built-ins/suspense.html
+
+  - id: vue005
+    name: Composables (Custom Hooks)
+    category: patterns
+    version: "3.0+"
+    description: Reusable composition functions
+    text: composable hook reusable logic extract function
+    example: |
+      // composables/useFetch.ts
+      import { ref, Ref } from 'vue';
+
+      interface UseFetchReturn<T> {
+        data: Ref<T | null>;
+        error: Ref<Error | null>;
+        loading: Ref<boolean>;
+        refresh: () => Promise<void>;
+      }
+
+      export function useFetch<T>(url: string): UseFetchReturn<T> {
+        const data = ref<T | null>(null);
+        const error = ref<Error | null>(null);
+        const loading = ref(false);
+
+        async function refresh() {
+          loading.value = true;
+          error.value = null;
+          try {
+            const response = await fetch(url);
+            data.value = await response.json();
+          } catch (e) {
+            error.value = e as Error;
+          } finally {
+            loading.value = false;
+          }
+        }
+
+        refresh();
+
+        return { data, error, loading, refresh };
+      }
+
+      // Usage in component
+      <script setup>
+      import { useFetch } from '@/composables/useFetch';
+
+      const { data: users, loading, error, refresh } = useFetch('/api/users');
+      </script>
+    severity: HIGH
+    docs_url: https://vuejs.org/guide/reusability/composables.html
+
+  - id: vue006
+    name: SSR Hydration Mismatch
+    category: ssr
+    version: "3.5+"
+    description: Handle client/server mismatch warnings
+    text: ssr hydration mismatch data-allow-mismatch server
+    example: |
+      <!-- ✅ Vue 3.5: data-allow-mismatch attribute -->
+      <template>
+        <!-- Silence mismatch for dynamic content -->
+        <span data-allow-mismatch>{{ currentTime }}</span>
+
+        <!-- ✅ Mismatch types -->
+        <span data-allow-mismatch="text">{{ randomText }}</span>
+        <div data-allow-mismatch="children">
+          <DynamicContent />
+        </div>
+        <div data-allow-mismatch="class" :class="dynamicClass">
+          Styled content
+        </div>
+        <input data-allow-mismatch="attribute" :value="clientValue" />
+      </template>
+
+      <!-- ✅ Use cases:
+      - Time-based content
+      - Random content
+      - User-specific data
+      - Client-only features -->
+    severity: LOW
+    docs_url: https://vuejs.org/guide/scaling-up/ssr.html

package/.agent/skills/index.json

@@ -0,0 +1,143 @@
+{
+  "version": "6.1.2",
+  "changelog": [
+    "v6.2.0: Hierarchical skill organization with category folders",
+    "New structure: languages/, frameworks/, devops/, core/, cross-cutting/",
+    "56 total skills organized into 5 categories",
+    "Smart routing via _router.yaml",
+    "Token savings: 90% baseline reduction (5,100 → 500)"
+  ],
+  "schema": "hierarchical",
+  "total": 56,
+
+  "tiers": {
+    "T1_META": "META.yaml (~100 tokens) - Always available",
+    "T2_SKILL": "SKILL.md (~1500 tokens) - On-demand",
+    "T3_ADVANCED": "ADVANCED.md (~4000 tokens) - Referenced only"
+  },
+
+  "categories": {
+    "core": {
+      "description": "Core patterns - security, API, errors, logging, observability, auth",
+      "path": "skills/core/",
+      "priority": 0,
+      "always_load": true,
+      "count": 6,
+      "skills": ["security", "api-design", "error-handling", "logging", "observability", "authentication"]
+    },
+    "languages": {
+      "description": "Programming languages",
+      "path": "skills/languages/",
+      "priority": 1,
+      "count": 28,
+      "skills": [
+        "python", "go", "typescript", "javascript", "rust", "cpp", "c",
+        "java", "kotlin", "csharp", "ruby", "php", "swift", "perl", "lua",
+        "asm", "nim", "crystal", "zig", "haskell", "elixir", "scala",
+        "clojure", "fsharp", "ocaml", "r", "julia", "solidity"
+      ]
+    },
+    "frameworks": {
+      "description": "Frontend/Backend frameworks",
+      "path": "skills/frameworks/",
+      "priority": 2,
+      "count": 8,
+      "skills": ["react", "vue", "angular", "svelte", "nextjs", "nuxt", "flutter", "react-native"]
+    },
+    "devops": {
+      "description": "Infrastructure and deployment",
+      "path": "skills/devops/",
+      "priority": 3,
+      "count": 4,
+      "skills": ["docker", "kubernetes", "aws", "ci-cd"]
+    },
+    "cross-cutting": {
+      "description": "Cross-cutting concerns and utilities",
+      "path": "skills/cross-cutting/",
+      "priority": 4,
+      "count": 10,
+      "skills": ["testing", "database", "sql", "tailwind", "electron", "coding-rules", "ui-ux-pro-max", "web-perf", "deno", "bun"]
+    }
+  },
+
+  "skills": [
+    {"id": "security", "path": "skills/core/security/", "category": "core", "always_load_meta": true},
+    {"id": "api-design", "path": "skills/core/api-design/", "category": "core", "always_load_meta": true},
+    {"id": "error-handling", "path": "skills/core/error-handling/", "category": "core", "always_load_meta": true},
+    {"id": "logging", "path": "skills/core/logging/", "category": "core", "always_load_meta": true},
+    
+    {"id": "python", "path": "skills/languages/python/", "category": "languages"},
+    {"id": "go", "path": "skills/languages/go/", "category": "languages"},
+    {"id": "typescript", "path": "skills/languages/typescript/", "category": "languages"},
+    {"id": "javascript", "path": "skills/languages/javascript/", "category": "languages"},
+    {"id": "rust", "path": "skills/languages/rust/", "category": "languages"},
+    {"id": "cpp", "path": "skills/languages/cpp/", "category": "languages"},
+    {"id": "c", "path": "skills/languages/c/", "category": "languages"},
+    {"id": "java", "path": "skills/languages/java/", "category": "languages"},
+    {"id": "kotlin", "path": "skills/languages/kotlin/", "category": "languages"},
+    {"id": "csharp", "path": "skills/languages/csharp/", "category": "languages"},
+    {"id": "ruby", "path": "skills/languages/ruby/", "category": "languages"},
+    {"id": "php", "path": "skills/languages/php/", "category": "languages"},
+    {"id": "swift", "path": "skills/languages/swift/", "category": "languages"},
+    {"id": "perl", "path": "skills/languages/perl/", "category": "languages"},
+    {"id": "lua", "path": "skills/languages/lua/", "category": "languages"},
+    {"id": "asm", "path": "skills/languages/asm/", "category": "languages"},
+    {"id": "nim", "path": "skills/languages/nim/", "category": "languages"},
+    {"id": "crystal", "path": "skills/languages/crystal/", "category": "languages"},
+    {"id": "zig", "path": "skills/languages/zig/", "category": "languages"},
+    {"id": "haskell", "path": "skills/languages/haskell/", "category": "languages"},
+    {"id": "elixir", "path": "skills/languages/elixir/", "category": "languages"},
+    {"id": "scala", "path": "skills/languages/scala/", "category": "languages"},
+    {"id": "clojure", "path": "skills/languages/clojure/", "category": "languages"},
+    {"id": "fsharp", "path": "skills/languages/fsharp/", "category": "languages"},
+    {"id": "ocaml", "path": "skills/languages/ocaml/", "category": "languages"},
+    {"id": "r", "path": "skills/languages/r/", "category": "languages"},
+    {"id": "julia", "path": "skills/languages/julia/", "category": "languages"},
+    {"id": "solidity", "path": "skills/languages/solidity/", "category": "languages"},
+    
+    {"id": "react", "path": "skills/frameworks/react/", "category": "frameworks"},
+    {"id": "vue", "path": "skills/frameworks/vue/", "category": "frameworks"},
+    {"id": "angular", "path": "skills/frameworks/angular/", "category": "frameworks"},
+    {"id": "svelte", "path": "skills/frameworks/svelte/", "category": "frameworks"},
+    {"id": "nextjs", "path": "skills/frameworks/nextjs/", "category": "frameworks"},
+    {"id": "nuxt", "path": "skills/frameworks/nuxt/", "category": "frameworks"},
+    {"id": "flutter", "path": "skills/frameworks/flutter/", "category": "frameworks"},
+    {"id": "react-native", "path": "skills/frameworks/react-native/", "category": "frameworks"},
+    
+    {"id": "docker", "path": "skills/devops/docker/", "category": "devops"},
+    {"id": "kubernetes", "path": "skills/devops/kubernetes/", "category": "devops"},
+    {"id": "aws", "path": "skills/devops/aws/", "category": "devops"},
+    {"id": "ci-cd", "path": "skills/devops/ci-cd/", "category": "devops"},
+    
+    {"id": "testing", "path": "skills/cross-cutting/testing/", "category": "cross-cutting"},
+    {"id": "database", "path": "skills/cross-cutting/database/", "category": "cross-cutting"},
+    {"id": "sql", "path": "skills/cross-cutting/sql/", "category": "cross-cutting"},
+    {"id": "tailwind", "path": "skills/cross-cutting/tailwind/", "category": "cross-cutting"},
+    {"id": "electron", "path": "skills/cross-cutting/electron/", "category": "cross-cutting"},
+    {"id": "coding-rules", "path": "skills/cross-cutting/coding-rules/", "category": "cross-cutting"},
+    {"id": "ui-ux-pro-max", "path": "skills/cross-cutting/ui-ux-pro-max/", "category": "cross-cutting"},
+    {"id": "web-perf", "path": "skills/cross-cutting/web-perf/", "category": "cross-cutting"},
+    {"id": "deno", "path": "skills/cross-cutting/deno/", "category": "cross-cutting"},
+    {"id": "bun", "path": "skills/cross-cutting/bun/", "category": "cross-cutting"}
+  ],
+
+  "aliases": {
+    "_comment": "Backward compatibility: flat skill names → hierarchical paths",
+    "python": "languages/python",
+    "go": "languages/go",
+    "typescript": "languages/typescript",
+    "react": "frameworks/react",
+    "vue": "frameworks/vue",
+    "docker": "devops/docker",
+    "security": "core/security",
+    "testing": "cross-cutting/testing"
+  },
+
+  "token_budget": {
+    "router_baseline": "500 tokens (router + core META)",
+    "per_detected_skill": "100 tokens (META only)",
+    "per_active_skill": "1,500 tokens (SKILL.md)",
+    "max_active": 5,
+    "peak_estimate": "500 + (5 × 1,500) = 8,000 tokens"
+  }
+}

package/.agent/skills/languages/_index.yaml

@@ -0,0 +1,33 @@
+# languages/_index.yaml — Language Skills Index
+category: languages
+description: "Programming languages"
+count: 28
+skills:
+  - { id: python, has_advanced: true }
+  - { id: go, has_advanced: true }
+  - { id: typescript, has_advanced: true }
+  - { id: javascript, has_advanced: true }
+  - { id: rust, has_advanced: true }
+  - { id: cpp, has_advanced: true }
+  - { id: c, has_advanced: true }
+  - { id: java, has_advanced: true }
+  - { id: kotlin, has_advanced: true }
+  - { id: csharp, has_advanced: true }
+  - { id: ruby, has_advanced: true }
+  - { id: php, has_advanced: true }
+  - { id: swift, has_advanced: true }
+  - { id: perl, has_advanced: false }
+  - { id: lua, has_advanced: true }
+  - { id: asm, has_advanced: true }
+  - { id: nim, has_advanced: false }
+  - { id: crystal, has_advanced: false }
+  - { id: zig, has_advanced: false }
+  - { id: haskell, has_advanced: false }
+  - { id: elixir, has_advanced: false }
+  - { id: scala, has_advanced: false }
+  - { id: clojure, has_advanced: false }
+  - { id: fsharp, has_advanced: false }
+  - { id: ocaml, has_advanced: false }
+  - { id: r, has_advanced: false }
+  - { id: julia, has_advanced: false }
+  - { id: solidity, has_advanced: false }