@geraldmaron/construct 1.0.14 → 1.0.16

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 (275) hide show
  1. package/README.md +21 -2
  2. package/bin/construct +146 -83
  3. package/commands/build/feature.md +0 -6
  4. package/commands/build/fix.md +0 -6
  5. package/commands/design/access.md +0 -6
  6. package/commands/design/flow.md +0 -6
  7. package/commands/design/ui.md +0 -6
  8. package/commands/measure/experiment.md +0 -6
  9. package/commands/measure/metrics.md +0 -6
  10. package/commands/measure/results.md +0 -6
  11. package/commands/plan/api.md +0 -6
  12. package/commands/plan/challenge.md +0 -6
  13. package/commands/plan/decide.md +0 -6
  14. package/commands/plan/feature.md +0 -7
  15. package/commands/plan/requirements.md +0 -6
  16. package/commands/remember/context.md +0 -6
  17. package/commands/remember/handoff.md +0 -6
  18. package/commands/remember/runbook.md +0 -6
  19. package/commands/review/code.md +0 -6
  20. package/commands/review/quality.md +0 -6
  21. package/commands/review/security.md +0 -6
  22. package/commands/ship/ready.md +0 -6
  23. package/commands/ship/release.md +0 -6
  24. package/commands/ship/status.md +0 -6
  25. package/commands/understand/docs.md +0 -6
  26. package/commands/understand/research.md +0 -6
  27. package/commands/understand/this.md +0 -6
  28. package/commands/understand/why.md +0 -6
  29. package/commands/work/clean.md +0 -6
  30. package/commands/work/drive.md +0 -6
  31. package/commands/work/optimize-prompts.md +0 -6
  32. package/commands/work/parallel-review.md +0 -6
  33. package/db/schema/010_cx_scores.sql +51 -0
  34. package/lib/beads-client.mjs +19 -1
  35. package/lib/cli-commands.mjs +280 -146
  36. package/lib/comment-lint.mjs +5 -1
  37. package/lib/context-state.mjs +15 -3
  38. package/lib/contracts/validate.mjs +72 -18
  39. package/lib/contracts/violation-log.mjs +169 -0
  40. package/lib/document-extract/docling-client.mjs +114 -0
  41. package/lib/document-extract/docling-sidecar.py +122 -0
  42. package/lib/document-extract/whisper-client.mjs +79 -0
  43. package/lib/document-extract.mjs +73 -8
  44. package/lib/document-ingest.mjs +26 -4
  45. package/lib/embed/daemon.mjs +6 -1
  46. package/lib/flavors/loader.mjs +1 -1
  47. package/lib/handoffs/contract.mjs +2 -2
  48. package/lib/hooks/session-start.mjs +1 -1
  49. package/lib/hooks/stop-notify.mjs +7 -0
  50. package/lib/ingest/chunker.mjs +94 -0
  51. package/lib/ingest/pipeline.mjs +53 -0
  52. package/lib/ingest/store.mjs +82 -0
  53. package/lib/install/first-invocation.mjs +5 -1
  54. package/lib/intake/prepare.mjs +22 -4
  55. package/lib/integrations/intake-integrations.mjs +28 -2
  56. package/lib/knowledge/search.mjs +12 -0
  57. package/lib/mcp/server.mjs +142 -1
  58. package/lib/mcp/tools/skills.mjs +6 -3
  59. package/lib/mcp/tools/telemetry.mjs +30 -0
  60. package/lib/mcp/tools/workflow.mjs +6 -2
  61. package/lib/observation-store.mjs +14 -5
  62. package/lib/ollama-manager.mjs +32 -28
  63. package/lib/orchestration-policy.mjs +15 -0
  64. package/lib/prompt-composer.js +11 -1
  65. package/lib/roles/gateway.mjs +30 -1
  66. package/lib/runtime/uv-bootstrap.mjs +129 -0
  67. package/lib/runtime/whisper-bootstrap.mjs +102 -0
  68. package/lib/scheduler/index.mjs +24 -4
  69. package/lib/server/index.mjs +22 -1
  70. package/lib/server/insights.mjs +12 -0
  71. package/lib/server/static/index.html +1 -1
  72. package/lib/setup.mjs +54 -9
  73. package/lib/specialists/postconditions.mjs +1 -1
  74. package/lib/sync/skill-frontmatter.mjs +113 -21
  75. package/lib/tracking-surfaces.mjs +2 -0
  76. package/lib/update.mjs +31 -3
  77. package/lib/upgrade.mjs +31 -4
  78. package/lib/validators/skills.mjs +86 -54
  79. package/package.json +5 -5
  80. package/personas/construct.md +6 -7
  81. package/platforms/claude/CLAUDE.md +43 -15
  82. package/platforms/claude/settings.template.json +1 -1
  83. package/rules/common/beads-hygiene.md +3 -9
  84. package/rules/common/code-review.md +3 -6
  85. package/rules/common/coding-style.md +3 -6
  86. package/rules/common/comments.md +3 -7
  87. package/rules/common/commit-approval.md +3 -6
  88. package/rules/common/cx-agent-routing.md +3 -7
  89. package/rules/common/cx-skill-routing.md +3 -3
  90. package/rules/common/doc-ownership.md +3 -8
  91. package/rules/common/efficiency.md +3 -8
  92. package/rules/common/framing.md +3 -8
  93. package/rules/common/git-workflow.md +3 -5
  94. package/rules/common/no-fabrication.md +4 -12
  95. package/rules/common/patterns.md +3 -5
  96. package/rules/common/release-gates.md +3 -8
  97. package/rules/common/research.md +3 -8
  98. package/rules/common/review-before-change.md +3 -9
  99. package/rules/common/security.md +3 -6
  100. package/rules/common/skill-composition.md +3 -7
  101. package/rules/common/testing.md +3 -6
  102. package/rules/golang/coding-style.md +1 -5
  103. package/rules/golang/hooks.md +1 -5
  104. package/rules/golang/patterns.md +1 -5
  105. package/rules/golang/security.md +1 -5
  106. package/rules/golang/testing.md +1 -5
  107. package/rules/python/coding-style.md +1 -5
  108. package/rules/python/hooks.md +1 -5
  109. package/rules/python/patterns.md +1 -5
  110. package/rules/python/security.md +1 -5
  111. package/rules/python/testing.md +1 -5
  112. package/rules/swift/coding-style.md +1 -5
  113. package/rules/swift/hooks.md +1 -5
  114. package/rules/swift/patterns.md +1 -5
  115. package/rules/swift/security.md +1 -5
  116. package/rules/swift/testing.md +1 -5
  117. package/rules/typescript/coding-style.md +1 -5
  118. package/rules/typescript/hooks.md +1 -5
  119. package/rules/typescript/patterns.md +1 -5
  120. package/rules/typescript/security.md +1 -5
  121. package/rules/typescript/testing.md +1 -5
  122. package/rules/web/coding-style.md +3 -5
  123. package/rules/web/design-quality.md +3 -5
  124. package/rules/web/hooks.md +3 -5
  125. package/rules/web/patterns.md +3 -5
  126. package/rules/web/performance.md +3 -5
  127. package/rules/web/security.md +3 -5
  128. package/rules/web/testing.md +3 -5
  129. package/scripts/sync-specialists.mjs +20 -2
  130. package/skills/ai/agent-dev.md +4 -5
  131. package/skills/ai/llm-security.md +4 -5
  132. package/skills/ai/ml-ops.md +4 -5
  133. package/skills/ai/orchestration-workflow.md +4 -5
  134. package/skills/ai/prompt-and-eval.md +4 -5
  135. package/skills/ai/prompt-optimizer.md +4 -6
  136. package/skills/ai/rag-system.md +4 -5
  137. package/skills/architecture/api-design.md +4 -5
  138. package/skills/architecture/caching.md +4 -5
  139. package/skills/architecture/cloud-native.md +4 -5
  140. package/skills/architecture/message-queue.md +4 -5
  141. package/skills/architecture/security-arch.md +4 -5
  142. package/skills/compliance/ai-disclosure.md +4 -5
  143. package/skills/compliance/data-privacy.md +4 -5
  144. package/skills/compliance/license-audit.md +4 -5
  145. package/skills/compliance/regulatory-review.md +4 -5
  146. package/skills/development/cpp.md +4 -5
  147. package/skills/development/go.md +4 -5
  148. package/skills/development/java.md +4 -5
  149. package/skills/development/kotlin.md +4 -5
  150. package/skills/development/mobile-crossplatform.md +4 -5
  151. package/skills/development/python.md +4 -5
  152. package/skills/development/rust.md +4 -5
  153. package/skills/development/shell.md +4 -5
  154. package/skills/development/swift.md +4 -5
  155. package/skills/development/typescript.md +4 -5
  156. package/skills/devops/ci-cd.md +4 -5
  157. package/skills/devops/containerization.md +4 -5
  158. package/skills/devops/cost-optimization.md +4 -5
  159. package/skills/devops/data-engineering.md +4 -5
  160. package/skills/devops/database.md +4 -5
  161. package/skills/devops/dependency-management.md +4 -5
  162. package/skills/devops/devsecops.md +4 -5
  163. package/skills/devops/git-workflow.md +4 -5
  164. package/skills/devops/incident-response.md +4 -5
  165. package/skills/devops/monorepo.md +4 -5
  166. package/skills/devops/observability.md +4 -5
  167. package/skills/devops/performance.md +4 -5
  168. package/skills/devops/testing.md +4 -5
  169. package/skills/docs/adr-workflow.md +4 -7
  170. package/skills/docs/backlog-proposal-workflow.md +4 -3
  171. package/skills/docs/customer-profile-workflow.md +4 -3
  172. package/skills/docs/document-ingest-workflow.md +4 -3
  173. package/skills/docs/evidence-ingest-workflow.md +4 -3
  174. package/skills/docs/init-docs.md +4 -5
  175. package/skills/docs/init-project.md +4 -5
  176. package/skills/docs/prd-workflow.md +4 -7
  177. package/skills/docs/prfaq-workflow.md +4 -3
  178. package/skills/docs/product-intelligence-review.md +4 -3
  179. package/skills/docs/product-intelligence-workflow.md +4 -6
  180. package/skills/docs/product-signal-workflow.md +4 -5
  181. package/skills/docs/research-workflow.md +4 -5
  182. package/skills/docs/runbook-workflow.md +4 -5
  183. package/skills/docs/strategy-workflow.md +4 -5
  184. package/skills/exploration/dependency-graph-reading.md +4 -7
  185. package/skills/exploration/repo-map.md +4 -5
  186. package/skills/exploration/tracer-bullet-method.md +4 -7
  187. package/skills/exploration/unknown-codebase-onboarding.md +4 -7
  188. package/skills/frameworks/django.md +4 -5
  189. package/skills/frameworks/nextjs.md +4 -5
  190. package/skills/frameworks/react.md +4 -5
  191. package/skills/frameworks/spring-boot.md +4 -5
  192. package/skills/frontend-design/accessibility.md +4 -5
  193. package/skills/frontend-design/component-patterns.md +4 -5
  194. package/skills/frontend-design/engineering.md +4 -5
  195. package/skills/frontend-design/state-management.md +4 -5
  196. package/skills/frontend-design/ui-aesthetics.md +4 -5
  197. package/skills/frontend-design/ux-principles.md +4 -5
  198. package/skills/operating/change-management.md +4 -8
  199. package/skills/operating/incident-response.md +4 -8
  200. package/skills/operating/oncall-rotation.md +4 -7
  201. package/skills/operating/orchestration-reference.md +4 -10
  202. package/skills/quality-gates/review-work.md +4 -5
  203. package/skills/quality-gates/verify-change.md +4 -5
  204. package/skills/quality-gates/verify-module.md +4 -5
  205. package/skills/quality-gates/verify-quality.md +4 -5
  206. package/skills/quality-gates/verify-security.md +4 -5
  207. package/skills/roles/architect.ai-systems.md +6 -9
  208. package/skills/roles/architect.data.md +6 -9
  209. package/skills/roles/architect.enterprise.md +6 -9
  210. package/skills/roles/architect.integration.md +6 -9
  211. package/skills/roles/architect.md +7 -14
  212. package/skills/roles/architect.platform.md +6 -9
  213. package/skills/roles/data-analyst.experiment.md +6 -9
  214. package/skills/roles/data-analyst.md +6 -9
  215. package/skills/roles/data-analyst.product-intelligence.md +7 -9
  216. package/skills/roles/data-analyst.product.md +6 -9
  217. package/skills/roles/data-analyst.telemetry.md +7 -9
  218. package/skills/roles/data-engineer.pipeline.md +6 -9
  219. package/skills/roles/data-engineer.vector-retrieval.md +7 -9
  220. package/skills/roles/data-engineer.warehouse.md +6 -9
  221. package/skills/roles/debugger.md +6 -9
  222. package/skills/roles/designer.accessibility.md +6 -9
  223. package/skills/roles/designer.md +7 -9
  224. package/skills/roles/engineer.ai.md +6 -9
  225. package/skills/roles/engineer.data.md +6 -9
  226. package/skills/roles/engineer.md +9 -9
  227. package/skills/roles/engineer.platform.md +6 -9
  228. package/skills/roles/operator.docs.md +6 -9
  229. package/skills/roles/operator.md +9 -9
  230. package/skills/roles/operator.release.md +6 -9
  231. package/skills/roles/operator.sre.md +6 -9
  232. package/skills/roles/orchestrator.md +6 -9
  233. package/skills/roles/product-manager.ai-product.md +6 -9
  234. package/skills/roles/product-manager.business-strategy.md +6 -9
  235. package/skills/roles/product-manager.enterprise.md +6 -9
  236. package/skills/roles/product-manager.growth.md +7 -9
  237. package/skills/roles/product-manager.md +7 -9
  238. package/skills/roles/product-manager.platform.md +6 -9
  239. package/skills/roles/product-manager.product.md +6 -9
  240. package/skills/roles/qa.ai-eval.md +8 -9
  241. package/skills/roles/qa.api-contract.md +7 -9
  242. package/skills/roles/qa.data-pipeline.md +7 -9
  243. package/skills/roles/qa.md +7 -9
  244. package/skills/roles/qa.test-automation.md +6 -9
  245. package/skills/roles/qa.web-ui.md +7 -9
  246. package/skills/roles/researcher.explorer.md +6 -9
  247. package/skills/roles/researcher.md +8 -9
  248. package/skills/roles/researcher.ux.md +6 -9
  249. package/skills/roles/reviewer.devil-advocate.md +6 -9
  250. package/skills/roles/reviewer.evaluator.md +6 -9
  251. package/skills/roles/reviewer.md +9 -9
  252. package/skills/roles/reviewer.trace.md +6 -9
  253. package/skills/roles/security.ai.md +7 -9
  254. package/skills/roles/security.appsec.md +6 -9
  255. package/skills/roles/security.cloud.md +6 -9
  256. package/skills/roles/security.legal-compliance.md +6 -9
  257. package/skills/roles/security.md +7 -9
  258. package/skills/roles/security.privacy.md +7 -9
  259. package/skills/roles/security.supply-chain.md +7 -9
  260. package/skills/security/blue-team.md +4 -5
  261. package/skills/security/code-audit.md +4 -5
  262. package/skills/security/pentest.md +4 -5
  263. package/skills/security/red-team.md +4 -5
  264. package/skills/security/threat-intel.md +4 -5
  265. package/skills/security/vuln-research.md +4 -5
  266. package/skills/strategy/competitive-landscape.md +4 -8
  267. package/skills/strategy/market-research-methods.md +4 -8
  268. package/skills/strategy/narrative-arc.md +4 -8
  269. package/skills/strategy/pricing-positioning.md +4 -8
  270. package/skills/utility/clean-code.md +4 -5
  271. package/specialists/policy-inventory.json +14 -0
  272. package/lib/specialist-contracts-enforce.mjs +0 -172
  273. package/rules/common/agents.md +0 -28
  274. package/rules/common/development-workflow.md +0 -32
  275. package/rules/common/performance.md +0 -55
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/product-manager.enterprise.md. Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the product-manager.enterprise (enterprise) domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-enterprise
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — Enterprise role. Use when reviewing or generating work by cx-product-manager, or when an agent is acting in the Product Manager — Enterprise role.
9
4
  role: product-manager.enterprise
