@geraldmaron/construct 1.0.12 → 1.0.15

package/skills/roles/data-analyst.telemetry.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/data-analyst.telemetry.md. Anti-pattern guidance for the Data-analyst.telemetry (telemetry) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the data-analyst.telemetry (telemetry) domain and counter-moves to avoid them.
-Applies to: cx-data-analyst, cx-sre.
--->
 ---
+name: roles-data-analyst-telemetry
+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.
 role: data-analyst.telemetry
-applies_to: [cx-data-analyst, cx-sre]
+applies_to:
+  - cx-data-analyst
+  - cx-sre
 inherits: data-analyst
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Telemetry Analyst Overlay

package/skills/roles/data-engineer.pipeline.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/data-engineer.pipeline.md. Anti-pattern guidance for the Data-engineer.pipeline (pipeline) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the data-engineer.pipeline (pipeline) domain and counter-moves to avoid them.
-Applies to: cx-data-engineer.
--->
 ---
+name: roles-data-engineer-pipeline
+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.
 role: data-engineer.pipeline
-applies_to: [cx-data-engineer]
+applies_to:
+  - cx-data-engineer
 inherits: engineer.data
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Data Pipeline Engineer Overlay

package/skills/roles/data-engineer.vector-retrieval.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/data-engineer.vector-retrieval.md. Anti-pattern guidance for the Data-engineer.vector-retrieval (vector retrieval) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the data-engineer.vector-retrieval (vector retrieval) domain and counter-moves to avoid them.
-Applies to: cx-data-engineer, cx-ai-engineer.
--->
 ---
+name: roles-data-engineer-vector-retrieval
+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.
 role: data-engineer.vector-retrieval
-applies_to: [cx-data-engineer, cx-ai-engineer]
+applies_to:
+  - cx-data-engineer
+  - cx-ai-engineer
 inherits: engineer.data
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Vector Retrieval Engineer Overlay

package/skills/roles/data-engineer.warehouse.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/data-engineer.warehouse.md. Anti-pattern guidance for the Data-engineer.warehouse (warehouse) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the data-engineer.warehouse (warehouse) domain and counter-moves to avoid them.
-Applies to: cx-data-engineer.
--->
 ---
+name: roles-data-engineer-warehouse
+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.
 role: data-engineer.warehouse
-applies_to: [cx-data-engineer]
+applies_to:
+  - cx-data-engineer
 inherits: engineer.data
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Warehouse Engineer Overlay

package/skills/roles/debugger.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/debugger.md. Anti-pattern guidance for the Debugger role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the debugger domain and counter-moves to avoid them.
-Applies to: cx-debugger.
--->
 ---
+name: roles-debugger
+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.
 role: debugger
-applies_to: [cx-debugger]
+applies_to:
+  - cx-debugger
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Debugger. Role guidance

package/skills/roles/designer.accessibility.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/designer.accessibility.md. Anti-pattern guidance for the Designer.accessibility (accessibility) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the designer.accessibility (accessibility) domain and counter-moves to avoid them.
-Applies to: cx-accessibility.
--->
 ---
+name: roles-designer-accessibility
+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.
 role: designer.accessibility
-applies_to: [cx-accessibility]
+applies_to:
+  - cx-accessibility
 inherits: designer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Accessibility Overlay

package/skills/roles/designer.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/designer.md. Anti-pattern guidance for the Designer role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the designer domain and counter-moves to avoid them.
-Applies to: cx-designer, cx-accessibility.
--->
 ---
+name: roles-designer
+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.
 role: designer
-applies_to: [cx-designer, cx-accessibility]
+applies_to:
+  - cx-designer
+  - cx-accessibility
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Designer. Role guidance

package/skills/roles/engineer.ai.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/engineer.ai.md. Anti-pattern guidance for the Engineer.ai (ai) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the engineer.ai (ai) domain and counter-moves to avoid them.
-Applies to: cx-ai-engineer.
--->
 ---
+name: roles-engineer-ai
+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.
 role: engineer.ai
-applies_to: [cx-ai-engineer]
+applies_to:
+  - cx-ai-engineer
 inherits: engineer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # AI Engineer Overlay

package/skills/roles/engineer.data.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/engineer.data.md. Anti-pattern guidance for the Engineer.data (data) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the engineer.data (data) domain and counter-moves to avoid them.
-Applies to: cx-data-engineer.
--->
 ---
+name: roles-engineer-data
+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.
 role: engineer.data
