ai-developer-skill-os 3.1.5 → 6.0.0-rc1

package/README.md

@@ -1,32 +1,28 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v4.0
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v6.0
 
-> Một hệ điều hành (AI-OS) và Nền tảng Kiến trúc Kỹ thuật (Engineering Platform) tối thượng dành cho AI Coding Agents (Claude Code, Cursor, Windsurf, Gemini, Kilo).
+> **Rule-Skins v6 is a Behavior Specification Format (BSF), not a prompt library, not an agent framework, and not a programming language. It defines reusable behavioral contracts that can be interpreted by different AI runtimes while remaining implementation-agnostic.**
 
-Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những prompt cồng kềnh, **AI Developer Skill OS v4.0** được thiết kế lại hoàn toàn theo chuẩn **Enterprise-ready Agentic Framework**. Nó biến Agent của bạn thành một **Senior Engineer / Chief Architect** thực thụ với khả năng tự suy luận bằng Tiếng Anh, nhưng lại báo cáo thân thiện bằng Tiếng Việt.
+Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những prompt cồng kềnh, **Rule-Skins v6** được tái thiết kế hoàn toàn theo chuẩn **Behavior Specification Format**. Các hành vi (Behaviors) giờ đây là các bản Hợp đồng (Contracts) rõ ràng, bao gồm Policies, Capabilities, và Reasoning Boundaries.
 
 ---
 
-## 🏗️ Kiến Trúc 5 Tầng (The 5-Tier Architecture)
+## 🏗️ Kiến Trúc 5 Tầng (Agent OS Kernel)
 
-Hệ thống được thiết kế decoupled (phân tách) hoàn hảo để chống tràn Context Window và tối ưu khả năng suy luận của LLM:
+Hệ thống được thiết kế decoupled hoàn hảo:
 
-### 1. OS Kernel (`.agents/AGENTS.md`)
-The core of the system is a lightweight, heavily optimized OS Kernel that dictates agent behavior across all tasks.
-- **Intent-Based Policies:** Skills are classified into 4 groups (Static Analysis, Development, Validation, Maintenance) rather than micromanaged with individual exceptions.
-- **Progressive Evidence Collection:** Agents collect context incrementally (1 file → 3 files) and stop at a 80% Confidence Threshold, eliminating "hallucination loops".
-- **Risk-based Verification:** Tests and builds are only run based on the risk level of the change, strictly guided by the Cost and Escalation policies.
+### 1. BSF Kernel (`framework/KERNEL.md`)
+Trái tim của hệ thống định nghĩa BSF Meta-Model, OS Policy (Invariants), Knowledge Layer, Validation Rules, và Design Principles.
 
-### 2. Core Templates (`templates/`)
-Chứa các format báo cáo chuẩn (như `bug-report.md`, `feature-report.md`, `review-report.md`). AI không cần "học lại" cách viết báo cáo, giúp đầu ra luôn nhất quán 100%.
+### 2. Thư Viện Độc Lập (Library Modules)
+- `framework/bias-library/`: Sửa các lỗi tư duy mặc định của AI.
+- `framework/dial-library/`: Định nghĩa các cấu hình điều khiển hành vi.
+- `framework/rule-library/`: Các tiêu chí xuất xưởng bắt buộc.
 
-### 3. Skill Definition (`skills/`)
-Bộ 20+ kỹ năng (Skills) cốt lõi được cấu trúc siêu chuẩn xác với **Metadata 12 trường** (Version, Category, Pipeline, Allowed Tools...). Toàn bộ SOP (Standard Operating Procedure), Decision Tree và Constraints được viết 100% bằng Tiếng Anh để tối ưu hóa khả năng hiểu kỹ thuật của AI.
+### 3. Behavior Specifications (`skills/`)
+Bộ 23 Behavior cốt lõi được cấu trúc theo chuẩn BSF (`_template/BEHAVIOR_SPEC.md`). Toàn bộ logic nội bộ được quy hoạch thành các Contracts (Quyền hạn), Policies (Quyết định, Bằng chứng) và Protocol (State Machine tùy chọn).
 