10
- applies_to: [cx-product-manager]
5
+ applies_to:
6
+ - cx-product-manager
11
7
  inherits: product-manager
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Enterprise PM Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/product-manager.growth.md. Anti-pattern guidance for the Product-manager.growth (growth) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the product-manager.growth (growth) domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager, cx-business-strategist.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-growth
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — Growth role. Use when reviewing or generating work by cx-product-manager, cx-business-strategist, or when an agent is acting in the Product Manager — Growth role.
9
4
  role: product-manager.growth
10
- applies_to: [cx-product-manager, cx-business-strategist]
5
+ applies_to:
6
+ - cx-product-manager
7
+ - cx-business-strategist
11
8
  inherits: product-manager
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Growth PM Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/product-manager.md. Anti-pattern guidance for the Product-manager role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the product-manager domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager, cx-business-strategist.
7
- -->
8
1
  ---
2
+ name: roles-product-manager
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager role. Use when reviewing or generating work by cx-product-manager, cx-business-strategist, or when an agent is acting in the Product Manager role.
9
4
  role: product-manager
10
- applies_to: [cx-product-manager, cx-business-strategist]
5
+ applies_to:
6
+ - cx-product-manager
7
+ - cx-business-strategist
11
8
  inherits: null
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Product Manager. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/product-manager.platform.md. Anti-pattern guidance for the Product-manager.platform (platform) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the product-manager.platform (platform) domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-platform
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — Platform role. Use when reviewing or generating work by cx-product-manager, or when an agent is acting in the Product Manager — Platform role.
9
4
  role: product-manager.platform
