ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/AGENTS.md

@@ -64,55 +64,86 @@ ROLE: devops (Platform / DevOps Engineer)
   Skip:       Business logic, UI components, application-level DB migrations
   Stack hint: Use declared infra stack. Always include rollback plan for any change.
 
+ROLE: qa (QA / Test Engineer)
+  Focus:      Test strategy, edge-case analysis, regression testing, E2E flows, test pyramid
+  Depth:      Mocking precision, flaky test elimination, assertion quality, boundary conditions
+  Skip:       Writing business implementation code directly before test assertions exist
+  Stack hint: Always use the declared test framework (Vitest/Playwright/Jest/Cypress).
+
+ROLE: pm (Product Manager)
+  Focus:      PRD synthesis, user stories, acceptance criteria (Given/When/Then), feature scoping
+  Depth:      User journey mapping, edge-case behavior definitions, value-driven prioritization
+  Skip:       Low-level code implementation, CSS styling, low-level SQL optimization
+  Stack hint: Output clear technical specs and acceptance criteria ready for dev handoff.
+
+ROLE: ba (Business Analyst)
+  Focus:      Business rules modeling, data flow diagrams (ASCII), use cases, non-functional specs
+  Depth:      Entity relationships, workflow transition rules, validation logic, compliance
+  Skip:       Framework-specific boilerplate, cloud deployment scripts
+  Stack hint: Use structured markdown tables and ASCII diagrams for business workflows.
+
+ROLE: data-analyst (Data Analyst)
+  Focus:      SQL query optimization, business metric definitions, data validation, aggregations
+  Depth:      Window functions, CTEs, query plan profiling, cohort analysis, metric consistency
+  Skip:       UI component development, frontend routing, REST API controllers
+  Stack hint: Use declared database and analytics stack.
+
+ROLE: data-architect (Data Architect)
+  Focus:      Enterprise data modeling, schema governance, storage tiering, zero-downtime evolution
+  Depth:      Data lineage, Lakehouse architecture (Medallion), partition strategy, data contracts
+  Skip:       Ad-hoc endpoint CRUD, frontend styling, quick script hacks
+  Stack hint: Focus on long-term data integrity, contracts, and backward compatibility.
+
+ROLE: data-scientist (Data Scientist)
+  Focus:      Model evaluation, feature engineering, statistical metrics, experiment reproducibility
+  Depth:      Exploratory data analysis, validation split, metric trade-offs (precision/recall/AUC)
+  Skip:       Rigid enterprise boilerplate during EDA (exempted from strict function length thresholds)
+  Stack hint: Use declared Python/ML/LLM stack.
+
 ---
 
-[Skill Routing — Quick Table]
+[Skill Routing — Quick Table (11 Super-Skills)]
 Match the user's intent against keywords. Pick the best skill, then read its SKILL.md.
