ai-developer-skill-os 10.1.0 → 10.2.0

package/.agents/AGENTS.md

@@ -124,6 +124,19 @@ 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:
 

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`?

package/.agents/docs/SPEC.md

@@ -1,4 +1,4 @@
-# AI Developer Skill OS - Specification (v7.5)
+# AI Developer Skill OS - Specification (V10.2.0)
 
 This document defines the strict contract and schema for all `SKILL.md` files in the AI Developer Skill OS. Every active skill MUST comply with this specification. The frontmatter is frozen to ensure cross-platform compatibility and deterministic agent behavior.
 
@@ -8,28 +8,57 @@ Every `SKILL.md` must begin with this exact YAML structure. Do not add, remove,
 
 ```yaml
 ---
+# ── Identity ───────────────────────────────────────
 name: qk-[skill-name]
-category: [core|frontend|backend|fullstack|security|qa|maintenance|devops|utilities]
-version: X.Y.Z
-description: "[One sentence — what this skill does]"
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
+version: 10.2.0
+status: stable
+description: "[Một câu — skill này làm gì và dành cho ai]"
+platforms: [antigravity, claude, opencode]
+
+# ── Classification ─────────────────────────────────
+type: capability                    # capability | utility | orchestrator
+runtime_version: 1
+
+intent:
+  - [primary-intent]
+  - [secondary-intent]
+
+complexity:
+  level: medium                     # low | medium | high | critical
+
+triggers:
+  - "[trigger phrase 1]"
 
-# Orchestrator routing metadata
-cost: [low|medium|high]
-latency: [fast|medium|slow]
-risk: [low|medium|high]
-side_effects: [edit_files|run_commands|read_only|none]
-produces: [report|code|schema|plan|tokens]
-consumes: [context-graph|design-md|stack-trace|json-payload|none]
+selection:
+  priority: medium                  # high | medium | low
+  confidence_threshold: 0.75
 