10
- applies_to: [cx-product-manager]
5
+ applies_to:
6
+ - cx-product-manager
11
7
  inherits: product-manager
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Platform PM Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/product-manager.product.md. Anti-pattern guidance for the Product-manager.product (product) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the product-manager.product (product) domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-product
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — Product role. Use when reviewing or generating work by cx-product-manager, or when an agent is acting in the Product Manager — Product role.
9
4
  role: product-manager.product
10
- applies_to: [cx-product-manager]
5
+ applies_to:
6
+ - cx-product-manager
11
7
  inherits: product-manager
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Product PM Overlay
@@ -1,16 +1,15 @@
1
- <!--
2
- skills/roles/qa.ai-eval.md. Anti-pattern guidance for the Qa.ai-eval (ai eval) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa.ai-eval (ai eval) domain and counter-moves to avoid them.
6
- Applies to: cx-qa, cx-test-automation, cx-evaluator.
7
- -->
8
1
  ---
2
+ name: roles-qa-ai-eval
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — AI Eval role. Use when reviewing or generating work by cx-qa, cx-test-automation, cx-evaluator, or when an agent is acting in the QA — AI Eval role.
9
4
  role: qa.ai-eval
10
- applies_to: [cx-qa, cx-test-automation, cx-evaluator]
5
+ applies_to:
6
+ - cx-qa
7
+ - cx-test-automation
8
+ - cx-evaluator
11
9
  inherits: qa