-### 4. Knowledge Library (`knowledge/`)
-Tri thức chuyên sâu được tách rời hoàn toàn khỏi Prompt. Ví dụ: Kiến thức về React (`knowledge/frontend/react.md`) chỉ được gọi (On-demand RAG) khi AI thực sự làm việc với React.
-
-### 5. Output Format (Vietnamese Report)
-Toàn bộ kết quả trả về cho bạn đều tuân thủ Output Policy: Báo cáo bằng Tiếng Việt, chia mục rõ ràng (Summary, Changes, Root Cause, Risks, Next Actions).
+### 4. Output Contract (Decision Summary)
+Toàn bộ kết quả trả về cho bạn đều tuân thủ Output Contract: Báo cáo bằng Tiếng Việt, bảo đảm Invariants, và vượt qua các Quality Gates.
 
 ---
 

package/_template/BEHAVIOR_SPEC.md

@@ -0,0 +1,96 @@
+---
+name: qk-[tên-behavior]
+version: 6.0.0
+updated: 2026-07-10
+description: Behavior Specification theo chuẩn BSF v6.0.
+---
+
+# 📜 Behavior Specification: [Tên Behavior]
+
+## 1. Behavior (Định danh Hành vi)
+```yaml
+Mission: [Mục tiêu tối thượng của hành vi này]
+Authority: [Thẩm quyền tối đa được phép]
+Responsibility: [Trách nhiệm cốt lõi]
+Limitation: [Giới hạn tuyệt đối không được vượt qua]
+```
+
+## 2. Contracts (Hợp đồng)
+
+### 2.1. Capability Contract
+```yaml
+Can:
+  - [Hành động được phép: VD - read_docs, execute_tests]
+Must:
+  - [Hành động bắt buộc: VD - verify assumptions before coding]
+Cannot:
+  - [Hành động cấm: VD - invent API, drop database]
+```
+
+### 2.2. Output Contract
+```yaml
+Artifacts:
+  - [Artifact 1: VD - plan.md]
+  - [Artifact 2: VD - summary_report]
+Completion: "Artifacts generated & Quality Gates passed."
+```
+
+## 3. Policies (Chính sách)
+
+### 3.1. Context Policy
+```yaml
+Scope: [current_repo | whole_workspace | external_docs]
+Priority:
+  1: Project Docs
+  2: Current Conversation
+  3: Source Code
+Trust: "official docs > code > assumptions"
+Fallback: ask_user
+```
+
+### 3.2. Reasoning Boundary
+```yaml
+May infer: [VD: Variable naming, Local scope logic]
+Must verify: [VD: Business logic, Auth rules]
+Must ask: [VD: Missing edge cases, Vague requirements]
+Must refuse: [VD: Unsafe assumptions, Security risks]
+```
+
+### 3.3. Decision Policy
+```yaml
+Priority:
+  1: correctness
+  2: safety
+  3: maintainability
+  4: performance
+```
+
+### 3.4. Evidence Policy
+```yaml
+Accept: [logs, unit tests, profiling data]
+Prefer: [official vendor docs, architecture repo docs]
+Reject: [guess, outdated internet search, agent memory]
+```
+
+### 3.5. Escalation Policy
+```yaml
+Warning: [Cảnh báo rủi ro (VD: Rename file)]
+Confirmation: [Cần user cho phép (VD: Override config)]
+Stop: [Dừng ngay lập tức (VD: Đụng vào Auth, Permission Denied)]
+```
+
+## 4. Protocol (Tùy chọn)
+*(Chỉ sử dụng nếu behavior này yêu cầu quy trình nhiều bước (State Machine). Xóa phần này nếu không cần thiết).*
+
+```yaml
+States:
+  - collect_context
+  - clarify
+  - execute
+
+Transitions:
+  collect_context:
+    if context_missing: -> clarify
+    else: -> execute
+  # ... (Các rule chuyển trạng thái khác) ...
+```

package/docs/GOVERNANCE.md

@@ -30,7 +30,7 @@ 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 v5.0.0):** Breaking changes to the Kernel (`AGENTS.md`), Metadata Contract (`SPEC.md`), or fundamental routing.
+- **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.
 

package/fix_seeds.js

@@ -0,0 +1,22 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml'); // Note: might not be installed
+
+const skillsDir = 'd:\\ai-code-skin-mcp\\rules-skill\\skills';
+const seeds = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-access-policy', 'qk-engineering-standard', 'qk-context-loader', 'qk-orchestrator'];
+
+seeds.forEach(seed => {
+  const specPath = path.join(skillsDir, seed, 'BEHAVIOR_SPEC.md');
+  const skillPath = path.join(skillsDir, seed, 'SKILL.md');
+  if (fs.existsSync(specPath)) {
+    const raw = fs.readFileSync(specPath, 'utf8');
+    // Using simple string parsing since js-yaml might not be available
+    let md = ---\nname:  + seed + \nversion: 6.0.0\n---\n\n;
+    md += #  + seed + \n\n;
+    md += This file follows the 6-Field Minimal Core v6 architecture.\n\n;
+    md += raw;
+    fs.writeFileSync(skillPath, md);
+    fs.unlinkSync(specPath);
+    console.log('Fixed', seed);
+  }
+});