+# ── References ─────────────────────────────────────
+workflow: [workflow-name]
+rules:
+  - global
+tools:
+  - filesystem
+
+# ── Runtime ────────────────────────────────────────
+execution_mode: deterministic
 token_budget:
   max_files_read: 3
   max_lines_per_read: 150
   max_shell_commands: 2
   stop_early: true
 
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+# ── V10 Required ───────────────────────────────────
+exit_codes:
+  SUCCESS: "Task completed"
+  PARTIAL: "Task done with gaps"
+  BLOCKED: "Missing precondition"
+  FAILED: "Task failed"
+
+compliance:
+  schema_version: 10.2.0
+  runtime_version: 1
+  platforms: [antigravity, claude, opencode]
 ---
 ```
 
@@ -38,50 +67,98 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `name` | string | YES | Skill identifier, must start with `qk-` |
-| `category` | enum | YES | Primary domain: `core`, `frontend`, `backend`, `fullstack`, `security`, `qa`, `maintenance`, `devops`, `utilities` |
-| `version` | semver | YES | Semantic version of this skill |
+| `version` | semver | YES | Must be `10.2.0` |
+| `status` | enum | YES | `stable`, `experimental`, or `deprecated` |
 | `description` | string | YES | One-sentence summary of the skill's purpose |
-| `platforms` | array | YES | Supported AI platforms. Valid values: `antigravity`, `claude-code`, `cursor`, `windsurf`, `kilo-code` |
-| `execution_mode` | string | YES | Must be `deterministic` for all v7.5 skills |
-| `cost` | enum | YES | Token/compute cost: `low`, `medium`, `high` |
-| `latency` | enum | YES | Expected execution speed: `fast`, `medium`, `slow` |
-| `risk` | enum | YES | Risk level of side effects: `low`, `medium`, `high` |
-| `side_effects` | enum | YES | What the skill modifies: `edit_files`, `run_commands`, `read_only`, `none` |
-| `produces` | array | YES | Output artifacts: `report`, `code`, `schema`, `plan`, `tokens` |
-| `consumes` | array | YES | Required inputs: `context-graph`, `design-md`, `stack-trace`, `json-payload`, `none` |
-| `token_budget.max_files_read` | int | YES | Maximum files to read before stopping |
-| `token_budget.max_lines_per_read` | int | YES | Maximum lines per file read operation |
-| `token_budget.max_shell_commands` | int | YES | Maximum shell commands allowed |
-| `token_budget.stop_early` | bool | YES | Whether to stop when confidence threshold is reached |
-| `exit_codes` | array | YES | Valid exit codes for this skill |
-
-## 2. Skill Body Structure (Markdown)
-
-The body of the `SKILL.md` file MUST contain the following sections in order:
-
-1. **Header:** Skill title and language rule
-2. **Preconditions:** Checklist of required inputs/state before execution
-3. **Scope:** What the skill explicitly does (✅) and does not do (❌)
-4. **Priority Order:** P1–P4 checks with skip thresholds for token budget management
-5. **Workflow:** Phased execution steps with explicit decision trees and exit conditions
-6. **Confidence Model:** HIGH/MEDIUM/LOW confidence levels with actions
-7. **Severity:** CRITICAL/HIGH/MEDIUM/LOW severity definitions with examples
-8. **Evidence Format:** Mandatory template for all findings
-9. **Retry Policy:** Retry logic with maximum attempt limits
-10. **Escalation Rules:** Structured BLOCKED response format
-11. **Handoff Contract:** JSON schema for `Consumes` and `Produces`
-12. **Output Format:** Mandatory output template
-13. **Exit Codes:** Table mapping codes to meanings
-
-## 3. Naming Conventions
-
-- Skill files: `skills/qk-[skill-name]/SKILL.md`
-- Registry entry: `qk-[skill-name]`
-- All code, identifiers, and file names: English only
-- Explanations and reports: Vietnamese (match user language)
-
-## 4. Compliance Enforcement
-
-- All skills MUST pass `npm run lint` (which validates frontmatter against this spec)
-- The `## Compliance` table at the bottom of each `SKILL.md` is deprecated and MUST be removed
-- CI pipeline enforces schema compliance automatically
+| `platforms` | array | YES | Supported IDEs. Valid values: `antigravity`, `claude`, `opencode` |
+| `type` | enum | YES | Primary domain: `capability`, `utility`, `orchestrator` |
+| `runtime_version` | integer | YES | Runtime version (currently `1`) |
+| `execution_mode` | string | YES | Must be `deterministic` for all V10 skills |
+| `intent` | array | YES | Primary and secondary intents |
+| `complexity.level` | enum | YES | `low`, `medium`, `high`, `critical` |
+| `triggers` | array | YES | Keywords that route AI to this skill |
+| `selection.priority` | enum | YES | `high`, `medium`, `low` |
+| `workflow` | string | YES | References `workflows/<name>.yml` |
+| `exit_codes` | object | YES | SUCCESS, PARTIAL, BLOCKED, FAILED with meanings |
+| `compliance` | object | YES | schema_version, runtime_version, platforms |
+
+---
+
+## 2. Required Body Sections (V10.2)
+
+Every `SKILL.md` body MUST contain sections in this order:
+
+```
+## 1. Nguyên Tắc Cốt Lõi & Luật Chống Over-Engineering
+## 2. Giới Hạn Kỹ Thuật & Cấm Kỵ Tuyệt Đối (Hard Boundaries)
+## 3. Quy Trình Thực Hiện Theo Bước (Sequential Procedure)
+## 4. Xử Lý Sự Cố Khi Thất Bại (Failure Path)     [if applicable]
+## 5. Thích Ứng Theo Role Kỹ Thuật (Role Adaptation) [if applicable]
+## 6. Mô Hình Độ Tin Cậy (Confidence Model)
+## 7. Bằng Chứng Định Dạng (Evidence Format)
+## 8. Thoái Ra Mã (Exit Codes)
+## 9. Chính Sách Retry (Retry Policy)               [if applicable]
+## 10. Platform-Specific Instructions
+## 11. Compliance
+```
+
+### V10 Key Requirements
+
+- **Confidence Model**: Every skill defines HIGH/MEDIUM/LOW confidence levels
+- **Exit Codes**: Every skill defines SUCCESS/PARTIAL/BLOCKED/FAILED
+- **Evidence Format**: Every skill has structured evidence format with severity + confidence
+- **Compliance**: Every skill ends with Compliance check table (schema_version 10.2.0)
+- **Platform-Specific**: Every skill has instructions for Antigravity, Claude, OpenCode
+
+---
+
+## 3. Supported Platforms
+
+| Platform | Config File | Context Window | Tool Format |
+|----------|-------------|----------------|-------------|
+| **Antigravity** (Google Gemini) | `.agents/AGENTS.md` | Large | Custom Cockpit |
+| **Claude** (Anthropic) | `.claude/CLAUDE.md` | ~200K tokens | Native (Read/Write/Edit/Bash) |
+| **OpenCode** (Open Source) | `.opencode/config.yaml` | ~128K tokens | Custom |
+
+---
+
+## 4. Registry Schema
+
+| File | Format | Generated by |
+|------|--------|--------------|
+| `.agents/registry/index.yaml` | YAML | `node tooling/build-registry.js` |
+| `.agents/registry/graph.json` | JSON | `node tooling/build-registry.js` |
+
+Each graph node includes: `path`, `version`, `platforms`, `tags`, `dependencies`, `dependents`, `is_orphan`.
+
+---
+
+## 5. Validation
+
+```bash
+# Validate all skill files
+node tooling/validate-skills.js    # 11/11 valid
+
+# Validate graph integrity
+node tooling/validate-graph.js     # Score 100/100
+
+# Rebuild registry
+node tooling/build-registry.js     # 11 active, 0 archived
+
+# Sync versions across repo
+node tooling/sync-versions.js      # All files to 10.2.0
+
+# Run full test suite
+npm run test:registry              # All tests pass
+```
+
+---
+
+## Changelog
+
+| Version | Change |
+|---------|--------|
+| V10.2.0 | 3 IDEs (Antigravity, Claude, OpenCode), platform-specific sections, platforms field |
+| V10.1.0 | 11 Super-Skills, API Discovery Engine, Prompt Compiler Control Plane |
+| V9.x | Legacy multi-skill system (29+ skills) |
+| V8.x | Structured skill system |