-applies_to: [cx-data-engineer]
+applies_to:
+  - cx-data-engineer
 inherits: engineer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Data Engineer Overlay

package/skills/roles/engineer.md

@@ -1,16 +1,16 @@
-<!--
-skills/roles/engineer.md. Anti-pattern guidance for the Engineer role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the engineer domain and counter-moves to avoid them.
-Applies to: cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer.
--->
 ---
+name: roles-engineer
+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.
 role: engineer
-applies_to: [cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer]
+applies_to:
+  - cx-engineer
+  - cx-ai-engineer
+  - cx-data-engineer
+  - cx-platform-engineer
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Engineer. Role guidance

package/skills/roles/engineer.platform.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/engineer.platform.md. Anti-pattern guidance for the Engineer.platform (platform) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the engineer.platform (platform) domain and counter-moves to avoid them.
-Applies to: cx-platform-engineer.
--->
 ---
+name: roles-engineer-platform
+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.
 role: engineer.platform
-applies_to: [cx-platform-engineer]
+applies_to:
+  - cx-platform-engineer
 inherits: engineer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Platform Engineer Overlay

package/skills/roles/operator.docs.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/operator.docs.md. Anti-pattern guidance for the Operator.docs (docs) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the operator.docs (docs) domain and counter-moves to avoid them.
-Applies to: cx-docs-keeper.
--->
 ---
+name: roles-operator-docs
+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.
 role: operator.docs
-applies_to: [cx-docs-keeper]
+applies_to:
+  - cx-docs-keeper
 inherits: operator
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Docs Keeper Overlay

package/skills/roles/operator.md

@@ -1,16 +1,16 @@
-<!--
-skills/roles/operator.md. Anti-pattern guidance for the Operator role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the operator domain and counter-moves to avoid them.
-Applies to: cx-sre, cx-operations, cx-release-manager, cx-docs-keeper.
--->
 ---
+name: roles-operator
+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.
 role: operator
-applies_to: [cx-sre, cx-operations, cx-release-manager, cx-docs-keeper]
+applies_to:
+  - cx-sre
+  - cx-operations
+  - cx-release-manager
+  - cx-docs-keeper
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Operator. Role guidance

package/skills/roles/operator.release.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/operator.release.md. Anti-pattern guidance for the Operator.release (release) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the operator.release (release) domain and counter-moves to avoid them.
-Applies to: cx-release-manager.
--->
 ---
+name: roles-operator-release
+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.
 role: operator.release
-applies_to: [cx-release-manager]
+applies_to:
+  - cx-release-manager
 inherits: operator
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Release Manager Overlay

package/skills/roles/operator.sre.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/operator.sre.md. Anti-pattern guidance for the Operator.sre (sre) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the operator.sre (sre) domain and counter-moves to avoid them.
-Applies to: cx-sre.
--->
 ---
+name: roles-operator-sre
+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.
 role: operator.sre
-applies_to: [cx-sre]
+applies_to:
+  - cx-sre
 inherits: operator
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # SRE Overlay

package/skills/roles/orchestrator.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/orchestrator.md. Anti-pattern guidance for the Orchestrator role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the orchestrator domain and counter-moves to avoid them.
-Applies to: cx-orchestrator.
--->
 ---
+name: roles-orchestrator
+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.
 role: orchestrator
-applies_to: [cx-orchestrator]
+applies_to:
+  - cx-orchestrator
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Orchestrator. Role guidance

package/skills/roles/product-manager.ai-product.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/product-manager.ai-product.md. Anti-pattern guidance for the Product-manager.ai-product (ai product) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.ai-product (ai product) domain and counter-moves to avoid them.
-Applies to: cx-product-manager.
--->
 ---
+name: roles-product-manager-ai-product
+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.
 role: product-manager.ai-product
-applies_to: [cx-product-manager]
+applies_to:
+  - cx-product-manager
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # AI Product PM Overlay

package/skills/roles/product-manager.business-strategy.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/product-manager.business-strategy.md. Anti-pattern guidance for the Product-manager.business-strategy (business strategy) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.business-strategy (business strategy) domain and counter-moves to avoid them.
-Applies to: cx-business-strategist.
--->
 ---
+name: roles-product-manager-business-strategy
+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.
 role: product-manager.business-strategy
-applies_to: [cx-business-strategist]
+applies_to:
+  - cx-business-strategist
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Business Strategy Overlay

