@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/architect.data.md. Anti-pattern guidance for the Architect.data (data) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.data (data) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-data
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Data role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Data role.
9
4
  role: architect.data
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.enterprise.md. Anti-pattern guidance for the Architect.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 architect.enterprise (enterprise) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-enterprise
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Enterprise role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Enterprise role.
9
4
  role: architect.enterprise
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Enterprise Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.integration.md. Anti-pattern guidance for the Architect.integration (integration) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.integration (integration) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-integration
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Integration role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Integration role.
9
4
  role: architect.integration
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Integration Architect Overlay
@@ -1,21 +1,14 @@
1
- <!--
2
- skills/roles/architect.md. Anti-pattern guidance for the Architect role.
3
-
4
- ## Improvement Note (auto-generated 2026-04-29)
5
- - Improve specificity in technical guidance; provide detailed steps or code snippets rather than vague suggestions.
6
- - Ensure that responses directly address the user's request; avoid unrelated topics or general advice that doesn't pertain to the task.
7
- - Incorporate thorough explanations for any proposed solutions or changes to clarify their importance and methodology.
8
-
9
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
10
- Covers common failure modes for the architect domain and counter-moves to avoid them.
11
- Applies to: cx-architect, cx-rd-lead.
12
- -->
13
1
  ---
2
+ name: roles-architect
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect role. Use when reviewing or generating work by cx-architect, cx-rd-lead, or when an agent is acting in the Architect role.
14
4
  role: architect
15
- applies_to: [cx-architect, cx-rd-lead]
5
+ applies_to:
6
+ - cx-architect
7
+ - cx-rd-lead
16
8
  inherits: null
17
9
  version: 2
18
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
19
12
  cap: 1
20
13
  ---
21
14
  # Architect. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.platform.md. Anti-pattern guidance for the Architect.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 architect.platform (platform) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-platform
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Platform role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Platform role.
9
4
  role: architect.platform
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Platform Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.experiment.md. Anti-pattern guidance for the Data-analyst.experiment (experiment) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.experiment (experiment) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-experiment
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Experiment role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst — Experiment role.
9
4
  role: data-analyst.experiment
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: data-analyst
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Experiment Analyst Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.md. Anti-pattern guidance for the Data-analyst role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst role.
9
4
  role: data-analyst
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: null
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Analyst. Role guidance
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/data-analyst.product-intelligence.md. Anti-pattern guidance for the Data-analyst.product-intelligence (product intelligence) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.product-intelligence (product intelligence) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst, cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-product-intelligence
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Product Intelligence role. Use when reviewing or generating work by cx-data-analyst, cx-product-manager, or when an agent is acting in the Data Analyst — Product Intelligence role.
9
4
  role: data-analyst.product-intelligence
10
- applies_to: [cx-data-analyst, cx-product-manager]
5
+ applies_to:
6
+ - cx-data-analyst
7
+ - cx-product-manager
11
8
  inherits: data-analyst
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Product Intelligence Analyst Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.product.md. Anti-pattern guidance for the Data-analyst.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 data-analyst.product (product) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-product
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Product role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst — Product role.
9
4
  role: data-analyst.product
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: data-analyst
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Product Analytics Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/data-analyst.telemetry.md. Anti-pattern guidance for the Data-analyst.telemetry (telemetry) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.telemetry (telemetry) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst, cx-sre.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-telemetry
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Telemetry role. Use when reviewing or generating work by cx-data-analyst, cx-sre, or when an agent is acting in the Data Analyst — Telemetry role.
9
4
  role: data-analyst.telemetry