-The role context from PROJECT.md adjusts HOW the skill executes, not which skill is chosen.
-
-| Intent / Keywords                                              | Skill                      |
-|----------------------------------------------------------------|----------------------------|
-| phân quyền, rbac, abac, auth middleware, access control, bảo mật api, quyền truy cập | qk-access-policy           |
-| build ai, rag pipeline, prompt engineering, viết prompt, thiết kế agent, llm, vector database | qk-ai-builder              |
-| tích hợp api, gọi api, fetch data, consume api, kết nối api, bind data, state management | qk-api-consumer            |
-| viết api, tạo endpoint, thiết kế api, build api, rest, graphql, trpc | qk-api-lifecycle           |
-| fix bug, sửa lỗi, crash, error, exception, not working, bị lỗi | qk-bug-resolution          |
-| review code, code review, kiểm tra code, đánh giá code, review skin, review rule, review ai config | qk-code-review             |
-| load context, understand project, vẽ dependency graph, analyze architecture, giải thích kiến trúc dự án, tìm hiểu codebase | qk-context-loader          |
-| data pipeline, etl, elt, dbt, dbt model, airflow dag, spark job | qk-data-engineer           |
-| sửa schema, migration, database model, db schema, cập nhật database, đổi model, thêm cột | qk-data-lifecycle          |
-| tối ưu query, query chậm, optimize db, thêm index, explain, slow query, n+1 query | qk-db-optimizer            |
-| định nghĩa design system, cấu trúc token, quy chuẩn ui, design tokens, component variants, quản trị thiết kế | qk-design-system-engineering |
-| ci/cd, deployment, pipeline, docker, dockerfile, devops, github actions | qk-devops-platform         |
-| viết docs, tài liệu, readme, document, jsdoc, swagger, viết hướng dẫn | qk-docs                    |
-| add feature, build new, implement, phát triển tính năng, tạo mới, thêm chức năng | qk-feature-delivery        |
-| help, list skills, có những skill nào, chọn skill nào, dùng skill gì, route task, hỗ trợ điều hướng | qk-orchestrator            |
-| viết spec, phân tích yêu cầu, acceptance criteria, prd, đặc tả kỹ thuật, user story, làm rõ yêu cầu | qk-product-specification   |
-| deploy production, release checklist, go live, rollout, chuẩn bị release, kiểm tra release | qk-production-release      |
-| phân tích dự án, gap analysis, feasibility, audit report, đánh giá rủi ro, risk assessment | qk-project-audit           |
-| khởi tạo dự án, project setup, scaffold, bootstrap, new app, setup dev profile, detect stack | qk-project-bootstrap       |
-| audit project, code smell, tech debt, health check, project score, nợ kỹ thuật, kiểm tra sức khỏe code | qk-project-health          |
-| lưu context, project memory, ghi nhớ, /learn, lưu vào bộ nhớ, nhớ lại, tìm lại fact | qk-project-memory          |
-| refactor, tái cấu trúc, tách file, extract function/component/module, clean code, reduce complexity, file quá dài | qk-refactor                |
-| security audit, kiểm tra bảo mật, scan lỗ hổng, owasp, tìm secret leak, dependency vulnerability, npm audit | qk-security-audit          |
-| viết test, test strategy, unit test, coverage, e2e, integration test, mock data | qk-test-engineering        |
-| review ui, audit giao diện, kiểm tra ui, ui quality, component spacing, design consistency, anti | qk-ui-audit                |
-| build ui, làm giao diện, css, layout, component, figma, design ui | qk-ui-builder              |
-| design system, token, setup css, ui system, tạo design system, cấu hình token | qk-ui-system-builder       |
-| upgrade, nâng cấp thư viện, update package, migrate framework, version, cập nhật dependency, breaking change | qk-upgrade                 |
-| a11y, accessibility, wcag, lighthouse, core web vitals, seo audit, page speed | qk-web-quality-gate        |
+The role context from DEV_PROFILE.md adjusts HOW the skill executes, not which skill is chosen.
+
+| Intent / Keywords                                                                                                                    | Super-Skill         | Phụ Đề Dev (Nhiệm vụ cốt lõi) |
+|--------------------------------------------------------------------------------------------------------------------------------------|----------------------|-------------------------------|
+| help, list skills, chọn skill gì, route task, điều hướng, load context, kiến trúc dự án, dependency graph, bootstrap, setup profile | `qk-orchestrator`    | **Điều hướng & Context**       |
+| viết prompt, compile prompt, viết lại prompt, chuẩn hóa prompt, prompt compiler, tối ưu prompt, prompt rulebook                      | `qk-prompt-compiler` | **Biên Dịch & Chuẩn Hóa Prompt**|
+| viết spec, PRD, acceptance criteria, user story, bdd, gap analysis, feasibility, audit dự án, rủi ro, clarify requirements          | `qk-product-spec`    | **Viết Spec & PRD**           |
+| add feature, phát triển tính năng mới, tạo mới, build new, tích hợp api, fetch/consume api, bind data, state management              | `qk-feature-delivery`| **Build Feature mới**         |
+| fix bug, sửa lỗi, crash, error, exception, not working, bị lỗi, debug, trace lỗi, điều tra nguyên nhân bug                           | `qk-bug-resolution`  | **Debug & Fix Bug**           |
+| build ui, làm giao diện, css, layout, component, figma, design system, tokens, anti-slop, ui audit, spacing, visual consistency     | `qk-ui-engineer`     | **Build UI & Component**      |
+| viết api, endpoint, rest/graphql, db schema, migration, phân quyền rbac/abac, tối ưu query explain, data pipeline, etl, dbt         | `qk-backend-data`    | **API & Database**            |
+| postman, api discovery, api evidence, schema discovery, data contract, data dictionary, bronze ingestion, chuẩn hóa postman, phân tích postman | `qk-api-data-discovery` | **Khám Phá API & Data Contract** |
+| review code, đánh giá code, health check, nợ kỹ thuật, project score, security audit, owasp, scan lỗ hổng, a11y, wcag, core web vitals| `qk-code-review`     | **Review Code & Audit**       |
+| refactor, tái cấu trúc, tách file, clean code, giảm complexity, upgrade thư viện, update package, viết test, unit/integration/e2e test | `qk-code-cleaner`    | **Refactor & Viết Test**      |
+| devops, docker, dockerfile, ci/cd, github actions, release production, 8-gate, viết docs, readme, swagger, project memory, /learn, rag, ai builder | `qk-devops-release`  | **DevOps, CI/CD & Deploy**    |
 
 Nếu không khớp rõ → dùng `qk-orchestrator`.
 
 ---
 