12
10
  version: 2
13
- profiles: [rnd]
11
+ profiles:
12
+ - rnd
14
13
  cap: 1
15
14
  ---
16
15
  # AI Eval QA Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/qa.api-contract.md. Anti-pattern guidance for the Qa.api-contract (api contract) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa.api-contract (api contract) domain and counter-moves to avoid them.
6
- Applies to: cx-qa, cx-test-automation.
7
- -->
8
1
  ---
2
+ name: roles-qa-api-contract
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — API Contract role. Use when reviewing or generating work by cx-qa, cx-test-automation, or when an agent is acting in the QA — API Contract role.
9
4
  role: qa.api-contract
10
- applies_to: [cx-qa, cx-test-automation]
5
+ applies_to:
6
+ - cx-qa
7
+ - cx-test-automation
11
8
  inherits: qa
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # API Contract QA Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/qa.data-pipeline.md. Anti-pattern guidance for the Qa.data-pipeline (data pipeline) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa.data-pipeline (data pipeline) domain and counter-moves to avoid them.
6
- Applies to: cx-qa, cx-test-automation.
7
- -->
8
1
  ---
2
+ name: roles-qa-data-pipeline
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — Data Pipeline role. Use when reviewing or generating work by cx-qa, cx-test-automation, or when an agent is acting in the QA — Data Pipeline role.
9
4
  role: qa.data-pipeline