package/.agents/docs/VERSIONING.md

@@ -1,95 +1,63 @@
-# Versioning Policy — AI Developer Skill OS V8
+# Versioning Policy — AI Developer Skill OS V10
 
 ## Semantic Versioning: `MAJOR.MINOR.PATCH`
 
-Current: `8.0.0`
+Current: `10.2.0`
 
 ### Bản đồ Kiến trúc các Phiên bản
 
 | Version | Identity                  | Architecture                               |
 | ------- | ------------------------- | ------------------------------------------ |
 | V7      | Prompt Collection         | Static instructions                        |
-| V8.0    | Skill System              | Structured capabilities                    |
-| V8.1.x  | Governed Capability Graph | Decision boundaries + lifecycle governance |
-| V8.2    | Adaptive Agent OS         | Analytics + feedback + adaptive routing    |
+| V8.x    | Skill System              | Structured capabilities                    |
+| V9.x    | Governed Capability Graph | Decision boundaries + lifecycle governance |
+| V10.x   | 11 Super-Skills           | V10.2 — Confidence Model, Exit Codes, Evidence Format, Compliance |
 
 ---
 
 ## When to bump each segment
 
-### MAJOR (8.x.x → 9.0.0)
+### MAJOR (10.x.x → 11.0.0)
 Breaking changes that require skill/workflow authors to update their files.
 
-```
-✅ Examples:
-- Removing or renaming a required frontmatter field
-- Changing the schema of workflow steps (removing inputs/outputs)
-- Changing exit_codes semantics
-- Architecture restructure that changes file paths
-```
-
-**Gate:** Requires ADR + announcement. All existing skills must be migrated.
-
----
-
-### MINOR (8.0.x → 8.1.0)
+### MINOR (10.2.0 → 10.3.0)
 Backward-compatible additions.
 
 ```
 ✅ Examples:
 - Adding a new skill
 - Adding a new workflow
-- Adding a new optional frontmatter field
+- Adding a new reference file
 - Adding a new rule to rules/
-- Adding a new example or validated learning
 ```
 
 **Gate:** No migration required. Existing skills remain valid.
 
----
-
-### PATCH (8.0.0 → 8.0.1)
-Backward-compatible fixes and improvements.
-
-```
-✅ Examples:
-- Fixing a typo in SKILL.md body
-- Improving description or explanation
-- Adding an example to an existing skill
-- Updating triggers list with additional keywords
-- Fixing a broken link in docs
-```
-
-**Gate:** No review required. Direct commit.
+### PATCH (10.2.0 → 10.2.1)
+Fixes that don't change behavior.
 
 ---
 
-## Who can bump versions?
-
-| Type | Who | Process |
-|---|---|---|
-| MAJOR | Architect (human) | ADR + PR + migration plan |
-| MINOR | Skill author | PR with description |
-| PATCH | Anyone | Direct commit OK |
+## V10.2 Migration Notes
 
----
-
-## Registry versioning
+All skill files, rule files, and workflow files MUST have version `10.2.0` in frontmatter.
 
-`registry/skills-index.yml` is a **generated file**. Its version tracks the knowledge system version, not the registry format.
+### New Required Sections in Every SKILL.md:
+- `## Mô Hình Độ Tin Cậy (Confidence Model)`
+- `## Thoái Ra Mã (Exit Codes)`
+- `## Bằng Chứng Định Dạng (Evidence Format)`
+- `## Compliance`
 
-It is regenerated whenever any SKILL.md is modified. **Never manually edit it.**
+### Registry Files:
+- `graph.json` and `index.yaml` — generated by `node tooling/build-registry.js`
+- Old files (`capability-graph.yml`, `skills-index.yml`) — REMOVED in V10
 
 ---
 
-## Learning lifecycle versioning
-
-Learnings do not follow semver. They follow a lifecycle:
+## Validation Commands
 
+```bash
+npm run test:registry   # Validate all skills + rebuild registry
+npm run test:graph      # Validate graph integrity
+npm run lint            # Validate individual skill structure
 ```
-draft/ → validated/ → deprecated/
-```
-
-- `draft/`: Created automatically or by human. Not yet reviewed.
-- `validated/`: Requires human commit with `[validated]` in message + evidence field filled.
-- `deprecated/`: Superseded by newer evidence. Keep for historical reference.