package/framework/KERNEL.md

@@ -0,0 +1,83 @@
+# 📘 Behavior Specification Format (BSF) - Kernel v6.0
+
+> **Rule-Skins v6 is a Behavior Specification Format.**
+> BSF không phải thư viện prompt, không phải agent framework. 
+> BSF định nghĩa **Behavioral Constraints** (Ràng buộc hành vi) thay vì cố gắng chỉ dạy AI "phải làm gì".
+
+---
+
+## 🧭 1. Kernel Principles (Nguyên tắc Hạt nhân)
+
+Đây là 5 nguyên tắc tối thượng chi phối toàn bộ kiến trúc Rule-Skins v6.
+
+1. **Every field must have observable behavioral effect:** Bất kỳ trường nào trong đặc tả hành vi cũng phải tạo ra sự thay đổi có thể quan sát được trong hành vi của agent. Nếu không, nó là nhiễu (noise) và phải bị xóa.
+2. **Behavior specifications describe constraints, not implementation:** BSF định nghĩa phạm vi, giới hạn, ưu tiên và đầu ra. Cách suy luận và lên kế hoạch được nhường lại cho LLM tự tối ưu.
+3. **Optional artifacts are created only when they provide long-term value:** `DESIGN.md`, `RATIONALE.md` hay thư mục `specs/` chỉ được tạo ra khi độ phức tạp của hành vi đòi hỏi. Đừng tạo các file/thư mục rỗng.
+4. **The kernel defines vocabulary, not mandatory document structure:** `KERNEL.md` định nghĩa từ vựng (Minimal Core), không ép buộc một cấu trúc file cứng ngắc. Skill nào cần trường nào thì dùng trường đó.
+5. **Schema evolves only from migration evidence, never from speculation:** Kernel và Schema chỉ được cập nhật khi có bằng chứng thực tế từ quá trình thiết kế các hành vi mới, tuyệt đối không suy đoán trước.
+
+---
+
+## 💎 2. Minimal Core Vocabulary
+
+Thay vì một schema cố định, BSF cung cấp bộ từ vựng lõi. Mỗi `BEHAVIOR_SPEC.md` có thể chọn lọc sử dụng:
+
+- **`metadata`**: Định danh phục vụ tooling, con người và registry.
+- **`scope`**: Thiết lập ranh giới (Ví dụ: "Existing defects only" để ngăn AI code thêm tính năng mới).
+- **`constraints`**: Chứa các semantic rules `must` và `must_not` (Các ràng buộc bắt buộc tuân thủ).
+- **`policies`**: Chứa các `prefer` và `trade-offs` (Hướng dẫn AI chọn đường đi khi có nhiều lựa chọn hợp lệ).
+- **`escalation`**: Kích hoạt điều kiện "Dừng và Hỏi" hoặc "Từ chối".
+- **`output`**: Quy định định dạng artifact phải trả về.
+
+---
+
+## 🛡️ 3. OS-Level Invariants (Luật Bất biến)
+
+Dưới đây là các ràng buộc áp dụng cho mọi skill mà không cần khai báo lại:
+
+```yaml
+OS_Invariants:
+  Security:
+    never:
+      - guess_passwords
+      - hardcode_secrets
+      - bypass_auth
+  UX_Interaction:
+    never:
+      - expose_internal_contract
+      - expose_internal_policy
+      - expose_internal_reasoning
+      - quote_yaml_sections
+    must:
+      - communicate_like_senior_engineer
+      - ask_only_necessary_questions
+      - explain_decisions_in_user_language
+```
+
+---
+
+## 📁 4. Kiến trúc Thư mục (v6)
+
+```text
+rules-skill/
+├── framework/
+│   ├── KERNEL.md (Bộ luật lõi)
+│   └── behavior-patterns.md (Lưu trữ các mẫu hành vi nguyên thủy)
+└── skills/ (Tập hợp các Behavior Specification)
+    ├── qk-help/
+    │   └── BEHAVIOR_SPEC.md (Skill đơn giản chỉ cần 1 file)
+    └── qk-bug-resolution/
+        ├── BEHAVIOR_SPEC.md
+        ├── RATIONALE.md (Lưu trữ tri thức thiết kế)
+        └── specs/ (Kịch bản kiểm chứng tự đóng gói)
+            └── login-failed.yaml
+```
+
+---
+
+## 🚀 5. Definition of Done (Cho một Skill)
+
+Một skill được xem là đã hoàn thành quy trình BSF v6 khi:
+1. Có `BEHAVIOR_SPEC.md` với các trường có tác động hành vi rõ rệt.
+2. Nếu phức tạp, có thêm `RATIONALE.md` giải thích lý do thiết kế.
+3. Nếu cần test, có các file `.yaml` chứa kịch bản và kỳ vọng khép kín trong `specs/`.