+[Platform-Specific Instructions]
+Each IDE has a different entry point and context window:
+
+| IDE | Entry Point | Context | Tool Format |
+|---|---|---|---|
+| **Antigravity** |  | Large | Custom Cockpit |
+| **Claude** |  | ~200K tokens | Read/Write/Edit/Bash |
+| **OpenCode** |  | ~128K tokens | Custom |
+
+Each skill has  in frontmatter and a  section.
+
+---
+
 [Trigger Mechanism]
 Two ways to activate a skill:
 
 1. Command syntax:    `./qk-[skill-name] [--args]`
-   Example:           `./qk-ui-builder --fw=react --css=tailwind`
+   Example:           `./qk-ui-engineer --fw=react --css=tailwind`
 
-2. Natural language:  Mô tả nhu cầu bằng tiếng Việt hoặc tiếng Anh.
+2. Natural language:  Mô tả nhu cầu bằng tiếng Việt (kể cả dùng Dev slang: "fix bug", "refactor", "viết api", "build UI") hoặc tiếng Anh.
    Routing table trên sẽ map sang skill phù hợp.
 
 Trong cả hai trường hợp, AI PHẢI đọc SKILL.md của skill được chọn trước khi làm.
@@ -120,10 +151,12 @@ Trong cả hai trường hợp, AI PHẢI đọc SKILL.md của skill được c
 ---
 
 [Execution Rules]