10
- applies_to: [cx-qa, cx-test-automation]
5
+ applies_to:
6
+ - cx-qa
7
+ - cx-test-automation
11
8
  inherits: qa
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Data Pipeline QA Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/qa.md. Anti-pattern guidance for the Qa role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa domain and counter-moves to avoid them.
6
- Applies to: cx-qa, cx-test-automation.
7
- -->
8
1
  ---
2
+ name: roles-qa
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA role. Use when reviewing or generating work by cx-qa, cx-test-automation, or when an agent is acting in the QA role.
9
4
  role: qa
10
- applies_to: [cx-qa, cx-test-automation]
5
+ applies_to:
6
+ - cx-qa
7
+ - cx-test-automation
11
8
  inherits: null
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # QA. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/qa.test-automation.md. Anti-pattern guidance for the Qa.test-automation (test automation) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa.test-automation (test automation) domain and counter-moves to avoid them.
6
- Applies to: cx-test-automation.
7
- -->
8
1
  ---
2
+ name: roles-qa-test-automation
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — Test Automation role. Use when reviewing or generating work by cx-test-automation, or when an agent is acting in the QA — Test Automation role.
9
4
  role: qa.test-automation
10
- applies_to: [cx-test-automation]
5
+ applies_to:
6
+ - cx-test-automation
11
7
  inherits: qa
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Test Automation Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/qa.web-ui.md. Anti-pattern guidance for the Qa.web-ui (web ui) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the qa.web-ui (web ui) domain and counter-moves to avoid them.
6
- Applies to: cx-qa, cx-test-automation.
7
- -->
8
1
  ---