package/skills/roles/product-manager.enterprise.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/product-manager.enterprise.md. Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.enterprise (enterprise) domain and counter-moves to avoid them.
-Applies to: cx-product-manager.
--->
 ---
+name: roles-product-manager-enterprise
+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.
 role: product-manager.enterprise
-applies_to: [cx-product-manager]
+applies_to:
+  - cx-product-manager
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Enterprise PM Overlay

package/skills/roles/product-manager.growth.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/product-manager.growth.md. Anti-pattern guidance for the Product-manager.growth (growth) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.growth (growth) domain and counter-moves to avoid them.
-Applies to: cx-product-manager, cx-business-strategist.
--->
 ---
+name: roles-product-manager-growth
+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.
 role: product-manager.growth
-applies_to: [cx-product-manager, cx-business-strategist]
+applies_to:
+  - cx-product-manager
+  - cx-business-strategist
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Growth PM Overlay

package/skills/roles/product-manager.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/product-manager.md. Anti-pattern guidance for the Product-manager role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager domain and counter-moves to avoid them.
-Applies to: cx-product-manager, cx-business-strategist.
--->
 ---
+name: roles-product-manager
+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.
 role: product-manager
-applies_to: [cx-product-manager, cx-business-strategist]
+applies_to:
+  - cx-product-manager
+  - cx-business-strategist
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Product Manager. Role guidance

package/skills/roles/product-manager.platform.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/product-manager.platform.md. Anti-pattern guidance for the Product-manager.platform (platform) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.platform (platform) domain and counter-moves to avoid them.
-Applies to: cx-product-manager.
--->
 ---
+name: roles-product-manager-platform
+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.
 role: product-manager.platform
-applies_to: [cx-product-manager]
+applies_to:
+  - cx-product-manager
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Platform PM Overlay

package/skills/roles/product-manager.product.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/product-manager.product.md. Anti-pattern guidance for the Product-manager.product (product) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the product-manager.product (product) domain and counter-moves to avoid them.
-Applies to: cx-product-manager.
--->
 ---
+name: roles-product-manager-product
+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.
 role: product-manager.product
-applies_to: [cx-product-manager]
+applies_to:
+  - cx-product-manager
 inherits: product-manager
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Product PM Overlay

package/skills/roles/qa.ai-eval.md

@@ -1,16 +1,15 @@
-<!--
-skills/roles/qa.ai-eval.md. Anti-pattern guidance for the Qa.ai-eval (ai eval) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa.ai-eval (ai eval) domain and counter-moves to avoid them.
-Applies to: cx-qa, cx-test-automation, cx-evaluator.
--->
 ---
+name: roles-qa-ai-eval
+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.
 role: qa.ai-eval
-applies_to: [cx-qa, cx-test-automation, cx-evaluator]
+applies_to:
+  - cx-qa
+  - cx-test-automation
+  - cx-evaluator
 inherits: qa
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # AI Eval QA Overlay

package/skills/roles/qa.api-contract.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/qa.api-contract.md. Anti-pattern guidance for the Qa.api-contract (api contract) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa.api-contract (api contract) domain and counter-moves to avoid them.
-Applies to: cx-qa, cx-test-automation.
--->
 ---
+name: roles-qa-api-contract
+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.
 role: qa.api-contract
-applies_to: [cx-qa, cx-test-automation]
+applies_to:
+  - cx-qa
+  - cx-test-automation
 inherits: qa
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # API Contract QA Overlay

package/skills/roles/qa.data-pipeline.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/qa.data-pipeline.md. Anti-pattern guidance for the Qa.data-pipeline (data pipeline) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa.data-pipeline (data pipeline) domain and counter-moves to avoid them.
-Applies to: cx-qa, cx-test-automation.
--->
 ---
+name: roles-qa-data-pipeline
+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.
 role: qa.data-pipeline
-applies_to: [cx-qa, cx-test-automation]
+applies_to:
+  - cx-qa
+  - cx-test-automation
 inherits: qa
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Data Pipeline QA Overlay

package/skills/roles/qa.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/qa.md. Anti-pattern guidance for the Qa role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa domain and counter-moves to avoid them.
-Applies to: cx-qa, cx-test-automation.
--->
 ---
+name: roles-qa
+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.
 role: qa
-applies_to: [cx-qa, cx-test-automation]
+applies_to:
+  - cx-qa
+  - cx-test-automation
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # QA. Role guidance