-1. Announce:  `[🚀 AI Developer Skin: Đã kích hoạt kỹ năng <skill-name> | Role: <role>]`
-2. Execute end-to-end. KHÔNG dừng hỏi trừ khi yêu cầu mơ hồ hoặc có thay đổi destructive.
-3. Áp dụng role context từ DEV_PROFILE.md vào mọi quyết định kỹ thuật.
-4. Report kết quả theo format:
+1. Announce:  `[🚀 AI Developer Skin: Đã kích hoạt <skill-name> (<phụ-đề-dev>) | Role: <role>]`
+   *(Ví dụ: `[🚀 AI Developer Skin: Đã kích hoạt qk-ui-engineer (Build UI & Component) | Role: frontend]`)*
+2. Prompt Compiler Alignment (R-G-15): Khi nhận câu lệnh thô (fix bug, thêm tính năng, phân tích dữ liệu...), AI BẮT BUỘC hiển thị khối **Prompt đã chuyển hóa (Compiled Execution Prompt)** công khai (nêu rõ Role, Objective, Scope In/Out, Constraints, và Acceptance Criteria) trước hoặc ngay khi thực thi để người dùng giám sát.
+3. Execute end-to-end. KHÔNG dừng hỏi trừ khi yêu cầu mơ hồ hoặc có thay đổi destructive.
+4. Áp dụng role context từ DEV_PROFILE.md vào mọi quyết định kỹ thuật.
+5. Report kết quả theo format:
 
 ```
 🔧 <Skill Name> Summary                              [Role: <role> | Stack: <primary stack>]

package/.agents/DEV_PROFILE.md

@@ -5,7 +5,7 @@
 # ─────────────────────────────────────────────────
 
 ## Role
-# Chọn một trong: fe | be | fullstack | data | devops | ai-engineer
+# Chọn một trong: fe | be | fullstack | data | devops | ai-engineer | qa | pm | ba | data-analyst | data-architect | data-scientist
 role: fullstack
 
 ## Stack
@@ -21,7 +21,7 @@ stack:
   infra:      ""          # Docker / GitHub Actions / Vercel / AWS / GCP
   language:   ""          # TypeScript / JavaScript / Python / Go / Java
 
-## Data Stack (điền nếu role = data hoặc ai-engineer)
+## Data Stack (điền nếu role = data, data-analyst, data-architect, data-scientist hoặc ai-engineer)
 data_stack:
   pipeline:   ""          # dbt / Spark / Airflow / Prefect / Dagster
   warehouse:  ""          # BigQuery / Snowflake / Redshift / ClickHouse
@@ -93,3 +93,37 @@ constraints:
 #   stack: { infra: "GitHub Actions + AWS ECS", language: "Python + Bash" }
 #   → AI sẽ: tập trung CI/CD, IaC, observability, rollback strategy, security hardening
 #   → AI sẽ KHÔNG: viết business logic, thiết kế API
+#
+# 👤 QA / Test Engineer (qa):
+#   role: qa
+#   stack: { test_framework: "Vitest / Playwright / Jest", language: "TypeScript" }
+#   → AI sẽ: tập trung Test Pyramid, mocking strategy, edge cases, E2E flows, regression testing
+#   → AI sẽ KHÔNG: tự ý sửa business logic khi chưa có test assertion rõ ràng
+#
+# 👤 Product Manager (pm):
+#   role: pm
+#   → AI sẽ: tập trung PRD, User Stories, Acceptance Criteria (Given/When/Then), Feature Scoping, Risk Analysis
+#   → AI sẽ KHÔNG: sa đà vào viết mã nguồn chi tiết hay tranh luận CSS/SQL
+#
+# 👤 Business Analyst (ba):
+#   role: ba
+#   → AI sẽ: tập trung Use Cases, Data Flow Diagrams (ASCII), Business Rules Matrix, Non-Functional Specs
+#   → AI sẽ KHÔNG: can thiệp vào low-level framework implementation
+#
+# 👤 Data Analyst (data-analyst):
+#   role: data-analyst
+#   stack: { database: "PostgreSQL / BigQuery", language: "SQL + Python" }
+#   → AI sẽ: tập trung tối ưu SQL queries, Aggregations, Window Functions, Business Metrics, Data Quality
+#   → AI sẽ KHÔNG: thiết kế frontend components hay REST controllers
+#
+# 👤 Data Architect (data-architect):
+#   role: data-architect
+#   data_stack: { warehouse: "Snowflake / BigQuery", format: "Delta / Iceberg", pipeline: "dbt" }
+#   → AI sẽ: tập trung Enterprise Data Modeling, Schema Governance, Zero-Downtime Migration, Storage Layer
+#   → AI sẽ KHÔNG: viết ad-hoc CRUD endpoints
+#
+# 👤 Data Scientist (data-scientist):
+#   role: data-scientist
+#   data_stack: { llm: "Gemini / OpenAI", vector_db: "pgvector", pipeline: "Python + Pandas / PyTorch" }
+#   → AI sẽ: tập trung Model Evaluation, Feature Engineering, linh hoạt trong Notebooks (miễn trừ ngưỡng SOLID)
+#   → AI sẽ KHÔNG: áp đặt boilerplate doanh nghiệp cứng nhắc lên code thử nghiệm nghiên cứu

package/.agents/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Quang Khánh
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Quang Khánh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.agents/docs/ARCHITECTURE.md

@@ -1,4 +1,4 @@
-# AI Developer Skill OS — V8 Architecture
+# AI Developer Skill OS — V10 Architecture
 
 ## Source of Truth
 
@@ -10,12 +10,51 @@
 | File | Editable? | Generated from |
 |---|---|---|
 | `.agents/skills/*/SKILL.md` | ✅ YES | — (source) |
-| `.agents/registry/skills-index.yml` | ❌ NO | `tooling/generate-registry.js` |
-| `skills.json` | ❌ NO | `tooling/generate-registry.js` |
+| `.agents/registry/index.yaml` | ❌ NO | `node tooling/build-registry.js` |
+| `.agents/registry/graph.json` | ❌ NO | `node tooling/build-registry.js` |
 
 Regenerate after any SKILL.md change:
 ```bash
-node tooling/generate-registry.js
+node tooling/build-registry.js
+```
+
+---
+
+## Directory Structure
+
+```
+.agents/
+├── AGENTS.md              # Master configuration for all AI coding agents
+├── DEV_PROFILE.md         # Developer role + stack profile
+├── rules/                 # Behavior policies (global, coding, security, safety...)
+├── skills/                # 11 Super-Skills + _template
+│   ├── qk-orchestrator/
+│   ├── qk-prompt-compiler/
+│   ├── qk-product-spec/
+│   ├── qk-feature-delivery/
+│   ├── qk-bug-resolution/
+│   ├── qk-code-cleaner/
+│   ├── qk-code-review/
+│   ├── qk-ui-engineer/
+│   ├── qk-backend-data/
+│   ├── qk-devops-release/
+│   ├── qk-api-data-discovery/
+│   └── _template/
+├── workflows/             # 12 execution pipelines (YAML)
+│   ├── shared/
+│   └── *_workflow*.yml
+├── registry/              # Generated runtime artifacts
+│   ├── index.yaml         # Lightweight lookup
+│   └── graph.json         # O(1) adjacency graph
+├── docs/                  # Architecture documentation
+└── knowledge/             # Design intelligence patterns & templates
+
+tooling/
+├── build-registry.js      # Generate index.yaml + graph.json
+├── validate-skills.js     # Validate all SKILL.md files
+├── validate-graph.js      # Validate graph integrity
+├── sync-versions.js       # Sync version across all files
+└── run-aar.js             # Run after-action review
 ```
 
 ---
@@ -29,128 +68,25 @@ User / Calling Agent
    AGENTS.md               ← Entry point. Read this first.
         │
         ▼
- registry/skills-index.yml ← Find candidate skills by task keywords
+   qk-orchestrator         ← Route to correct Super-Skill
         │
         ▼
-  skills/qk-*/SKILL.md     ← Confirm intent, preconditions, complexity
+   [Target Super-Skill]    ← Execute with Role Adaptation
         │