package/framework/bias-library/cosmetic-refactor.md

@@ -0,0 +1,21 @@
+---
+id: cosmetic-refactor
+type: bias
+description: LLM frequently rename variables or restructures code purely for aesthetic reasons without architectural improvement.
+---
+
+Detection:
+- Did I only rename variables (e.g. `data` to `userData`)?
+- Did I fail to split God Objects or reduce coupling?
+
+Risk:
+- High noise in Git diffs.
+- Low return on investment (ROI).
+- Potential regression for zero architectural gain.
+
+Correction:
+- Reject cosmetic-only changes.
+- Focus strictly on decoupling, dependency injection, or SOLID violations.
+
+Evidence:
+- Explain explicitly why the new structure scales better or is more decoupled.

package/framework/bias-library/enterprise-crud.md

@@ -0,0 +1,21 @@
+---
+id: enterprise-crud
+type: bias
+description: LLM suggests overly complex architectures (Kafka, Redis, Microservices) for simple CRUD operations.
+---
+
+Detection:
+- Did I introduce message queues, caching layers, or gRPC for a simple REST API?
+- Did I split a simple app into multiple microservices?
+
+Risk:
+- Severe over-engineering.
+- Unnecessary infrastructure costs.
+- Reduced maintainability for small teams.
+
+Correction:
+- Default to Monolith + PostgreSQL.
+- Only introduce caching or queues if a specific bottleneck is identified by evidence.
+
+Evidence:
+- Must provide exact metrics or requirements that justify the complex architecture.

package/framework/bias-library/fake-ui-slop.md

@@ -0,0 +1,20 @@
+---
+id: fake-ui-slop
+type: bias
+description: LLM draws fake charts, images, or dashboard UI elements using generic div blocks instead of integrating real assets.
+---
+
+Detection:
+- Did I use `<div class="bg-blue-500 w-full h-32">Fake Chart</div>`?
+- Did I forget to add placeholders for real images?
+
+Risk:
+- Unprofessional UI design.
+- Technical debt for the frontend developer.
+
+Correction:
+- Insert a comment like `<!-- TODO: Insert real image -->`.
+- Use high-quality placeholder services (e.g., picsum).
+
+Evidence:
+- Highlight the exact placeholder used.

package/framework/bias-library/hallucinated-tools.md

@@ -0,0 +1,20 @@
+---
+id: hallucinated-tools
+type: bias
+description: LLM invents APIs, tools, or shell commands that do not exist in the current environment.
+---
+
+Detection:
+- Did I attempt to call a CLI tool without verifying it is installed?
+- Did I invent a non-existent method on a standard library?
+
+Risk:
+- Execution failure.
+- Broken workflows.
+
+Correction:
+- Verify tools and APIs before using them.
+- Stick to standard, known commands.
+
+Evidence:
+- Provide documentation or link to the specific tool usage.

package/framework/bias-library/missing-ui-states.md

@@ -0,0 +1,19 @@
+---
+id: missing-ui-states
+type: bias
+description: LLM writes frontend components assuming the "happy path" only, ignoring Loading, Error, and Empty states.
+---
+
+Detection:
+- Did I write a fetch component without a loading spinner?
+- Did I forget to handle the case where the data array is empty?
+
+Risk:
+- Poor user experience.
+- UI crashes on undefined data.
+
+Correction:
+- Always implement Loading, Error, and Empty states for any asynchronous UI component.
+
+Evidence:
+- Point to the conditional rendering logic.

package/framework/bias-library/over-indexing.md