2
+ name: roles-qa-web-ui
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — Web UI role. Use when reviewing or generating work by cx-qa, cx-test-automation, or when an agent is acting in the QA — Web UI role.
9
4
  role: qa.web-ui
10
- applies_to: [cx-qa, cx-test-automation]
5
+ applies_to:
6
+ - cx-qa
7
+ - cx-test-automation
11
8
  inherits: qa
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Web UI QA Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/researcher.explorer.md. Anti-pattern guidance for the Researcher.explorer (explorer) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the researcher.explorer (explorer) domain and counter-moves to avoid them.
6
- Applies to: cx-explorer.
7
- -->
8
1
  ---
2
+ name: roles-researcher-explorer
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher — Explorer role. Use when reviewing or generating work by cx-explorer, or when an agent is acting in the Researcher — Explorer role.
9
4
  role: researcher.explorer
10
- applies_to: [cx-explorer]
5
+ applies_to:
6
+ - cx-explorer
11
7
  inherits: researcher
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Codebase Explorer Overlay
@@ -1,16 +1,15 @@
1
- <!--
2
- skills/roles/researcher.md. Anti-pattern guidance for the Researcher role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the researcher domain and counter-moves to avoid them.
6
- Applies to: cx-researcher, cx-ux-researcher, cx-explorer.
7
- -->
8
1
  ---
2
+ name: roles-researcher
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher role. Use when reviewing or generating work by cx-researcher, cx-ux-researcher, cx-explorer, or when an agent is acting in the Researcher role.
9
4
  role: researcher
10
- applies_to: [cx-researcher, cx-ux-researcher, cx-explorer]
5
+ applies_to:
6
+ - cx-researcher
7
+ - cx-ux-researcher
8
+ - cx-explorer
11
9
  inherits: null
12
10
  version: 2
13
- profiles: [rnd]
11
+ profiles:
12
+ - rnd
14
13
  cap: 1
15
14
  ---
16
15
  # Researcher. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/researcher.ux.md. Anti-pattern guidance for the Researcher.ux (ux) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the researcher.ux (ux) domain and counter-moves to avoid them.
6
- Applies to: cx-ux-researcher.
7
- -->
8
1
  ---