-        ├── rules: [global, coding, safety]   ← Load relevant rules
-        │
-        ├── workflow: bug-resolution          ← Load execution pipeline
+        ▼
+   Evidence Gate           ← Verify CLAIM <= EVIDENCE
         │
-        └── verification: strategy           ← Know how to verify
-                │
-                ▼
-        Execute workflow steps
-                │
-                ▼
-        Exit with: SUCCESS | BLOCKED | FAILED | PARTIAL
-                │
-                ▼
-        learnings/ ← (human) Document lessons learned
-```
-
----
-
-## Domain Map
-
-| Domain | Path | Question Answered | Owner |
-|---|---|---|---|
-| Rules | `.agents/rules/` | How should agent behave? | Architect |
-| Workflows | `.agents/workflows/` | What sequence to follow? | Architect |
-| Skills | `.agents/skills/` | What can agent do? | Skill author |
-| Examples | `.agents/examples/` | What does good output look like? | Human |
-| Learnings | `.agents/learnings/` | What lessons are validated? | Human |
-| Registry | `.agents/registry/` | Which skill for this task? | Generated |
-
----
-
-## Skill Anatomy (V8)
-
-```
-SKILL.md
-├── frontmatter (YAML)
-│   ├── Identity: name, version, description
-│   ├── Classification: type, intent, triggers, complexity
-│   ├── References: workflow, rules, tools, related_skills
-│   ├── Verification: required, strategy
-│   └── Runtime: execution_mode, token_budget, exit_codes
-│
-└── body (Markdown)
-    ├── Preconditions
-    ├── Scope (✅ does / ❌ does not)
-    └── Output Format
-```
-
-The skill body contains **what** and **when**. The referenced **workflow** contains **how**.
-
----
-
-## Retrieval Path (AI-Native)
-
-When given a task, the agent MUST:
-
-```
-1. Read registry/skills-index.yml
-   → triggers matching → candidate_skills[]
-
-2. Read candidate SKILL.md(s)
-   → confirm intent + preconditions met?
-   → if BLOCKED: ask user for missing info
-
-3. Load workflow YAML
-   → understand step inputs/outputs
-
-4. Load referenced rules (global.md always, coding.md if edit_files)
-
-5. Execute step by step
-   → each step: check inputs → execute → verify outputs
-
-6. Exit with code + report
-```
-
-**Do NOT:**
-- Load all 22 skills at once
-- Read entire files without targeted grep first
-- Proceed without verifying preconditions
-
----
-
-## Knowledge Lifecycle
-
-```
-Observation (agent)
-      ↓
-Draft Learning (auto-created on FAILED exit)
-      ↓
-Human Review
-      ↓
-Validated Learning (human promotes with evidence)
-      ↓
-Referenced in Skill / Workflow
-      ↓
-Deprecated (when superseded by newer evidence)
+        ▼
+   Exit Code               ← SUCCESS | PARTIAL | BLOCKED | FAILED
 ```
 
 ---
 
-## Versioning Summary
-
-See [VERSIONING.md](./VERSIONING.md) for full policy.
-
-| Change Type | Version Bump |
-|---|---|
-| Breaking schema change | Major (8.x.x → 9.0.0) |
-| New skill / workflow | Minor (8.0.x → 8.1.0) |
-| Fix typo / improve description | Patch (8.0.0 → 8.0.1) |
-
----
-
-## File Conventions
+## V10.2 Key Principles
 
-| Pattern | Purpose |
-|---|---|
-| `_schema.yml` | Schema definition (not a skill/workflow) |
-| `README.md` in empty dirs | Placeholder + instructions |
-| `ADR-NNN-*.md` | Architecture Decision Record |
-| `[validated]` in git message | Promotes draft learning to validated |
+1. **Confidence Model**: Every routing decision has HIGH/MEDIUM/LOW confidence
+2. **Exit Codes**: Every skill defines SUCCESS/PARTIAL/BLOCKED/FAILED
+3. **Evidence Format**: Structured evidence with severity, confidence, fix suggestion
+4. **Compliance**: Every skill has a compliance checklist with schema_version 10.2.0
+5. **Zero Orphans**: All 11 skills connected in graph (Score 100/100)
+6. **No Duplicate Systems**: Single skill system under `.agents/skills/` only

package/.agents/docs/GOVERNANCE.md

@@ -30,9 +30,9 @@ A change is considered **Breaking** if it:
 
 ## 5. Versioning Strategy (Semantic Versioning)
 We strictly adhere to SemVer based on the framework's architecture, not just content.
-- **MAJOR (e.g., v4.0.0 to v6.0.0):** Breaking changes to the Kernel (`AGENTS.md`), Metadata Contract (`SPEC.md`), or fundamental routing.
-- **MINOR (e.g., v4.0.0 to v4.1.0):** Adding new Capabilities, new default Skills, new Knowledge docs, or new Templates. 
-- **PATCH (e.g., v4.0.0 to v4.0.1):** Fixing typos in docs, updating README, or minor bug fixes within an individual skill's SOP.
+- **MAJOR (e.g., v10.x.x to v11.0.0):** Breaking changes to the Kernel (`AGENTS.md`), Metadata Contract (`SPEC.md`), or fundamental routing.
+- **MINOR (e.g., v10.2.0 to v10.3.0):** Adding new Capabilities, new default Skills, new Knowledge docs, or new Templates. 
+- **PATCH (e.g., v10.2.0 to v10.2.1):** Fixing typos in docs, updating README, or minor bug fixes within an individual skill's SOP.
 
 ## 6. PR Review Process
 1. **Architecture Compliance:** Does the PR violate the Kernel Freeze? Are all skills compliant with `SPEC.md`?