@@ -0,0 +1,20 @@
+---
+id: over-indexing
+type: bias
+description: LLM recommends adding database indexes to every column to "improve performance", ignoring write penalties.
+---
+
+Detection:
+- Did I suggest indexing a column with low cardinality (e.g., boolean status)?
+- Did I suggest indexing multiple columns without analyzing query patterns?
+
+Risk:
+- Slower INSERT/UPDATE operations.
+- Increased database storage costs.
+
+Correction:
+- Only recommend indexes for Foreign Keys or heavily filtered/sorted columns.
+- Suggest resolving N+1 queries first.
+
+Evidence:
+- Provide the exact slow query that justifies the index.

package/framework/bias-library/swallow-errors.md

@@ -0,0 +1,19 @@
+---
+id: swallow-errors
+type: bias
+description: LLM wraps code in a try/catch block but leaves the catch block empty or just logs to console, effectively hiding fatal errors.
+---
+
+Detection:
+- Did I write `catch (e) { console.error(e) }` without throwing or returning an error state?
+- Did I fail to surface the error to the UI?
+
+Risk:
+- Silent failures.
+- Extremely difficult debugging.
+
+Correction:
+- Always handle the error gracefully (e.g., return a unified error object or show a toast notification).
+
+Evidence:
+- Point to the specific error handling logic.

package/framework/bias-library/ui-only-security.md

@@ -0,0 +1,17 @@
+---
+id: ui-only-security
+type: bias
+description: LLM hides a button on the UI for unauthorized users but forgets to secure the backend API endpoint.
+---
+
+Detection:
+- Did I add a role check in the React component but not in the Node.js controller?
+
+Risk:
+- Critical security vulnerability (users can bypass UI and hit the API directly).
+
+Correction:
+- Security must always be enforced at the Backend/API layer first. UI hiding is just for UX.
+
+Evidence:
+- Point to the backend middleware or controller where the permission is checked.

package/framework/decision-primitives.md

@@ -0,0 +1,47 @@
+# 🧩 Bảng Tuần Hoàn: Decision Primitives (v6.0)
+
+Rule-Skins v6 không coi các Agent là những "con người ảo" (Personas), mà coi chúng là những **Cỗ máy Ra Quyết định (Decision Engines)**.
+Mọi hành vi phức tạp của bất kỳ Agent nào trong hệ thống đều được cấu thành từ sự lắp ghép của **6 Decision Primitives** cốt lõi dưới đây.
+
+---
+
+## 1. 🧲 Collect (Thu thập)
+- **Bản chất:** Đi tìm kiếm thông tin, tải bối cảnh từ bên ngoài vào bộ nhớ.
+- **Trigger:** Thiếu context hoặc nhận một task yêu cầu đọc dữ liệu.
+- **Evidence Required:** Quyền truy cập repository, cấu trúc file, URL.
+- **Ví dụ Skills:** `qk-context-loader`, bước đầu của `qk-bug-resolution`.
+
+## 2. 🩺 Diagnose (Chẩn đoán)
+- **Bản chất:** Phân tích một triệu chứng (symptom) dựa trên bằng chứng để tìm ra nguyên nhân gốc rễ (root cause).
+- **Trigger:** Có lỗi (Bug report, error log, test failure).
+- **Evidence Required:** Stack trace, logs, test output.
+- **Ví dụ Skills:** `qk-bug-resolution`, `qk-project-health`.
+
+## 3. 🗺️ Plan (Lập Kế hoạch)
+- **Bản chất:** Vạch ra một lộ trình các bước cần làm trước khi trực tiếp nhúng tay vào việc.
+- **Trigger:** Yêu cầu một tính năng mới hoặc một nhiệm vụ quá phức tạp để làm một bước.
+- **Evidence Required:** Yêu cầu (Requirements), Specs, Architecture.
+- **Ví dụ Skills:** `qk-feature-delivery`, `qk-api-lifecycle`.
+
+## 4. ⚖️ Evaluate (Đánh giá)
+- **Bản chất:** Đối chiếu một sản phẩm (artifact) có sẵn với một tiêu chuẩn (standard/policy) để đưa ra phán quyết (Pass/Fail) hoặc gợi ý sửa đổi.
+- **Trigger:** Một đoạn code mới, một bản thiết kế, một PR.
+- **Evidence Required:** Artifact cần review, Guidelines, Linter rules.
+- **Ví dụ Skills:** `qk-engineering-standard`, `qk-validation-gate`, `qk-ui-audit`.
+
+## 5. 🛠️ Execute (Thực thi)
+- **Bản chất:** Trực tiếp sửa đổi trạng thái hệ thống (viết code, xóa file, sửa file).
+- **Trigger:** Đã có kế hoạch rõ ràng hoặc đã xác định xong lỗi.
+- **Evidence Required:** Codebase hiện tại, Kế hoạch.
+- **Ví dụ Skills:** `qk-feature-delivery` (bước sau), `qk-design-to-code`.
+
+## 6. 🚦 Delegate / Govern (Điều phối / Quản trị)
+- **Bản chất:** Không trực tiếp làm việc, mà làm nhiệm vụ định tuyến (routing) công việc cho Agent khác hoặc kiểm soát quyền (deny/allow) dựa trên luật lệ.
+- **Trigger:** Nhận task không thuộc chuyên môn, hoặc nhận yêu cầu xác thực quyền hạn.
+- **Evidence Required:** Danh sách các Skills khác, Policies (RBAC/ABAC).
+- **Ví dụ Skills:** `qk-orchestrator`, `qk-access-policy`.
+
+---
+
+> **Nguyên tắc Thiết kế Hệ thống:** 
+> Khi tạo một Skill mới, đừng cố gắng mô tả "tính cách" của nó. Hãy tự hỏi: *Nó cần dùng những Primitives nào để hoàn thành nhiệm vụ?*