2
+ name: roles-researcher-ux
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher — UX role. Use when reviewing or generating work by cx-ux-researcher, or when an agent is acting in the Researcher — UX role.
9
4
  role: researcher.ux
10
- applies_to: [cx-ux-researcher]
5
+ applies_to:
6
+ - cx-ux-researcher
11
7
  inherits: researcher
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # UX Researcher Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/reviewer.devil-advocate.md. Anti-pattern guidance for the Reviewer.devil-advocate (devil advocate) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the reviewer.devil-advocate (devil advocate) domain and counter-moves to avoid them.
6
- Applies to: cx-devil-advocate.
7
- -->
8
1
  ---
2
+ name: roles-reviewer-devil-advocate
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Devil Advocate role. Use when reviewing or generating work by cx-devil-advocate, or when an agent is acting in the Reviewer — Devil Advocate role.
9
4
  role: reviewer.devil-advocate
10
- applies_to: [cx-devil-advocate]
5
+ applies_to:
6
+ - cx-devil-advocate
11
7
  inherits: reviewer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Devil's Advocate Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/reviewer.evaluator.md. Anti-pattern guidance for the Reviewer.evaluator (evaluator) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the reviewer.evaluator (evaluator) domain and counter-moves to avoid them.
6
- Applies to: cx-evaluator.
7
- -->
8
1
  ---
2
+ name: roles-reviewer-evaluator
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Evaluator role. Use when reviewing or generating work by cx-evaluator, or when an agent is acting in the Reviewer — Evaluator role.
9
4
  role: reviewer.evaluator
10
- applies_to: [cx-evaluator]
5
+ applies_to:
6
+ - cx-evaluator
11
7
  inherits: reviewer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Evaluator Overlay
@@ -1,16 +1,16 @@
1
- <!--
2
- skills/roles/reviewer.md. Anti-pattern guidance for the Reviewer role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the reviewer domain and counter-moves to avoid them.
6
- Applies to: cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer.
7
- -->
8
1
  ---
2
+ name: roles-reviewer
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer role. Use when reviewing or generating work by cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer, or when an agent is acting in the Reviewer role.
9
4
  role: reviewer
10
- applies_to: [cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer]
5
+ applies_to:
6
+ - cx-reviewer
7
+ - cx-devil-advocate
8
+ - cx-evaluator
9
+ - cx-trace-reviewer
11
10
  inherits: null
12
11
  version: 2
13
- profiles: [rnd]
12
+ profiles:
13
+ - rnd
14
14
  cap: 1
15
15
  ---
16
16
  # Reviewer. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/reviewer.trace.md. Anti-pattern guidance for the Reviewer.trace (trace) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the reviewer.trace (trace) domain and counter-moves to avoid them.
6
- Applies to: cx-trace-reviewer.
7
- -->
8
1
  ---
2
+ name: roles-reviewer-trace
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Trace role. Use when reviewing or generating work by cx-trace-reviewer, or when an agent is acting in the Reviewer — Trace role.
9
4
  role: reviewer.trace
10
- applies_to: [cx-trace-reviewer]
5
+ applies_to:
6
+ - cx-trace-reviewer
11
7
  inherits: reviewer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Trace Reviewer Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/security.ai.md. Anti-pattern guidance for the Security.ai (ai) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.ai (ai) domain and counter-moves to avoid them.
6
- Applies to: cx-security, cx-ai-engineer.
7
- -->
8
1
  ---
2
+ name: roles-security-ai
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — AI role. Use when reviewing or generating work by cx-security, cx-ai-engineer, or when an agent is acting in the Security — AI role.
9
4
  role: security.ai
10
- applies_to: [cx-security, cx-ai-engineer]
5
+ applies_to:
6
+ - cx-security
7
+ - cx-ai-engineer
11
8
  inherits: security
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # AI Security Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/security.appsec.md. Anti-pattern guidance for the Security.appsec (appsec) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.appsec (appsec) domain and counter-moves to avoid them.
6
- Applies to: cx-security.
7
- -->
8
1
  ---
2
+ name: roles-security-appsec
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Appsec role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Appsec role.
9
4
  role: security.appsec
