ai-developer-skill-os 10.1.0 → 10.2.0

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.
Files changed (98) hide show
  1. package/.agents/AGENTS.md +13 -0
  2. package/.agents/LICENSE +21 -21
  3. package/.agents/docs/ARCHITECTURE.md +56 -120
  4. package/.agents/docs/GOVERNANCE.md +3 -3
  5. package/.agents/docs/SPEC.md +137 -60
  6. package/.agents/docs/VERSIONING.md +25 -57
  7. package/.agents/docs/adr/0005-v10-platform-consolidation.md +50 -0
  8. package/.agents/docs/schemas/learning.schema.yml +22 -57
  9. package/.agents/docs/schemas/skill.schema.yml +116 -161
  10. package/.agents/docs/schemas/workflow.schema.yml +51 -26
  11. package/.agents/docs/skill-classification.md +1 -1
  12. package/.agents/registry/graph.json +171 -77
  13. package/.agents/registry/index.yaml +68 -35
  14. package/.agents/rules/coding.md +1 -1
  15. package/.agents/rules/command-safety.md +1 -1
  16. package/.agents/rules/global.md +1 -1
  17. package/.agents/rules/prompt-compiler.md +1 -1
  18. package/.agents/rules/safety.md +1 -1
  19. package/.agents/rules/security.md +1 -1
  20. package/.agents/rules/skill-quality.md +18 -3
  21. package/.agents/skills/_template/SKILL.md +238 -88
  22. package/.agents/skills/qk-api-data-discovery/SKILL.md +176 -190
  23. package/.agents/skills/qk-api-data-discovery/references/bronze-record-format.md +47 -0
  24. package/.agents/skills/qk-api-data-discovery/references/data-contract-yaml.md +72 -0
  25. package/.agents/skills/qk-api-data-discovery/references/discovery-report-template.md +110 -0
  26. package/.agents/skills/qk-backend-data/SKILL.md +150 -1
  27. package/.agents/skills/qk-bug-resolution/SKILL.md +153 -1
  28. package/.agents/skills/qk-bug-resolution/evals/scorecard.yaml +1 -1
  29. package/.agents/skills/qk-code-cleaner/SKILL.md +150 -1
  30. package/.agents/skills/qk-code-review/SKILL.md +195 -1
  31. package/.agents/skills/qk-code-review/evals/scorecard.yaml +1 -1
  32. package/.agents/skills/qk-code-review/references/ai/{v8-schema-validation.md → schema-validation.md} +2 -2
  33. package/.agents/skills/qk-code-review/references/cross-cutting/async-concurrency-patterns.md +515 -515
  34. package/.agents/skills/qk-code-review/references/cross-cutting/error-handling-principles.md +492 -492
  35. package/.agents/skills/qk-code-review/references/cross-cutting/n-plus-one-queries.md +309 -309
  36. package/.agents/skills/qk-code-review/references/cross-cutting/sql-injection-prevention.md +307 -307
  37. package/.agents/skills/qk-code-review/references/cross-cutting/xss-prevention.md +263 -263
  38. package/.agents/skills/qk-code-review/references/languages/angular.md +768 -768
  39. package/.agents/skills/qk-code-review/references/languages/c.md +890 -890
  40. package/.agents/skills/qk-code-review/references/languages/cpp.md +893 -893
  41. package/.agents/skills/qk-code-review/references/languages/css-less-sass.md +661 -661
  42. package/.agents/skills/qk-code-review/references/languages/django.md +985 -985
  43. package/.agents/skills/qk-code-review/references/languages/fastapi.md +580 -580
  44. package/.agents/skills/qk-code-review/references/languages/go.md +993 -993
  45. package/.agents/skills/qk-code-review/references/languages/java.md +409 -409
  46. package/.agents/skills/qk-code-review/references/languages/java8.md +586 -586
  47. package/.agents/skills/qk-code-review/references/languages/kotlin.md +1018 -1018
  48. package/.agents/skills/qk-code-review/references/languages/nestjs.md +593 -593
  49. package/.agents/skills/qk-code-review/references/languages/php.md +684 -684
  50. package/.agents/skills/qk-code-review/references/languages/python.md +1073 -1073
  51. package/.agents/skills/qk-code-review/references/languages/qt.md +757 -757
  52. package/.agents/skills/qk-code-review/references/languages/react.md +871 -871
  53. package/.agents/skills/qk-code-review/references/languages/ruby.md +964 -964
  54. package/.agents/skills/qk-code-review/references/languages/rust.md +846 -846
  55. package/.agents/skills/qk-code-review/references/languages/svelte.md +1064 -1064
  56. package/.agents/skills/qk-code-review/references/languages/swift.md +936 -936
  57. package/.agents/skills/qk-code-review/references/languages/typescript.md +1016 -1016
  58. package/.agents/skills/qk-code-review/references/languages/vue.md +924 -924
  59. package/.agents/skills/qk-code-review/references/languages/zig.md +440 -440
  60. package/.agents/skills/qk-devops-release/SKILL.md +150 -1
  61. package/.agents/skills/qk-feature-delivery/SKILL.md +153 -1
  62. package/.agents/skills/qk-feature-delivery/evals/scorecard.yaml +1 -1
  63. package/.agents/skills/qk-orchestrator/SKILL.md +187 -2
  64. package/.agents/skills/qk-orchestrator/evals/scorecard.yaml +1 -1
  65. package/.agents/skills/qk-orchestrator/references/routing-table.md +1 -1
  66. package/.agents/skills/qk-product-spec/SKILL.md +150 -1
  67. package/.agents/skills/qk-prompt-compiler/SKILL.md +188 -65
  68. package/.agents/skills/qk-ui-engineer/SKILL.md +150 -1
  69. package/.agents/workflows/_schema.yml +146 -146
  70. package/.agents/workflows/bug-resolution.yml +155 -121
  71. package/.agents/workflows/code-review.yml +127 -93
  72. package/.agents/workflows/context-discovery.yml +128 -94
  73. package/.agents/workflows/documentation.yml +124 -90
  74. package/.agents/workflows/feature-delivery.yml +158 -124
  75. package/.agents/workflows/production-release.yml +207 -173
  76. package/.agents/workflows/prompt-compilation.yml +126 -0
  77. package/.agents/workflows/refactor.yml +136 -102
  78. package/.agents/workflows/security-audit.yml +149 -115
  79. package/.agents/workflows/shared/quality-gate.yml +3 -1
  80. package/.agents/workflows/skin-governance.yml +149 -115
  81. package/.agents/workflows/spec-driven-development.yml +78 -71
  82. package/CHANGELOG.md +61 -0
  83. package/README.md +3 -3
  84. package/bin/install.js +38 -51
  85. package/package.json +68 -74
  86. package/tooling/build-registry.js +226 -208
  87. package/tooling/run-aar.js +55 -126
  88. package/tooling/sync-versions.js +2 -2
  89. package/tooling/validate-graph.js +100 -87
  90. package/tooling/validate-skills.js +32 -14
  91. package/.agents/docs/decisions/ADR-001-v8-migration.md +0 -58
  92. package/.agents/docs/decisions/ADR-002-workflow-separation.md +0 -50
  93. package/.agents/docs/decisions/ADR-003-registry-generated.md +0 -54
  94. package/.agents/docs/decisions/ADR-008-skill-boundary-review.md +0 -27
  95. package/.agents/registry/capability-graph.yml +0 -390
  96. package/.agents/registry/skills-index.yml +0 -305
  97. package/.agents/skills/_template/capability.yaml +0 -34
  98. package/.agents/skills/_template/evals/scorecard.yaml +0 -19