package/framework/dial-library/complexity-budget.md

@@ -0,0 +1,13 @@
+---
+id: complexity-budget
+type: dial
+description: Defines the ceiling for architectural and code complexity.
+---
+
+Levels:
+- **Level 1 (Prototype):** Hardcode data, skip tests, minimal validation. Goal is highest speed.
+- **Level 5 (Standard):** Monolith, basic SQL/ORM, Zod validation, essential error states.
+- **Level 10 (Enterprise):** Event-driven architecture, CQRS, strict rate limiting, 100% test coverage.
+
+Usage:
+- The AI must infer the current budget based on the Project Scale (MVP vs Enterprise) and stick to it. Never exceed the budget.

package/framework/dial-library/granularity.md

@@ -0,0 +1,13 @@
+---
+id: granularity
+type: dial
+description: Defines the level of detail for access control policies.
+---
+
+Levels:
+- **Level 1 (Coarse):** Role-based (Admin vs User).
+- **Level 5 (Fine-grained):** Attribute-based (Owner of the resource).
+- **Level 10 (Micro):** Field-level permissions (Can edit Title but not Price).
+
+Usage:
+- Adjust based on the project scale. For MVP, stick to Level 1.

package/framework/dial-library/optimization-strategy.md

@@ -0,0 +1,13 @@
+---
+id: optimization-strategy
+type: dial
+description: Defines the approach to database and performance optimization.
+---
+
+Levels:
+- **Level 1 (Query Fixes):** Resolve N+1 issues and add basic indexes.
+- **Level 5 (Caching):** Introduce Redis or Memcached for heavy read paths.
+- **Level 10 (Architecture):** CQRS, Read Replicas, Sharding.
+
+Usage:
+- Start at Level 1. Never jump to Level 5 or 10 without explicit bottleneck evidence.

package/framework/dial-library/strictness.md

@@ -0,0 +1,13 @@
+---
+id: strictness
+type: dial
+description: Defines how rigidly the AI enforces patterns and rules.
+---
+
+Levels:
+- **Level 1 (Lenient):** Fix only syntax errors and fatal bugs. Ignore bad architecture.
+- **Level 5 (Balanced):** Suggest improvements but don't rewrite entire files.
+- **Level 10 (Draconian):** Fail immediately on any Linter warning. Enforce strict SOLID principles.
+
+Usage:
+- Adjust based on the user's intent. If they just want a quick fix, lower the strictness. If they ask for an audit, raise it.

package/framework/rule-library/delegation-only.md

@@ -0,0 +1,9 @@
+---
+id: delegation-only
+type: rule
+description: Restricts the skill from making direct system modifications.
+---
+
+Condition:
+- The skill must ONLY plan, analyze, and dispatch instructions to sub-skills.
+- It must NEVER write code, execute CLI commands, or modify files directly.

package/framework/rule-library/minimal-diff.md

@@ -0,0 +1,9 @@
+---
+id: minimal-diff
+type: rule
+description: Ensure the smallest possible change footprint.
+---
+
+Condition:
+- Must only modify lines directly related to the task.
+- Reformatting, restructuring, or touching unrelated files is strictly forbidden.