10
- applies_to: [cx-data-analyst, cx-sre]
5
+ applies_to:
6
+ - cx-data-analyst
7
+ - cx-sre
11
8
  inherits: data-analyst
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Telemetry Analyst Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-engineer.pipeline.md. Anti-pattern guidance for the Data-engineer.pipeline (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 data-engineer.pipeline (pipeline) domain and counter-moves to avoid them.
6
- Applies to: cx-data-engineer.
7
- -->
8
1
  ---
2
+ name: roles-data-engineer-pipeline
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Engineer — Pipeline role. Use when reviewing or generating work by cx-data-engineer, or when an agent is acting in the Data Engineer — Pipeline role.
9
4
  role: data-engineer.pipeline
10
- applies_to: [cx-data-engineer]
5
+ applies_to:
6
+ - cx-data-engineer
11
7
  inherits: engineer.data
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Pipeline Engineer Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/data-engineer.vector-retrieval.md. Anti-pattern guidance for the Data-engineer.vector-retrieval (vector retrieval) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-engineer.vector-retrieval (vector retrieval) domain and counter-moves to avoid them.
6
- Applies to: cx-data-engineer, cx-ai-engineer.
7
- -->
8
1
  ---
2
+ name: roles-data-engineer-vector-retrieval
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Engineer — Vector Retrieval role. Use when reviewing or generating work by cx-data-engineer, cx-ai-engineer, or when an agent is acting in the Data Engineer — Vector Retrieval role.
9
4
  role: data-engineer.vector-retrieval
10
- applies_to: [cx-data-engineer, cx-ai-engineer]
5
+ applies_to:
6
+ - cx-data-engineer
7
+ - cx-ai-engineer
11
8
  inherits: engineer.data
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Vector Retrieval Engineer Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-engineer.warehouse.md. Anti-pattern guidance for the Data-engineer.warehouse (warehouse) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-engineer.warehouse (warehouse) domain and counter-moves to avoid them.
6
- Applies to: cx-data-engineer.
7
- -->
8
1
  ---
2
+ name: roles-data-engineer-warehouse
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Engineer — Warehouse role. Use when reviewing or generating work by cx-data-engineer, or when an agent is acting in the Data Engineer — Warehouse role.
9
4
  role: data-engineer.warehouse
10
- applies_to: [cx-data-engineer]
5
+ applies_to:
6
+ - cx-data-engineer
11
7
  inherits: engineer.data
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Warehouse Engineer Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/debugger.md. Anti-pattern guidance for the Debugger role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the debugger domain and counter-moves to avoid them.
6
- Applies to: cx-debugger.
7
- -->
8
1
  ---
2
+ name: roles-debugger
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Debugger role. Use when reviewing or generating work by cx-debugger, or when an agent is acting in the Debugger role.
9
4
  role: debugger
10
- applies_to: [cx-debugger]
5
+ applies_to:
6
+ - cx-debugger
11
7
  inherits: null
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Debugger. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/designer.accessibility.md. Anti-pattern guidance for the Designer.accessibility (accessibility) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the designer.accessibility (accessibility) domain and counter-moves to avoid them.
6
- Applies to: cx-accessibility.
7
- -->
8
1
  ---
2
+ name: roles-designer-accessibility
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Designer — Accessibility role. Use when reviewing or generating work by cx-accessibility, or when an agent is acting in the Designer — Accessibility role.
9
4
  role: designer.accessibility
10
- applies_to: [cx-accessibility]
5
+ applies_to:
6
+ - cx-accessibility
11
7
  inherits: designer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Accessibility Overlay
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/designer.md. Anti-pattern guidance for the Designer role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the designer domain and counter-moves to avoid them.
6
- Applies to: cx-designer, cx-accessibility.
7
- -->
8
1
  ---
2
+ name: roles-designer
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Designer role. Use when reviewing or generating work by cx-designer, cx-accessibility, or when an agent is acting in the Designer role.
9
4
  role: designer
10
- applies_to: [cx-designer, cx-accessibility]
5
+ applies_to:
6
+ - cx-designer
7
+ - cx-accessibility
11
8
  inherits: null
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Designer. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/engineer.ai.md. Anti-pattern guidance for the Engineer.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 engineer.ai (ai) domain and counter-moves to avoid them.
6
- Applies to: cx-ai-engineer.
7
- -->
8
1
  ---
2
+ name: roles-engineer-ai
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Engineer — AI role. Use when reviewing or generating work by cx-ai-engineer, or when an agent is acting in the Engineer — AI role.
9
4
  role: engineer.ai
10
- applies_to: [cx-ai-engineer]
5
+ applies_to:
6
+ - cx-ai-engineer
11
7
  inherits: engineer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # AI Engineer Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/engineer.data.md. Anti-pattern guidance for the Engineer.data (data) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the engineer.data (data) domain and counter-moves to avoid them.
6
- Applies to: cx-data-engineer.
7
- -->
8
1
  ---
2
+ name: roles-engineer-data
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Engineer — Data role. Use when reviewing or generating work by cx-data-engineer, or when an agent is acting in the Engineer — Data role.
9
4
  role: engineer.data
10
- applies_to: [cx-data-engineer]
5
+ applies_to:
6
+ - cx-data-engineer
11
7
  inherits: engineer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Engineer Overlay
@@ -1,16 +1,16 @@
1
- <!--
2
- skills/roles/engineer.md. Anti-pattern guidance for the Engineer role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the engineer domain and counter-moves to avoid them.
6
- Applies to: cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer.
7
- -->
8
1
  ---
2
+ name: roles-engineer
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Engineer role. Use when reviewing or generating work by cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer, or when an agent is acting in the Engineer role.
9
4
  role: engineer
10
- applies_to: [cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer]
5
+ applies_to:
6
+ - cx-engineer
7
+ - cx-ai-engineer
8
+ - cx-data-engineer
9
+ - cx-platform-engineer
11
10
  inherits: null
12
11
  version: 2
13
- profiles: [rnd]
12
+ profiles:
13
+ - rnd
14
14
  cap: 1
15
15
  ---
16
16
  # Engineer. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/engineer.platform.md. Anti-pattern guidance for the Engineer.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 engineer.platform (platform) domain and counter-moves to avoid them.
6
- Applies to: cx-platform-engineer.
7
- -->
8
1
  ---
2
+ name: roles-engineer-platform
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Engineer — Platform role. Use when reviewing or generating work by cx-platform-engineer, or when an agent is acting in the Engineer — Platform role.
9
4
  role: engineer.platform
10
- applies_to: [cx-platform-engineer]
5
+ applies_to:
6
+ - cx-platform-engineer
11
7
  inherits: engineer
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Platform Engineer Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/operator.docs.md. Anti-pattern guidance for the Operator.docs (docs) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the operator.docs (docs) domain and counter-moves to avoid them.
6
- Applies to: cx-docs-keeper.
7
- -->
8
1
  ---
2
+ name: roles-operator-docs
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Operator — Docs role. Use when reviewing or generating work by cx-docs-keeper, or when an agent is acting in the Operator — Docs role.
9
4
  role: operator.docs
10
- applies_to: [cx-docs-keeper]
5
+ applies_to:
6
+ - cx-docs-keeper
11
7
  inherits: operator
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Docs Keeper Overlay
@@ -1,16 +1,16 @@
1
- <!--
2
- skills/roles/operator.md. Anti-pattern guidance for the Operator role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the operator domain and counter-moves to avoid them.
6
- Applies to: cx-sre, cx-operations, cx-release-manager, cx-docs-keeper.
7
- -->
8
1
  ---
2
+ name: roles-operator
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Operator role. Use when reviewing or generating work by cx-sre, cx-operations, cx-release-manager, cx-docs-keeper, or when an agent is acting in the Operator role.
9
4
  role: operator
10
- applies_to: [cx-sre, cx-operations, cx-release-manager, cx-docs-keeper]
5
+ applies_to:
6
+ - cx-sre
7
+ - cx-operations
8
+ - cx-release-manager
9
+ - cx-docs-keeper
11
10
  inherits: null
12
11
  version: 2
13
- profiles: [rnd]
12
+ profiles:
13
+ - rnd
14
14
  cap: 1
15
15
  ---
16
16
  # Operator. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/operator.release.md. Anti-pattern guidance for the Operator.release (release) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the operator.release (release) domain and counter-moves to avoid them.
6
- Applies to: cx-release-manager.
7
- -->
8
1
  ---
2
+ name: roles-operator-release
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Operator — Release role. Use when reviewing or generating work by cx-release-manager, or when an agent is acting in the Operator — Release role.
9
4
  role: operator.release
10
- applies_to: [cx-release-manager]
5
+ applies_to:
6
+ - cx-release-manager
11
7
  inherits: operator
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Release Manager Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/operator.sre.md. Anti-pattern guidance for the Operator.sre (sre) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the operator.sre (sre) domain and counter-moves to avoid them.
6
- Applies to: cx-sre.
7
- -->
8
1
  ---
2
+ name: roles-operator-sre
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Operator — SRE role. Use when reviewing or generating work by cx-sre, or when an agent is acting in the Operator — SRE role.
9
4
  role: operator.sre
10
- applies_to: [cx-sre]
5
+ applies_to:
6
+ - cx-sre
11
7
  inherits: operator
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # SRE Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/orchestrator.md. Anti-pattern guidance for the Orchestrator role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the orchestrator domain and counter-moves to avoid them.
6
- Applies to: cx-orchestrator.
7
- -->
8
1
  ---
2
+ name: roles-orchestrator
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Orchestrator role. Use when reviewing or generating work by cx-orchestrator, or when an agent is acting in the Orchestrator role.
9
4
  role: orchestrator
10
- applies_to: [cx-orchestrator]
5
+ applies_to:
6
+ - cx-orchestrator
11
7
  inherits: null
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Orchestrator. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/product-manager.ai-product.md. Anti-pattern guidance for the Product-manager.ai-product (ai 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.ai-product (ai product) domain and counter-moves to avoid them.
6
- Applies to: cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-ai-product
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — AI Product role. Use when reviewing or generating work by cx-product-manager, or when an agent is acting in the Product Manager — AI Product role.
9
4
  role: product-manager.ai-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
  # AI Product PM Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/product-manager.business-strategy.md. Anti-pattern guidance for the Product-manager.business-strategy (business strategy) 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.business-strategy (business strategy) domain and counter-moves to avoid them.
6
- Applies to: cx-business-strategist.
7
- -->
8
1
  ---
2
+ name: roles-product-manager-business-strategy
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Product Manager — Business Strategy role. Use when reviewing or generating work by cx-business-strategist, or when an agent is acting in the Product Manager — Business Strategy role.
9
4
  role: product-manager.business-strategy
10
- applies_to: [cx-business-strategist]
5
+ applies_to:
6
+ - cx-business-strategist
11
7
  inherits: product-manager
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Business Strategy Overlay