@@ -1,186 +1,280 @@
1
1
  {
2
2
  "schema_version": 1,
3
- "manifest_version": "8.2",
4
- "generated_at": "2026-09-15T03:45:16.804Z",
3
+ "manifest_version": "10.2",
4
+ "generated_at": "2026-09-24T06:26:56.070Z",
5
5
  "nodes": {
6
6
  "qk-api-data-discovery": {
7
7
  "path": ".agents/skills/qk-api-data-discovery",
8
- "version": "10.1.0",
8
+ "version": "10.2.0",
9
+ "platforms": [
10
+ "antigravity",
11
+ "claude",
12
+ "opencode"
13
+ ],
9
14
  "tags": [
10
15
  "api",
11
16
  "data",
12
17
  "discovery"
13
18
  ],
14
- "dependencies": [
15
- "context-discovery"
19
+ "dependencies": [],
20
+ "dependents": [
21
+ "qk-orchestrator"
16
22
  ],
17
- "dependents": [],
18
23
  "is_orphan": false
19
24
  },
20
25
  "qk-backend-data": {
21
26
  "path": ".agents/skills/qk-backend-data",
22
- "version": "10.1.0",
27
+ "version": "10.2.0",
28
+ "platforms": [
29
+ "antigravity",
30
+ "claude",
31
+ "opencode"
32
+ ],
23
33
  "tags": [
24
34
  "backend",
25
35
  "data"
26
36
  ],
27
- "dependencies": [
28
- "feature-delivery"
37
+ "dependencies": [],
38
+ "dependents": [
39
+ "qk-orchestrator"
29
40
  ],
30
- "dependents": [],
31
41
  "is_orphan": false
32
42
  },
33
43
  "qk-bug-resolution": {
34
44
  "path": ".agents/skills/qk-bug-resolution",
35
- "version": "10.1.0",
45
+ "version": "10.2.0",
46
+ "platforms": [
47
+ "antigravity",
48
+ "claude",
49
+ "opencode"
50
+ ],
36
51
  "tags": [
37
52
  "bug",
38
53
  "resolution"
39
54
  ],
40
- "dependencies": [
41
- "bug-resolution"
55
+ "dependencies": [],
56
+ "dependents": [
57
+ "qk-orchestrator"
42
58
  ],
43
- "dependents": [],
44
59
  "is_orphan": false
45
60
  },
46
61
  "qk-code-cleaner": {
47
62
  "path": ".agents/skills/qk-code-cleaner",
48
- "version": "10.1.0",
63
+ "version": "10.2.0",
64
+ "platforms": [
65
+ "antigravity",
66
+ "claude",
67
+ "opencode"
68
+ ],
49
69
  "tags": [
50
70
  "code",
51
71
  "cleaner"
52
72
  ],
53
- "dependencies": [
54
- "refactor"
73
+ "dependencies": [],
74
+ "dependents": [
75
+ "qk-orchestrator"
55
76
  ],
56
- "dependents": [],
57
77
  "is_orphan": false
58
78
  },
59
79
  "qk-code-review": {
60
80
  "path": ".agents/skills/qk-code-review",
61
- "version": "10.1.0",
81
+ "version": "10.2.0",
82
+ "platforms": [
83
+ "antigravity",
84
+ "claude",
85
+ "opencode"
86
+ ],
62
87
  "tags": [
63
88
  "code",
64
89
  "review"
65
90
  ],
66
- "dependencies": [
67
- "code-review"
91
+ "dependencies": [],
92
+ "dependents": [
93
+ "qk-orchestrator"
68
94
  ],
69
- "dependents": [],
70
95
  "is_orphan": false
71
96
  },
72
97
  "qk-devops-release": {
73
98
  "path": ".agents/skills/qk-devops-release",
74
- "version": "10.1.0",
99
+ "version": "10.2.0",
100
+ "platforms": [
101
+ "antigravity",
102
+ "claude",
103
+ "opencode"
104
+ ],
75
105
  "tags": [
76
106
  "devops",
77
107
  "release"
78
108
  ],
79
- "dependencies": [
80
- "production-release"
109
+ "dependencies": [],
110
+ "dependents": [
111
+ "qk-orchestrator"
81
112
  ],
82
- "dependents": [],
83
113
  "is_orphan": false
84
114
  },
85
115
  "qk-feature-delivery": {
86
116
  "path": ".agents/skills/qk-feature-delivery",
87
- "version": "10.1.0",
117
+ "version": "10.2.0",
118
+ "platforms": [
119
+ "antigravity",
120
+ "claude",
121
+ "opencode"
122
+ ],
88
123
  "tags": [
89
124
  "feature",
90
125
  "delivery"
91
126
  ],
92
- "dependencies": [
93
- "feature-delivery"
127
+ "dependencies": [],
128
+ "dependents": [
129
+ "qk-orchestrator"
94
130
  ],
95
- "dependents": [],
96
131
  "is_orphan": false
97
132
  },
98
133
  "qk-orchestrator": {
99
134
  "path": ".agents/skills/qk-orchestrator",
100
- "version": "10.1.0",
135
+ "version": "10.2.0",
136
+ "platforms": [
137
+ "antigravity",
138
+ "claude",
139
+ "opencode"
140
+ ],
101
141
  "tags": [
102
142
  "orchestrator"
103
143
  ],
104
- "dependencies": [
105
- "context-discovery"
106
- ],
144
+ "dependencies": [],
107
145
  "dependents": [],
108
146
  "is_orphan": false
109
147
  },
110
148
  "qk-product-spec": {
111
149
  "path": ".agents/skills/qk-product-spec",
112
- "version": "10.1.0",
150
+ "version": "10.2.0",
151
+ "platforms": [
152
+ "antigravity",
153
+ "claude",
154
+ "opencode"
155
+ ],
113
156
  "tags": [
114
157
  "product",
115
158
  "spec"
116
159
  ],
117
- "dependencies": [
118
- "spec-driven-development"
160
+ "dependencies": [],
161
+ "dependents": [
162
+ "qk-orchestrator"
119
163
  ],
120
- "dependents": [],
121
164
  "is_orphan": false
122
165
  },
123
166
  "qk-prompt-compiler": {
124
167
  "path": ".agents/skills/qk-prompt-compiler",
125
- "version": "11.1.0",
168
+ "version": "10.2.0",
169
+ "platforms": [
170
+ "antigravity",
171
+ "claude",
172
+ "opencode"
173
+ ],
126
174
  "tags": [
127
175
  "prompt",
128
176
  "compiler"
129
177
  ],
130
- "dependencies": [
131
- "prompt-compilation"
178
+ "dependencies": [],
179
+ "dependents": [
180
+ "qk-orchestrator"
132
181
  ],
133
- "dependents": [],
134
182
  "is_orphan": false
135
183
  },
136
184
  "qk-ui-engineer": {
137
185
  "path": ".agents/skills/qk-ui-engineer",
138
- "version": "10.1.0",
186
+ "version": "10.2.0",
187
+ "platforms": [
188
+ "antigravity",
189
+ "claude",
190
+ "opencode"
191
+ ],
139
192
  "tags": [
140
193
  "ui",
141
194
  "engineer"
142
195
  ],
143
- "dependencies": [
144
- "feature-delivery"
196
+ "dependencies": [],
197
+ "dependents": [
198
+ "qk-orchestrator"
145
199
  ],
146
- "dependents": [],
147
200
  "is_orphan": false
148
201
  }
149
202
  },
203
+ "edges": [
204
+ {
205
+ "from": "qk-orchestrator",
206
+ "to": "qk-prompt-compiler",
207
+ "relation": "depends_on"
208
+ },
209
+ {
210
+ "from": "qk-orchestrator",
211
+ "to": "qk-product-spec",
212
+ "relation": "depends_on"
213
+ },
214
+ {
215
+ "from": "qk-orchestrator",
216
+ "to": "qk-feature-delivery",
217
+ "relation": "depends_on"
218
+ },
219
+ {
220
+ "from": "qk-orchestrator",
221
+ "to": "qk-bug-resolution",
222
+ "relation": "depends_on"
223
+ },
224
+ {
225
+ "from": "qk-orchestrator",
226
+ "to": "qk-code-cleaner",
227
+ "relation": "depends_on"
228
+ },
229
+ {
230
+ "from": "qk-orchestrator",
231
+ "to": "qk-code-review",
232
+ "relation": "depends_on"
233
+ },
234
+ {
235
+ "from": "qk-orchestrator",
236
+ "to": "qk-ui-engineer",
237
+ "relation": "depends_on"
238
+ },
239
+ {
240
+ "from": "qk-orchestrator",
241
+ "to": "qk-backend-data",
242
+ "relation": "depends_on"
243
+ },
244
+ {
245
+ "from": "qk-orchestrator",
246
+ "to": "qk-devops-release",
247
+ "relation": "depends_on"
248
+ },
249
+ {
250
+ "from": "qk-orchestrator",
251
+ "to": "qk-api-data-discovery",
252
+ "relation": "depends_on"
253
+ }
254
+ ],
150
255
  "adjacency": {
151
- "qk-api-data-discovery": [
152
- "context-discovery"
153
- ],
154
- "qk-backend-data": [
155
- "feature-delivery"
156
- ],
157
- "qk-bug-resolution": [
158
- "bug-resolution"
159
- ],
160
- "qk-code-cleaner": [
161
- "refactor"
162
- ],
163
- "qk-code-review": [
164
- "code-review"
165
- ],
166
- "qk-devops-release": [
167
- "production-release"
168
- ],
169
- "qk-feature-delivery": [
170
- "feature-delivery"
171
- ],
256
+ "qk-api-data-discovery": [],
257
+ "qk-backend-data": [],
258
+ "qk-bug-resolution": [],
259
+ "qk-code-cleaner": [],
260
+ "qk-code-review": [],
261
+ "qk-devops-release": [],
262
+ "qk-feature-delivery": [],
172
263
  "qk-orchestrator": [
173
- "context-discovery"
174
- ],
175
- "qk-product-spec": [
176
- "spec-driven-development"
177
- ],
178
- "qk-prompt-compiler": [
179
- "prompt-compilation"
264
+ "qk-prompt-compiler",
265
+ "qk-product-spec",
266
+ "qk-feature-delivery",
267
+ "qk-bug-resolution",
268
+ "qk-code-cleaner",
269
+ "qk-code-review",
270
+ "qk-ui-engineer",
271
+ "qk-backend-data",
272
+ "qk-devops-release",
273
+ "qk-api-data-discovery"
180
274
  ],
181
- "qk-ui-engineer": [
182
- "feature-delivery"
183
- ]
275
+ "qk-product-spec": [],
276
+ "qk-prompt-compiler": [],
277
+ "qk-ui-engineer": []
184
278
  },
185
279
  "stats": {
186
280
  "total_scanned": 11,
@@ -1,8 +1,8 @@
1
1
  # AUTO-GENERATED BY registry-builder (tooling/build-registry.js)
2
2
  # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
3
3
  schema_version: 1
4
- manifest_version: '8.2'
5
- generated_at: '2026-09-15T03:45:16.804Z'
4
+ manifest_version: '10.2'
5
+ generated_at: '2026-09-24T06:26:56.070Z'
6
6
  stats:
7
7
  total_scanned: 11
8
8
  active: 11
@@ -11,100 +11,133 @@ stats:
11
11
  capabilities:
12
12
  qk-api-data-discovery:
13
13
  path: .agents/skills/qk-api-data-discovery
14
- version: 10.1.0
14
+ version: 10.2.0
15
15
  status: stable
16
+ platforms:
17
+ - antigravity
18
+ - claude
19
+ - opencode
16
20
  tags:
17
21
  - api
18
22
  - data
19
23
  - discovery
20
- dependencies:
21
- - context-discovery
24
+ dependencies: []
22
25
  qk-backend-data:
23
26
  path: .agents/skills/qk-backend-data
24
- version: 10.1.0
27
+ version: 10.2.0
25
28
  status: stable
29
+ platforms:
30
+ - antigravity
31
+ - claude
32
+ - opencode
26
33
  tags:
27
34
  - backend
28
35
  - data
29
- dependencies:
30
- - feature-delivery
36
+ dependencies: []
31
37
  qk-bug-resolution:
32
38
  path: .agents/skills/qk-bug-resolution
33
- version: 10.1.0
39
+ version: 10.2.0
34
40
  status: stable
41
+ platforms:
42
+ - antigravity
43
+ - claude
44
+ - opencode
35
45
  tags:
36
46
  - bug
37
47
  - resolution
38
- dependencies:
39
- - bug-resolution
48
+ dependencies: []
40
49
  qk-code-cleaner:
41
50
  path: .agents/skills/qk-code-cleaner
42
- version: 10.1.0
51
+ version: 10.2.0
43
52
  status: stable
53
+ platforms:
54
+ - antigravity
55
+ - claude
56
+ - opencode
44
57
  tags:
45
58
  - code
46
59
  - cleaner
47
- dependencies:
48
- - refactor
60
+ dependencies: []
49
61
  qk-code-review:
50
62
  path: .agents/skills/qk-code-review
51
- version: 10.1.0
63
+ version: 10.2.0
52
64
  status: stable
65
+ platforms:
66
+ - antigravity
67
+ - claude
68
+ - opencode
53
69
  tags:
54
70
  - code
55
71
  - review
56
- dependencies:
57
- - code-review
72
+ dependencies: []
58
73
  qk-devops-release:
59
74
  path: .agents/skills/qk-devops-release
60
- version: 10.1.0
75
+ version: 10.2.0
61
76
  status: stable
77
+ platforms:
78
+ - antigravity
79
+ - claude
80
+ - opencode
62
81
  tags:
63
82
  - devops
64
83
  - release
65
- dependencies:
66
- - production-release
84
+ dependencies: []
67
85
  qk-feature-delivery:
68
86
  path: .agents/skills/qk-feature-delivery
69
- version: 10.1.0
87
+ version: 10.2.0
70
88
  status: stable
89
+ platforms:
90
+ - antigravity
91
+ - claude
92
+ - opencode
71
93
  tags:
72
94
  - feature
73
95
  - delivery
74
- dependencies:
75
- - feature-delivery
96
+ dependencies: []
76
97
  qk-orchestrator:
77
98
  path: .agents/skills/qk-orchestrator
78
- version: 10.1.0
99
+ version: 10.2.0
79
100
  status: stable
101
+ platforms:
102
+ - antigravity
103
+ - claude
104
+ - opencode
80
105
  tags:
81
106
  - orchestrator
82
- dependencies:
83
- - context-discovery
107
+ dependencies: []
84
108
  qk-product-spec:
85
109
  path: .agents/skills/qk-product-spec
86
- version: 10.1.0
110
+ version: 10.2.0
87
111
  status: stable
112
+ platforms:
113
+ - antigravity
114
+ - claude
115
+ - opencode
88
116
  tags:
89
117
  - product
90
118
  - spec
91
- dependencies:
92
- - spec-driven-development
119
+ dependencies: []
93
120
  qk-prompt-compiler:
94
121
  path: .agents/skills/qk-prompt-compiler
95
- version: 11.1.0
122
+ version: 10.2.0
96
123
  status: stable
124
+ platforms:
125
+ - antigravity
126
+ - claude
127
+ - opencode
97
128
  tags:
98
129
  - prompt
99
130
  - compiler
100
- dependencies:
101
- - prompt-compilation
131
+ dependencies: []
102
132
  qk-ui-engineer:
103
133
  path: .agents/skills/qk-ui-engineer
104
- version: 10.1.0
134
+ version: 10.2.0
105
135
  status: stable
136
+ platforms:
137
+ - antigravity
138
+ - claude
139
+ - opencode
106
140
  tags:
107
141
  - ui
108
142
  - engineer
109
- dependencies:
110
- - feature-delivery
143
+ dependencies: []
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 8.0.0
2
+ version: 10.2.0
3
3
  description: "Rules governing code writing, editing, and review tasks."
4
4
  domain: rules
5
5
  applies_to: [skills-with-side_effects-edit_files]
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 8.0.0
2
+ version: 10.2.0
3
3
  description: "Detailed shell-command threat reference, mapped to the risk matrix defined in safety.md."
4
4
  domain: rules
5
5
  applies_to: [skills-with-side_effects-shell_exec]
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 10.1.0
2
+ version: 10.2.0
3
3
  description: "Agent behavior policies applied globally across all capabilities."
4
4
  domain: rules
5
5
  applies_to: all
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 11.1.0
2
+ version: 10.2.0
3
3
  description: "Quy tắc Prompt Compiler v11.1 Control Plane: Cổng kiểm soát hành vi, Risk Gate R0-R4, Change Budget, Scope Expansion Gate, Evidence Gate và Prompt Delta."
4
4
  domain: rules
5
5
  applies_to: all
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 8.0.0
2
+ version: 10.2.0
3
3
  description: "Risk management rules for agent actions with side effects."
4
4
  domain: rules
5
5
  applies_to: [skills-with-risk-medium, skills-with-risk-high]
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 8.0.0
2
+ version: 10.2.0
3
3
  description: "Rules preventing security vulnerabilities introduced during development and agent operation."
4
4
  domain: rules
5
5
  applies_to: [skills-with-side_effects-edit_files, skills-with-network_access, skills-with-external_input]
@@ -1,5 +1,5 @@
1
1
  ---
2
- version: 8.0.0
2
+ version: 10.2.0
3
3
  description: "Standards for defining, maintaining, and retiring skills in V8."
4
4
  domain: rules
5
5
  applies_to: [skill-authoring, skill-governance]
@@ -34,5 +34,20 @@ Các skill sẽ được rà soát để đảm bảo không bị phình (bloat)
34
34
  ### R-SQ-05: Phát Hiện Trùng Lặp
35
35
  Nếu phát hiện 2 skill có chung mục đích, cần tiến hành gộp (merge) lại và phân định ranh giới (ví dụ: chia implementation và governance).
36
36
 
37
- ### R-SQ-06: Loại Bỏ Có Kiểm Soát
38
- Nếu skill không còn giá trị sử dụng hoặc đã được cover bởi core logic, đánh dấu `status: deprecated`. Không xóa ngay lập tức để giữ backward compatibility.
37
+ ---
38
+
39
+ ## R-SQ-07: Version Standardization (V10.2)
40
+
41
+ Tất cả skill files, rule files, và workflow files MUST có version `10.2.0` trong frontmatter YAML.
42
+
43
+ ### Quản lý Version:
44
+ - **Patch bump** (`10.2.0` → `10.2.1`): Fix nhỏ, không đổi behavior
45
+ - **Minor bump** (`10.2.0` → `10.3.0`): Thêm capability mới
46
+ - **Major bump** (`10.2.0` → `11.0.0`): Kiến trúc thay đổi
47
+
48
+ ### Quy tắc Bump Version:
49
+ - Khi thay đổi behavior của skill → bump version trong SKILL.md frontmatter
50
+ - Khi thay đổi rule → bump version trong rules/*.md frontmatter
51
+ - Khi thay đổi workflow → bump version trong workflows/*.yml
52
+ - Bump version phải đi kèm với commit message: `chore: bump version to X.Y.Z`
53
+