@geraldmaron/construct 1.0.14 → 1.0.15

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 (259) hide show
  1. package/README.md +6 -0
  2. package/bin/construct +3 -3
  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/lib/beads-client.mjs +19 -1
  34. package/lib/comment-lint.mjs +5 -1
  35. package/lib/context-state.mjs +15 -3
  36. package/lib/contracts/validate.mjs +54 -10
  37. package/lib/contracts/violation-log.mjs +154 -0
  38. package/lib/document-extract/docling-client.mjs +114 -0
  39. package/lib/document-extract/docling-sidecar.py +122 -0
  40. package/lib/document-extract/whisper-client.mjs +79 -0
  41. package/lib/document-extract.mjs +73 -8
  42. package/lib/document-ingest.mjs +26 -4
  43. package/lib/embed/daemon.mjs +6 -1
  44. package/lib/flavors/loader.mjs +1 -1
  45. package/lib/handoffs/contract.mjs +2 -2
  46. package/lib/hooks/session-start.mjs +1 -1
  47. package/lib/ingest/chunker.mjs +94 -0
  48. package/lib/ingest/pipeline.mjs +53 -0
  49. package/lib/ingest/store.mjs +82 -0
  50. package/lib/knowledge/search.mjs +12 -0
  51. package/lib/mcp/server.mjs +142 -1
  52. package/lib/mcp/tools/skills.mjs +6 -3
  53. package/lib/mcp/tools/workflow.mjs +6 -2
  54. package/lib/observation-store.mjs +14 -5
  55. package/lib/ollama-manager.mjs +32 -28
  56. package/lib/prompt-composer.js +11 -1
  57. package/lib/runtime/uv-bootstrap.mjs +129 -0
  58. package/lib/runtime/whisper-bootstrap.mjs +102 -0
  59. package/lib/server/index.mjs +22 -1
  60. package/lib/server/static/index.html +1 -1
  61. package/lib/specialists/postconditions.mjs +1 -1
  62. package/lib/sync/skill-frontmatter.mjs +113 -21
  63. package/lib/tracking-surfaces.mjs +2 -0
  64. package/lib/validators/skills.mjs +86 -54
  65. package/package.json +5 -5
  66. package/personas/construct.md +4 -7
  67. package/platforms/claude/settings.template.json +1 -1
  68. package/rules/common/beads-hygiene.md +3 -9
  69. package/rules/common/code-review.md +3 -6
  70. package/rules/common/coding-style.md +3 -6
  71. package/rules/common/comments.md +3 -7
  72. package/rules/common/commit-approval.md +3 -6
  73. package/rules/common/cx-agent-routing.md +3 -7
  74. package/rules/common/cx-skill-routing.md +3 -3
  75. package/rules/common/doc-ownership.md +3 -8
  76. package/rules/common/efficiency.md +3 -8
  77. package/rules/common/framing.md +3 -8
  78. package/rules/common/git-workflow.md +3 -5
  79. package/rules/common/no-fabrication.md +4 -12
  80. package/rules/common/patterns.md +3 -5
  81. package/rules/common/release-gates.md +3 -8
  82. package/rules/common/research.md +3 -8
  83. package/rules/common/review-before-change.md +3 -9
  84. package/rules/common/security.md +3 -6
  85. package/rules/common/skill-composition.md +3 -7
  86. package/rules/common/testing.md +3 -6
  87. package/rules/golang/coding-style.md +1 -5
  88. package/rules/golang/hooks.md +1 -5
  89. package/rules/golang/patterns.md +1 -5
  90. package/rules/golang/security.md +1 -5
  91. package/rules/golang/testing.md +1 -5
  92. package/rules/python/coding-style.md +1 -5
  93. package/rules/python/hooks.md +1 -5
  94. package/rules/python/patterns.md +1 -5
  95. package/rules/python/security.md +1 -5
  96. package/rules/python/testing.md +1 -5
  97. package/rules/swift/coding-style.md +1 -5
  98. package/rules/swift/hooks.md +1 -5
  99. package/rules/swift/patterns.md +1 -5
  100. package/rules/swift/security.md +1 -5
  101. package/rules/swift/testing.md +1 -5
  102. package/rules/typescript/coding-style.md +1 -5
  103. package/rules/typescript/hooks.md +1 -5
  104. package/rules/typescript/patterns.md +1 -5
  105. package/rules/typescript/security.md +1 -5
  106. package/rules/typescript/testing.md +1 -5
  107. package/rules/web/coding-style.md +3 -5
  108. package/rules/web/design-quality.md +3 -5
  109. package/rules/web/hooks.md +3 -5
  110. package/rules/web/patterns.md +3 -5
  111. package/rules/web/performance.md +3 -5
  112. package/rules/web/security.md +3 -5
  113. package/rules/web/testing.md +3 -5
  114. package/skills/ai/agent-dev.md +4 -5
  115. package/skills/ai/llm-security.md +4 -5
  116. package/skills/ai/ml-ops.md +4 -5
  117. package/skills/ai/orchestration-workflow.md +4 -5
  118. package/skills/ai/prompt-and-eval.md +4 -5
  119. package/skills/ai/prompt-optimizer.md +4 -6
  120. package/skills/ai/rag-system.md +4 -5
  121. package/skills/architecture/api-design.md +4 -5
  122. package/skills/architecture/caching.md +4 -5
  123. package/skills/architecture/cloud-native.md +4 -5
  124. package/skills/architecture/message-queue.md +4 -5
  125. package/skills/architecture/security-arch.md +4 -5
  126. package/skills/compliance/ai-disclosure.md +4 -5
  127. package/skills/compliance/data-privacy.md +4 -5
  128. package/skills/compliance/license-audit.md +4 -5
  129. package/skills/compliance/regulatory-review.md +4 -5
  130. package/skills/development/cpp.md +4 -5
  131. package/skills/development/go.md +4 -5
  132. package/skills/development/java.md +4 -5
  133. package/skills/development/kotlin.md +4 -5
  134. package/skills/development/mobile-crossplatform.md +4 -5
  135. package/skills/development/python.md +4 -5
  136. package/skills/development/rust.md +4 -5
  137. package/skills/development/shell.md +4 -5
  138. package/skills/development/swift.md +4 -5
  139. package/skills/development/typescript.md +4 -5
  140. package/skills/devops/ci-cd.md +4 -5
  141. package/skills/devops/containerization.md +4 -5
  142. package/skills/devops/cost-optimization.md +4 -5
  143. package/skills/devops/data-engineering.md +4 -5
  144. package/skills/devops/database.md +4 -5
  145. package/skills/devops/dependency-management.md +4 -5
  146. package/skills/devops/devsecops.md +4 -5
  147. package/skills/devops/git-workflow.md +4 -5
  148. package/skills/devops/incident-response.md +4 -5
  149. package/skills/devops/monorepo.md +4 -5
  150. package/skills/devops/observability.md +4 -5
  151. package/skills/devops/performance.md +4 -5
  152. package/skills/devops/testing.md +4 -5
  153. package/skills/docs/adr-workflow.md +4 -7
  154. package/skills/docs/backlog-proposal-workflow.md +4 -3
  155. package/skills/docs/customer-profile-workflow.md +4 -3
  156. package/skills/docs/document-ingest-workflow.md +4 -3
  157. package/skills/docs/evidence-ingest-workflow.md +4 -3
  158. package/skills/docs/init-docs.md +4 -5
  159. package/skills/docs/init-project.md +4 -5
  160. package/skills/docs/prd-workflow.md +4 -7
  161. package/skills/docs/prfaq-workflow.md +4 -3
  162. package/skills/docs/product-intelligence-review.md +4 -3
  163. package/skills/docs/product-intelligence-workflow.md +4 -6
  164. package/skills/docs/product-signal-workflow.md +4 -5
  165. package/skills/docs/research-workflow.md +4 -5
  166. package/skills/docs/runbook-workflow.md +4 -5
  167. package/skills/docs/strategy-workflow.md +4 -5
  168. package/skills/exploration/dependency-graph-reading.md +4 -7
  169. package/skills/exploration/repo-map.md +4 -5
  170. package/skills/exploration/tracer-bullet-method.md +4 -7
  171. package/skills/exploration/unknown-codebase-onboarding.md +4 -7
  172. package/skills/frameworks/django.md +4 -5
  173. package/skills/frameworks/nextjs.md +4 -5
  174. package/skills/frameworks/react.md +4 -5
  175. package/skills/frameworks/spring-boot.md +4 -5
  176. package/skills/frontend-design/accessibility.md +4 -5
  177. package/skills/frontend-design/component-patterns.md +4 -5
  178. package/skills/frontend-design/engineering.md +4 -5
  179. package/skills/frontend-design/state-management.md +4 -5
  180. package/skills/frontend-design/ui-aesthetics.md +4 -5
  181. package/skills/frontend-design/ux-principles.md +4 -5
  182. package/skills/operating/change-management.md +4 -8
  183. package/skills/operating/incident-response.md +4 -8
  184. package/skills/operating/oncall-rotation.md +4 -7
  185. package/skills/operating/orchestration-reference.md +4 -10
  186. package/skills/quality-gates/review-work.md +4 -5
  187. package/skills/quality-gates/verify-change.md +4 -5
  188. package/skills/quality-gates/verify-module.md +4 -5
  189. package/skills/quality-gates/verify-quality.md +4 -5
  190. package/skills/quality-gates/verify-security.md +4 -5
  191. package/skills/roles/architect.ai-systems.md +6 -9
  192. package/skills/roles/architect.data.md +6 -9
  193. package/skills/roles/architect.enterprise.md +6 -9
  194. package/skills/roles/architect.integration.md +6 -9
  195. package/skills/roles/architect.md +7 -14
  196. package/skills/roles/architect.platform.md +6 -9
  197. package/skills/roles/data-analyst.experiment.md +6 -9
  198. package/skills/roles/data-analyst.md +6 -9
  199. package/skills/roles/data-analyst.product-intelligence.md +7 -9
  200. package/skills/roles/data-analyst.product.md +6 -9
  201. package/skills/roles/data-analyst.telemetry.md +7 -9
  202. package/skills/roles/data-engineer.pipeline.md +6 -9
  203. package/skills/roles/data-engineer.vector-retrieval.md +7 -9
  204. package/skills/roles/data-engineer.warehouse.md +6 -9
  205. package/skills/roles/debugger.md +6 -9
  206. package/skills/roles/designer.accessibility.md +6 -9
  207. package/skills/roles/designer.md +7 -9
  208. package/skills/roles/engineer.ai.md +6 -9
  209. package/skills/roles/engineer.data.md +6 -9
  210. package/skills/roles/engineer.md +9 -9
  211. package/skills/roles/engineer.platform.md +6 -9
  212. package/skills/roles/operator.docs.md +6 -9
  213. package/skills/roles/operator.md +9 -9
  214. package/skills/roles/operator.release.md +6 -9
  215. package/skills/roles/operator.sre.md +6 -9
  216. package/skills/roles/orchestrator.md +6 -9
  217. package/skills/roles/product-manager.ai-product.md +6 -9
  218. package/skills/roles/product-manager.business-strategy.md +6 -9
  219. package/skills/roles/product-manager.enterprise.md +6 -9
  220. package/skills/roles/product-manager.growth.md +7 -9
  221. package/skills/roles/product-manager.md +7 -9
  222. package/skills/roles/product-manager.platform.md +6 -9
  223. package/skills/roles/product-manager.product.md +6 -9
  224. package/skills/roles/qa.ai-eval.md +8 -9
  225. package/skills/roles/qa.api-contract.md +7 -9
  226. package/skills/roles/qa.data-pipeline.md +7 -9
  227. package/skills/roles/qa.md +7 -9
  228. package/skills/roles/qa.test-automation.md +6 -9
  229. package/skills/roles/qa.web-ui.md +7 -9
  230. package/skills/roles/researcher.explorer.md +6 -9
  231. package/skills/roles/researcher.md +8 -9
  232. package/skills/roles/researcher.ux.md +6 -9
  233. package/skills/roles/reviewer.devil-advocate.md +6 -9
  234. package/skills/roles/reviewer.evaluator.md +6 -9
  235. package/skills/roles/reviewer.md +9 -9
  236. package/skills/roles/reviewer.trace.md +6 -9
  237. package/skills/roles/security.ai.md +7 -9
  238. package/skills/roles/security.appsec.md +6 -9
  239. package/skills/roles/security.cloud.md +6 -9
  240. package/skills/roles/security.legal-compliance.md +6 -9
  241. package/skills/roles/security.md +7 -9
  242. package/skills/roles/security.privacy.md +7 -9
  243. package/skills/roles/security.supply-chain.md +7 -9
  244. package/skills/security/blue-team.md +4 -5
  245. package/skills/security/code-audit.md +4 -5
  246. package/skills/security/pentest.md +4 -5
  247. package/skills/security/red-team.md +4 -5
  248. package/skills/security/threat-intel.md +4 -5
  249. package/skills/security/vuln-research.md +4 -5
  250. package/skills/strategy/competitive-landscape.md +4 -8
  251. package/skills/strategy/market-research-methods.md +4 -8
  252. package/skills/strategy/narrative-arc.md +4 -8
  253. package/skills/strategy/pricing-positioning.md +4 -8
  254. package/skills/utility/clean-code.md +4 -5
  255. package/specialists/policy-inventory.json +14 -0
  256. package/lib/specialist-contracts-enforce.mjs +0 -172
  257. package/rules/common/agents.md +0 -28
  258. package/rules/common/development-workflow.md +0 -32
  259. package/rules/common/performance.md +0 -55
@@ -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
@@ -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