ai-developer-skill-os 9.3.0 → 9.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "manifest_version": "8.2",
4
- "generated_at": "2026-09-14T04:44:28.302Z",
4
+ "generated_at": "2026-09-14T04:59:07.120Z",
5
5
  "nodes": {
6
6
  "qk-access-policy": {
7
7
  "path": ".agents/skills/qk-access-policy",
@@ -2,7 +2,7 @@
2
2
  # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
3
3
  schema_version: 1
4
4
  manifest_version: '8.2'
5
- generated_at: '2026-09-14T04:44:28.305Z'
5
+ generated_at: '2026-09-14T04:59:07.121Z'
6
6
  stats:
7
7
  total_scanned: 34
8
8
  active: 29
package/CHANGELOG.md CHANGED
@@ -5,6 +5,44 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
5
5
 
6
6
  ---
7
7
 
8
+ ## [9.3.1] — 2026-09-14 — EDAOS v9.3: SSOT Trigger Discipline, Full-Body Execution & Complete Documentation
9
+
10
+ ### Added
11
+ - **Complete v9.3 Documentation Sync**: Updated `README.md` and `CHANGELOG.md` with comprehensive architectural documentation, active skill breakdown, and governance notes.
12
+ - **SSOT 2-Clause Trigger Standard**: Implemented Anthropic 2-clause standard across all 29 active skills (`qk-*`). Clause 1 defines primary responsibility; Clause 2 defines explicit trigger intents including colloquial Vietnamese triggers ("kể cả khi chỉ nói...").
13
+ - **Closed-Loop 4-Tier Body Architecture**: Completed full execution body across all 29 active skills (Preconditions, In/Out-of-Scope boundaries, Step-by-step pipeline, Role-aware Prompt Templates & Command argument specs).
14
+ - **Direct Terminal Visual Rendering**: Enforced Unicode/ASCII Box Drawing for architectural diagrams, sequence flows, and decision trees directly in terminal output (GEMINI.md).
15
+ - **Vitest Isolation Engine**: Added isolated `vitest.config.js` ignoring external IDE worktrees (`.kilo/`) for fast (<1s) 10/10 test suite execution.
16
+
17
+ ### Changed
18
+ - **Boundary Disambiguation**: Resolved trigger overlaps between paired skills:
19
+ - `qk-project-audit` (pre-code gap analysis & feasibility) vs `qk-project-health` (code smells & technical debt audit of running codebase).
20
+ - `qk-ui-audit` (visual consistency & 57-check anti-slop) vs `qk-web-quality-gate` (WCAG a11y, performance, lighthouse).
21
+ - `qk-access-policy` (RBAC/ABAC & auth middleware) vs `qk-security-audit` (OWASP scan & vulnerability detection).
22
+ - **Skill Restructuring & Governance**:
23
+ - Archived `qk-frontend-architecture` and `qk-agent-observability` with deprecation paths.
24
+ - Relocated `qk-engineering-standard` to Behavior Policy Rule (`.agents/rules/coding.md`).
25
+ - Relocated `qk-validation-gate` to Eval Pipeline Engine (`evals/runner.js`).
26
+ - Preserved 3 legacy v9.1 skills (`qk-fe-api-integration`, `qk-help`, `qk-system-evolution`) for zero-breaking backward compatibility.
27
+
28
+ ---
29
+
30
+ ## [9.2.0] — 2026-09-11 — EDAOS v9.2: Role-Aware Execution & Semantic Naming
31
+
32
+ ### Added
33
+ - **DEV_PROFILE.md**: Project-level role and stack context file automatically loaded at session start.
34
+ - **Role Behavior Matrix**: Added 6 developer profiles (`fe`, `be`, `fullstack`, `data`, `ai-engineer`, `devops`) with focus, depth, and skip guidance.
35
+ - **Role-Aware Prompt Templates**: Integrated role-specific templates in key skills.
36
+
37
+ ### Changed
38
+ - Renamed `qk-fe-api-integration` → `qk-api-consumer`.
39
+ - Renamed `qk-system-evolution` → `qk-upgrade`.
40
+ - Renamed `qk-project-analyst` → `qk-project-audit`.
41
+ - Renamed workflows: `skill-evolution.yml` → `skin-governance.yml`, `research.yml` → `context-discovery.yml`.
42
+ - Deprecated and removed legacy `qk-help` in favor of `qk-orchestrator`.
43
+
44
+ ---
45
+
8
46
  ## [9.0.0] — 2026-08 — EDAOS v9.0: Universal Project Knowledge V1 & Dual-Mode Memory Architecture
9
47
 
10
48
  ### Added
package/README.md CHANGED
@@ -1,11 +1,13 @@
1
- # AI Developer Skill OS v9.2.0
1
+ # AI Developer Skill OS v9.3.1
2
2
 
3
- > **v9.2.0 "EDAOS v9.2 — Role-Aware Execution & Semantic Naming"**
3
+ > **v9.3.1 "EDAOS v9.3 — SSOT Trigger Discipline, 4-Tier Execution & Visual Terminal Rendering"**
4
4
 
5
- Phiên bản **v9.2.0** tập trung vào 3 nâng cấp cốt lõi:
6
- 1. **Role-Aware Execution** — AI tự động điều chỉnh chiều sâu phân tích theo role khai báo trong `DEV_PROFILE.md`
7
- 2. **Semantic Naming** — Đổi tên skills, workflows theo đúng mục đích thực tế, loại bỏ tên trừu tượng
8
- 3. **Prompt Templates theo Role** — Mỗi skill có examples cụ thể cho từng role (fe/be/fullstack/data/ai-engineer/devops)
5
+ Phiên bản **v9.3.0** mang đến 5 nâng cấp chuẩn mực kỹ thuật toàn diện cho hệ điều hành AI coding agent:
6
+ 1. **SSOT 2-Clause Trigger Standard (Anthropic Standard)** — Đồng bộ 100% mô tả kích hoạt theo cấu trúc 2 vế (Năng lực cốt lõi + Cụm từ/ngữ cảnh kích hoạt thực tế) trên cả Frontmatter `SKILL.md`, danh sách `triggers` và Quick Table routing trong `.agents/AGENTS.md`.
7
+ 2. **Full-Body 4 Tầng Khép Kín (Closed-loop Body Structure)** — Toàn bộ 29 active skills được trang bị đầy đủ 4 tầng nội dung: Preconditions, Scope (In/Out-of-scope), Pipeline thực thi từng bước, và Prompt Templates theo Role.
8
+ 3. **Phân định ranh giới kỹ thuật (Boundary Disambiguation)** — Loại bỏ hoàn toàn sự chồng lấn/mơ hồ giữa các cặp kỹ năng (`qk-project-audit` vs `qk-project-health`, `qk-ui-audit` vs `qk-web-quality-gate`, `qk-access-policy` vs `qk-security-audit`).
9
+ 4. **Governed Skill Restructuring (29 Active, 2 Archived, 2 Relocated)** — Quy hoạch 29 Active skills, Archive 2 skills (`qk-frontend-architecture`, `qk-agent-observability`), Relocate 2 skills (`qk-engineering-standard` sang rules, `qk-validation-gate` sang eval runner), và bảo toàn 3 legacy skills v9.1.
10
+ 5. **Direct Terminal Visual Rendering (Unicode/ASCII Box Drawing)** — Chuẩn hóa hiển thị trực quan sơ đồ kiến trúc, flowchart trực tiếp ngay trong giao diện terminal.
9
11
 
10
12
  ---
11
13
 
@@ -60,16 +62,17 @@ npx ai-developer-skill-os init --ide=antigravity --scope=2
60
62
 
61
63
  ---
62
64
 
63
- ## Kiến trúc v9.2
65
+ ## Kiến trúc v9.3
64
66
 
65
67
  ```
66
68
  .agents/
67
69
  ├── DEV_PROFILE.md ← Khai báo role + stack (đọc đầu mỗi session)
68
- ├── AGENTS.md ← Entry point: routing table + role behavior matrix
69
- ├── skills/ ← 33 capabilities — mỗi skill có SKILL.md
70
+ ├── AGENTS.md ← Entry point: SSOT routing table + role behavior matrix
71
+ ├── GEMINI.md ← Quy định riêng cho Antigravity (Terminal ASCII Diagrams, etc.)
72
+ ├── skills/ ← 29 active skills (mỗi skill có SKILL.md 4 tầng chuẩn mực)
70
73
  ├── workflows/ ← 10 execution pipelines
71
- ├── rules/ ← 8 behavior policies
72
- ├── registry/ ← Generated indexes (không sửa tay)
74
+ ├── rules/ ← Behavior policies (coding, safety, security, anti-patterns...)
75
+ ├── registry/ ← Generated indexes (index.yaml, graph.json — sinh tự động)
73
76
  ├── knowledge/ ← Design intelligence + domain patterns
74
77
  └── blueprints/ ← Project scaffold templates
75
78
  ```
@@ -80,80 +83,97 @@ npx ai-developer-skill-os init --ide=antigravity --scope=2
80
83
  |---|---|---|
81
84
  | `fe` | Component arch, state, a11y, bundle size | DB schema, backend arch |
82
85
  | `be` | API contract, business logic, DB perf, security | CSS, UI layout |
83
- | `fullstack` | FE+BE end-to-end, type-safe contract | Over-engineering |
86
+ | `fullstack` | FE+BE end-to-end, type-safe contract | Over-engineering, microservices không cần thiết |
84
87
  | `data` | Idempotency, data quality, lineage, SLA | Application ORM, UI |
85
88
  | `ai-engineer` | Prompt eng, RAG arch, eval pipeline, hallucination | Standard CRUD |
86
- | `devops` | CI/CD, IaC, observability, rollback | Business logic, UI |
89
+ | `devops` | CI/CD, IaC, observability, rollback plan | Business logic, UI |
87
90
 
88
91
  ---
89
92
 
90
- ## 33 Skills (v9.2.0)
93
+ ## Danh mục 29 Active Skills (v9.3.0)
91
94
 
92
- ### Core & Orchestration
93
- | Skill | Mô tả |
95
+ ### 1. Core & Orchestration (4 skills)
96
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
94
97
  |---|---|
95
- | `qk-orchestrator` | Route yêu cầu đến đúng skill, kiểm tra preconditions |
96
- | `qk-context-loader` | Load context, vẽ dependency graph trước khi code |
97
- | `qk-project-memory` | Lưu/tra cứu project knowledge (Architecture, Convention, Pattern, Hard Bug) |
98
- | `qk-project-bootstrap` | Khởi tạo dự án mới với Blueprint Plugins (RAG/Coding/Workflow) |
98
+ | `qk-orchestrator` | Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — phân tích intent, kiểm tra preconditions và routing table. |
99
+ | `qk-context-loader` | Khảo sát kiến trúc codebase, phân tích import graph, lập bản đồ phụ thuộc và tải context chính xác trước khi code — ngăn hallucination kiến trúc. |
100
+ | `qk-project-memory` | Quản trị Tri thức và Bộ nhớ dự án (Local Private Mode) — Quản lý tại `.ai-local/` như source code: tự động khởi tạo, bảo mật gitignore, có thể review. |
101
+ | `qk-project-bootstrap` | Khởi tạo dự án mới HOẶC setup `DEV_PROFILE.md` cho dự án đang chạy — auto-detect stack từ manifest files, không hỏi lại những gì đã đọc được. |
99
102
 
100
- ### Product & Architecture
101
- | Skill | Mô tả |
103
+ ### 2. Product & Analysis (2 skills)
104
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
102
105
  |---|---|
103
- | `qk-product-specification` | Idea → Requirement → Acceptance Criteria → Technical Spec |
104
- | `qk-frontend-architecture` | Quyết định kiến trúc FE: component strategy, state, routing |
105
- | `qk-project-audit` | Gap Analysis, Feasibility, Risk Assessment — báo cáo trước khi code |
106
+ | `qk-product-specification` | Tư duy phát triển sản phẩm: biến ý tưởng sơ khai thành yêu cầu kỹ thuật chi tiết (Idea → Requirement → Acceptance Criteria → Technical Spec). |
107
+ | `qk-project-audit` | Phân tích toàn diện dự án: Gap Analysis, Feasibility, Risk Assessment — báo cáo trước khi code. *(Không dùng cho đo lường code smell của code đang chạy)* |
106
108
 
107
- ### Frontend & UI
108
- | Skill | Mô tả |
109
+ > *Ghi chú:* `qk-frontend-architecture` đã được lưu trữ (Archived) — quy hoạch vào `qk-design-system-engineering` và `qk-ui-builder`.
110
+
111
+ ### 3. Frontend & UI (5 skills)
112
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
109
113
  |---|---|
110
- | `qk-ui-builder` | Build/edit/audit/redesign UI từ Figma/ảnh/design reference |
111
- | `qk-ui-system-builder` | Build Design System và token library từ DESIGN.md |
112
- | `qk-design-system-engineering` | Quản trị design system: tokens, component variants, governance |
113
- | `qk-api-consumer` | Consume API (REST/GraphQL/tRPC), manage state, bind vào UI |
114
- | `qk-ui-audit` | Audit UI với 57-check Anti-Slop checklist |
115
- | `qk-web-quality-gate` | A11y, SEO, Web Performance, Security, UX Heuristics |
116
-
117
- ### Backend & Data
118
- | Skill | Mô tả |
114
+ | `qk-ui-builder` | Xây dựng, sửa, audit, và hoàn thiện UI component từ Figma/ảnh/mô tả layout — responsive, chuẩn token, đầy đủ hover/active/loading states. |
115
+ | `qk-ui-system-builder` | Xây dựng Design System và token library từ `DESIGN.md` — không tự đặt ra token ngoài contract. |
116
+ | `qk-design-system-engineering` | Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến thể component, governance). |
117
+ | `qk-api-consumer` | Consume API (REST/GraphQL/tRPC), quản lý State, xử lý loading/error/empty states, bind vào UI — tuân thủ kiến trúc dự án. |
118
+ | `qk-ui-audit` | Kiểm toán chất lượng thiết kế UI với 57-check Anti-Slop checklist: spacing nhất quán, contrast ratio, component polish, interaction states. *(Không dùng cho WCAG a11y hay SEO)* |
119
+
120
+ ### 4. Backend & Data (5 skills)
121
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
119
122
  |---|---|
120
- | `qk-api-lifecycle` | Design + implement API với Zero-Trust — contract trước, code sau |
121
- | `qk-data-lifecycle` | Schema management + safe migrations (freeze → compat → cleanup) |
122
- | `qk-data-engineer` | Data pipelines: dbt, Spark, Airflow, Delta Lake — idempotency first |
123
- | `qk-access-policy` | RBAC/ABAC — định nghĩa role matrix trước, implement middleware sau |
124
- | `qk-db-optimizer` | Evidence-based DB optimization: EXPLAIN → analyze → index |
125
-
126
- ### Engineering & Delivery
127
- | Skill | Mô tả |
123
+ | `qk-api-lifecycle` | Thiết kế và implement API endpoint mới với Zero-Trust — contract trước, code sau. |
124
+ | `qk-data-lifecycle` | Quản lý Schema và Migration cơ sở dữ liệu an toàn — schema freeze, backward-compatible migrations, zero-downtime deployment. |
125
+ | `qk-data-engineer` | Thiết kế và implement data pipeline với best practices: idempotency, data quality gate, lineage, incremental processing. |
126
+ | `qk-access-policy` | Quản lý và thiết lập chính sách phân quyền RBAC/ABAC, định nghĩa permission matrix, sinh auth middleware bảo vệ endpoint. |
127
+ | `qk-db-optimizer` | Tối ưu hiệu năng Database dựa trên bằng chứng kỹ thuật: phân tích EXPLAIN/ANALYZE, phát hiện N+1 queries, thiết kế Index, refactor slow query. |
128
+
129
+ ### 5. Engineering & Delivery (5 skills)
130
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
128
131
  |---|---|
129
- | `qk-feature-delivery` | End-to-end feature: Requirements → Context → Design → Implement |
130
- | `qk-bug-resolution` | Closed-loop bug fix: Observe → Hypothesis → Evidence → Fix |
131
- | `qk-refactor` | Tái cấu trúc code không đổi behavior — extract, simplify, decouple |
132
- | `qk-upgrade` | Nâng cấp library/framework an toàn — incremental, rollback bắt buộc |
133
- | `qk-docs` | Viết/cập nhật docs chính xác tuyệt đối — match code thực tế |
134
-
135
- ### Quality & Testing
136
- | Skill | Mô tả |
132
+ | `qk-feature-delivery` | Phát triển tính năng mới end-to-end: Requirements → Context → Design → Implement → Self-audit. |
133
+ | `qk-bug-resolution` | Sửa lỗi bằng chu trình khép kín: Observe → Hypothesize → Evidence → Fix → Verify. |
134
+ | `qk-refactor` | Tái cấu trúc code để dễ bảo trì, dễ test hơn — không thay đổi external behavior (extract, simplify, decouple). |
135
+ | `qk-upgrade` | Nâng cấp library/framework an toàn — incremental strategy, audit breaking changes, rollback plan bắt buộc. |
136
+ | `qk-docs` | Khởi tạo và duy trì tài liệu kỹ thuật chuẩn xác (README, API docs, architecture guides, JSDoc) — cam kết đồng bộ 100% với code thực tế. |
137
+
138
+ ### 6. Quality & Testing (4 skills)
139
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
137
140
  |---|---|
138
- | `qk-test-engineering` | Test strategy: pyramid, coverage, regression, mock |
139
- | `qk-validation-gate` | Quality gate: linters, tests, scorecard.yaml (0–100) |
140
- | `qk-project-health` | Audit: Code Smells, Tech Debt, Architecture (0–100 score) |
141
- | `qk-code-review` | 4-Phase elite code review với Architect mindset |
142
- | `qk-engineering-standard` | Enforce SOLID, DRY, Clean Code với ngưỡng metric cụ thể |
143
-
144
- ### Security, DevOps & AI
145
- | Skill | Mô tả |
141
+ | `qk-test-engineering` | Thiết kế chiến lược kiểm thử toàn diện và viết bộ test tự động: Test Pyramid (Unit, Integration, E2E), Mocking, Edge cases. |
142
+ | `qk-project-health` | Kiểm toán toàn diện sức khỏe dự án: đo lường Code Smells, Technical Debt, độ phức tạp Cyclomatic, God files, vi phạm SOLID — chấm điểm Health Score (0–100). |
143
+ | `qk-code-review` | Review code, AI config, hoặc skin rules theo 4 phases với Architect mindset — phát hiện bug, security issue, architecture smell. |
144
+ | `qk-web-quality-gate` | Đo lường chất lượng kỹ thuật Web: Accessibility violations (WCAG), Core Web Vitals, Lighthouse score, SEO tags, security headers. |
145
+
146
+ > *Ghi chú:*
147
+ > - `qk-engineering-standard` đã được chuyển vị trí (Relocated) thành **Behavior Policy Rule** tại `.agents/rules/coding.md`.
148
+ > - `qk-validation-gate` đã được chuyển vị trí (Relocated) thành **Eval Pipeline Script** tại `evals/runner.js`.
149
+
150
+ ### 7. Security, DevOps & AI (4 skills)
151
+ | Skill | Mô tả theo chuẩn SSOT (2-clause) |
146
152
  |---|---|
147
- | `qk-security-audit` | OWASP, dependency risk, secret detection, permission model |
148
- | `qk-devops-platform` | CI/CD strategy, deployment architecture, environment management |
149
- | `qk-production-release` | 8-gate mandatory checklist trước khi deploy production |
150
- | `qk-ai-builder` | Governed AI Agent & RAG pipeline design — eval pipeline included |
151
- | `qk-agent-observability` | Monitor AI skin routing decisions, failure patterns |
153
+ | `qk-security-audit` | Audit bảo mật ứng dụng theo OWASP: phát hiện lỗ hổng, secret leak, dependency risk, permission model — xuất report + remediation plan. |
154
+ | `qk-devops-platform` | Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường và chiến lược rollback. |
155
+ | `qk-production-release` | Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy. |
156
+ | `qk-ai-builder` | Thiết kế và implement AI Agent hoặc RAG pipeline với eval criteria bắt buộc. |
157
+
158
+ > *Ghi chú:* `qk-agent-observability` đã được lưu trữ (Archived) — tích hợp theo dõi vào test runner & runtime telemetry.
152
159
 
153
160
  ---
154
161
 
155
162
  ## Changelog
156
163
 
164
+ ### v9.3.1 (2026-09-14) — EDAOS v9.3: Documentation & Governance Release
165
+ - **Đồng bộ toàn diện tài liệu:** Cập nhật `README.md` và `CHANGELOG.md` đầy đủ chuẩn mực v9.3.
166
+ - **SSOT 2-Clause Trigger Standard:** Áp dụng chuẩn Anthropic 2-vế cho toàn bộ 29 active skills, đồng bộ hoàn toàn giữa frontmatter `description`, `triggers` array và Quick Table trong `.agents/AGENTS.md`.
167
+ - **Closed-Loop 4-Tier Execution Body:** Xóa bỏ toàn bộ 22 empty stubs, hoàn thiện đủ 4 phần (Preconditions, Scope, Steps, Prompt Templates).
168
+ - **Boundary Disambiguation:** Phân định ranh giới rõ ràng giữa các cặp skill dễ nhầm lẫn (`qk-project-audit` vs `qk-project-health`, `qk-ui-audit` vs `qk-web-quality-gate`, `qk-access-policy` vs `qk-security-audit`).
169
+ - **Skill Restructuring & Governance:**
170
+ - Quy hoạch 29 Active Skills chính thức.
171
+ - Archive 2 skills: `qk-frontend-architecture`, `qk-agent-observability`.
172
+ - Relocate 2 skills: `qk-engineering-standard` (thành Policy Rule `.agents/rules/coding.md`), `qk-validation-gate` (thành Eval Script `evals/runner.js`).
173
+ - Bảo toàn 3 legacy skills v9.1 (`qk-fe-api-integration`, `qk-help`, `qk-system-evolution`).
174
+ - **Terminal Visual Rendering:** Quy định trong `GEMINI.md` về việc bắt buộc render sơ đồ/kiến trúc trực tiếp bằng Unicode/ASCII box drawing trong terminal.
175
+ - **Vitest Isolation:** Thêm `vitest.config.js`, cô lập runner khỏi IDE worktrees (`.kilo/`), đảm bảo 10/10 test suites pass trong <1s.
176
+
157
177
  ### v9.2.0 (2026-09-11)
158
178
  - **Thêm:** `DEV_PROFILE.md` — role + stack context file, AI đọc đầu mỗi session
159
179
  - **Thêm:** Role Behavior Matrix trong `AGENTS.md` — 6 roles với focus/depth/skip
@@ -178,7 +198,8 @@ npx ai-developer-skill-os init --ide=antigravity --scope=2
178
198
  ## Đánh giá tự động
179
199
 
180
200
  ```bash
181
- npm run test:agent # Routing intelligence tests
182
- npm run test:graph # Capability graph validation
201
+ npm test # Vitest runner (10/10 suites pass isolated)
183
202
  npm run test:registry # Registry consistency check
203
+ npm run test:graph # Capability graph validation
204
+ npm run eval:all # Toàn bộ AI capability eval scorecards
184
205
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-developer-skill-os",
3
- "version": "9.3.0",
3
+ "version": "9.3.1",
4
4
  "description": "EDAOS v9.3 — SSOT Governed Capability Platform with 2-Clause Triggers & Full Technical Lifecycle.",
5
5
  "main": "bin/install.js",
6
6
  "files": [