10
- applies_to: [cx-security]
5
+ applies_to:
6
+ - cx-security
11
7
  inherits: security
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # AppSec Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/security.cloud.md. Anti-pattern guidance for the Security.cloud (cloud) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.cloud (cloud) domain and counter-moves to avoid them.
6
- Applies to: cx-security.
7
- -->
8
1
  ---
2
+ name: roles-security-cloud
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Cloud role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Cloud role.
9
4
  role: security.cloud
10
- applies_to: [cx-security]
5
+ applies_to:
6
+ - cx-security
11
7
  inherits: security
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Cloud Security Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/security.legal-compliance.md. Anti-pattern guidance for the Security.legal-compliance (legal compliance) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.legal-compliance (legal compliance) domain and counter-moves to avoid them.
6
- Applies to: cx-legal-compliance.
7
- -->
8
1
  ---
2
+ name: roles-security-legal-compliance
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Legal Compliance role. Use when reviewing or generating work by cx-legal-compliance, or when an agent is acting in the Security — Legal Compliance role.
9
4
  role: security.legal-compliance
10
- applies_to: [cx-legal-compliance]
5
+ applies_to:
6
+ - cx-legal-compliance
11
7
  inherits: security
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Legal & Compliance Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/security.md. Anti-pattern guidance for the Security role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security domain and counter-moves to avoid them.
6
- Applies to: cx-security, cx-legal-compliance.
7
- -->
8
1
  ---
2
+ name: roles-security
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security role.
9
4
  role: security
10
- applies_to: [cx-security, cx-legal-compliance]
5
+ applies_to:
6
+ - cx-security
7
+ - cx-legal-compliance
11
8
  inherits: null
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Security. Role guidance
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/security.privacy.md. Anti-pattern guidance for the Security.privacy (privacy) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.privacy (privacy) domain and counter-moves to avoid them.
6
- Applies to: cx-security, cx-legal-compliance.
7
- -->
8
1
  ---
2
+ name: roles-security-privacy
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Privacy role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security — Privacy role.
9
4
  role: security.privacy
10
- applies_to: [cx-security, cx-legal-compliance]
5
+ applies_to:
6
+ - cx-security
7
+ - cx-legal-compliance
11
8
  inherits: security
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Privacy Security Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/security.supply-chain.md. Anti-pattern guidance for the Security.supply-chain (supply chain) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the security.supply-chain (supply chain) domain and counter-moves to avoid them.
6
- Applies to: cx-security, cx-platform-engineer.
7
- -->
8
1
  ---
2
+ name: roles-security-supply-chain
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Supply Chain role. Use when reviewing or generating work by cx-security, cx-platform-engineer, or when an agent is acting in the Security — Supply Chain role.
9
4
  role: security.supply-chain
10
- applies_to: [cx-security, cx-platform-engineer]
5
+ applies_to:
6
+ - cx-security
7
+ - cx-platform-engineer
11
8
  inherits: security
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Supply Chain Security Overlay
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/security/blue-team.md (Blue Team) Use this skill when defending systems, responding to incidents, or building dete
3
-
4
- Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities. ## Detection Engineering
5
- -->
1
+ ---
2
+ name: security-blue-team
3
+ description: Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities.
4
+ ---
6
5
  # Blue Team
7
6
 
8
7
  Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/security/code-audit.md (Code Audit) Use this skill when reviewing source code for security vulnerabilities through s
3
-
4
- Use this skill when reviewing source code for security vulnerabilities through static analysis. ## Taint Analysis
5
- -->
1
+ ---
2
+ name: security-code-audit
3
+ description: Use this skill when reviewing source code for security vulnerabilities through static analysis.
4
+ ---
6
5
  # Code Audit
7
6
 
8
7
  Use this skill when reviewing source code for security vulnerabilities through static analysis.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/security/pentest.md (Penetration Testing) Use this skill when testing web applications or APIs for security vulnerabilitie
3
-
4
- Use this skill when testing web applications or APIs for security vulnerabilities. ## OWASP Top 10 Checklist
5
- -->
1
+ ---
2
+ name: security-pentest
3
+ description: Use this skill when testing web applications or APIs for security vulnerabilities.
4
+ ---
6
5
  # Penetration Testing
7
6
 
8
7
  Use this skill when testing web applications or APIs for security vulnerabilities.