@geraldmaron/construct 1.0.16 → 1.0.17

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 (182) hide show
  1. package/README.md +4 -1
  2. package/bin/construct +236 -21
  3. package/bin/construct-postinstall.mjs +17 -2
  4. package/lib/cli-commands.mjs +65 -13
  5. package/lib/embedded-contract/audit.mjs +52 -0
  6. package/lib/embedded-contract/capability.mjs +179 -0
  7. package/lib/embedded-contract/contract-version.mjs +39 -0
  8. package/lib/embedded-contract/envelope.mjs +70 -0
  9. package/lib/embedded-contract/index.mjs +71 -0
  10. package/lib/embedded-contract/ingest.mjs +77 -0
  11. package/lib/embedded-contract/model-resolve.mjs +186 -0
  12. package/lib/embedded-contract/redaction.mjs +91 -0
  13. package/lib/embedded-contract/role-facts.mjs +66 -0
  14. package/lib/embedded-contract/triage.mjs +134 -0
  15. package/lib/embedded-contract/workflow-defs.mjs +125 -0
  16. package/lib/embedded-contract/workflow-invoke.mjs +218 -0
  17. package/lib/hooks/config-protection.mjs +12 -5
  18. package/lib/init-unified.mjs +36 -26
  19. package/lib/intake/classify.mjs +6 -0
  20. package/lib/intake/tables/rnd.mjs +33 -0
  21. package/lib/mcp/server.mjs +69 -0
  22. package/lib/mcp/tools/embedded-contract.mjs +77 -0
  23. package/lib/model-router.mjs +40 -0
  24. package/lib/op-log.mjs +61 -0
  25. package/lib/roles/catalog.mjs +26 -95
  26. package/lib/service-manager.mjs +33 -11
  27. package/lib/setup.mjs +21 -3
  28. package/lib/validators/skills.mjs +21 -0
  29. package/package.json +9 -3
  30. package/scripts/sync-specialists.mjs +12 -3
  31. package/skills/ai/agent-dev.md +2 -0
  32. package/skills/ai/llm-security.md +2 -0
  33. package/skills/ai/ml-ops.md +2 -0
  34. package/skills/ai/orchestration-workflow.md +2 -0
  35. package/skills/ai/prompt-and-eval.md +2 -0
  36. package/skills/ai/prompt-optimizer.md +2 -0
  37. package/skills/ai/rag-system.md +2 -0
  38. package/skills/ai/trace-triage.md +36 -0
  39. package/skills/architecture/api-design.md +2 -0
  40. package/skills/architecture/caching.md +2 -0
  41. package/skills/architecture/cloud-native.md +2 -0
  42. package/skills/architecture/message-queue.md +2 -0
  43. package/skills/architecture/security-arch.md +2 -0
  44. package/skills/compliance/ai-disclosure.md +2 -0
  45. package/skills/compliance/data-privacy.md +2 -0
  46. package/skills/compliance/license-audit.md +2 -0
  47. package/skills/compliance/regulatory-review.md +2 -0
  48. package/skills/development/cpp.md +2 -0
  49. package/skills/development/go.md +2 -0
  50. package/skills/development/java.md +2 -0
  51. package/skills/development/kotlin.md +2 -0
  52. package/skills/development/mobile-crossplatform.md +2 -0
  53. package/skills/development/python.md +2 -0
  54. package/skills/development/rust.md +2 -0
  55. package/skills/development/shell.md +2 -0
  56. package/skills/development/swift.md +2 -0
  57. package/skills/development/typescript.md +2 -0
  58. package/skills/devops/ci-cd.md +2 -0
  59. package/skills/devops/containerization.md +2 -0
  60. package/skills/devops/cost-optimization.md +2 -0
  61. package/skills/devops/data-engineering.md +2 -0
  62. package/skills/devops/database.md +2 -0
  63. package/skills/devops/dependency-management.md +2 -0
  64. package/skills/devops/devsecops.md +2 -0
  65. package/skills/devops/git-workflow.md +2 -0
  66. package/skills/devops/incident-response.md +2 -0
  67. package/skills/devops/monorepo.md +2 -0
  68. package/skills/devops/observability.md +2 -0
  69. package/skills/devops/performance.md +2 -0
  70. package/skills/devops/testing.md +2 -0
  71. package/skills/docs/adr-workflow.md +2 -0
  72. package/skills/docs/backlog-proposal-workflow.md +2 -0
  73. package/skills/docs/customer-profile-workflow.md +2 -0
  74. package/skills/docs/document-ingest-workflow.md +2 -0
  75. package/skills/docs/evidence-ingest-workflow.md +2 -0
  76. package/skills/docs/init-docs.md +2 -0
  77. package/skills/docs/init-project.md +2 -0
  78. package/skills/docs/memo-and-decision-capture.md +45 -0
  79. package/skills/docs/prd-workflow.md +2 -0
  80. package/skills/docs/prfaq-workflow.md +2 -0
  81. package/skills/docs/product-intelligence-review.md +2 -0
  82. package/skills/docs/product-intelligence-workflow.md +2 -0
  83. package/skills/docs/product-signal-workflow.md +2 -0
  84. package/skills/docs/research-workflow.md +2 -0
  85. package/skills/docs/runbook-workflow.md +2 -0
  86. package/skills/docs/strategy-workflow.md +2 -0
  87. package/skills/docs/transcript-synthesis.md +43 -0
  88. package/skills/exploration/dependency-graph-reading.md +2 -0
  89. package/skills/exploration/repo-map.md +2 -0
  90. package/skills/exploration/tracer-bullet-method.md +2 -0
  91. package/skills/exploration/unknown-codebase-onboarding.md +2 -0
  92. package/skills/frameworks/django.md +2 -0
  93. package/skills/frameworks/nextjs.md +2 -0
  94. package/skills/frameworks/react.md +2 -0
  95. package/skills/frameworks/spring-boot.md +2 -0
  96. package/skills/frontend-design/accessibility.md +2 -0
  97. package/skills/frontend-design/component-patterns.md +2 -0
  98. package/skills/frontend-design/engineering.md +2 -0
  99. package/skills/frontend-design/screen-reader-testing.md +34 -0
  100. package/skills/frontend-design/state-management.md +2 -0
  101. package/skills/frontend-design/ui-aesthetics.md +2 -0
  102. package/skills/frontend-design/ux-principles.md +2 -0
  103. package/skills/operating/change-management.md +2 -0
  104. package/skills/operating/incident-response.md +2 -0
  105. package/skills/operating/oncall-rotation.md +2 -0
  106. package/skills/operating/orchestration-reference.md +2 -0
  107. package/skills/operating/raw-data-structuring.md +44 -0
  108. package/skills/operating/unstructured-triage.md +45 -0
  109. package/skills/quality-gates/premortem.md +37 -0
  110. package/skills/quality-gates/review-work.md +2 -0
  111. package/skills/quality-gates/verify-change.md +2 -0
  112. package/skills/quality-gates/verify-module.md +2 -0
  113. package/skills/quality-gates/verify-quality.md +2 -0
  114. package/skills/quality-gates/verify-security.md +2 -0
  115. package/skills/roles/architect.ai-systems.md +2 -0
  116. package/skills/roles/architect.data.md +2 -0
  117. package/skills/roles/architect.enterprise.md +2 -0
  118. package/skills/roles/architect.integration.md +2 -0
  119. package/skills/roles/architect.md +2 -0
  120. package/skills/roles/architect.platform.md +2 -0
  121. package/skills/roles/data-analyst.experiment.md +2 -0
  122. package/skills/roles/data-analyst.md +2 -0
  123. package/skills/roles/data-analyst.product-intelligence.md +2 -0
  124. package/skills/roles/data-analyst.product.md +2 -0
  125. package/skills/roles/data-analyst.telemetry.md +2 -0
  126. package/skills/roles/data-engineer.pipeline.md +2 -0
  127. package/skills/roles/data-engineer.vector-retrieval.md +2 -0
  128. package/skills/roles/data-engineer.warehouse.md +2 -0
  129. package/skills/roles/debugger.md +2 -0
  130. package/skills/roles/designer.accessibility.md +2 -0
  131. package/skills/roles/designer.md +2 -0
  132. package/skills/roles/engineer.ai.md +2 -0
  133. package/skills/roles/engineer.data.md +2 -0
  134. package/skills/roles/engineer.md +2 -0
  135. package/skills/roles/engineer.platform.md +2 -0
  136. package/skills/roles/operator.docs.md +2 -0
  137. package/skills/roles/operator.md +2 -0
  138. package/skills/roles/operator.release.md +2 -0
  139. package/skills/roles/operator.sre.md +2 -0
  140. package/skills/roles/orchestrator.md +2 -0
  141. package/skills/roles/product-manager.ai-product.md +2 -0
  142. package/skills/roles/product-manager.business-strategy.md +2 -0
  143. package/skills/roles/product-manager.enterprise.md +2 -0
  144. package/skills/roles/product-manager.growth.md +2 -0
  145. package/skills/roles/product-manager.md +2 -0
  146. package/skills/roles/product-manager.platform.md +2 -0
  147. package/skills/roles/product-manager.product.md +2 -0
  148. package/skills/roles/qa.ai-eval.md +2 -0
  149. package/skills/roles/qa.api-contract.md +2 -0
  150. package/skills/roles/qa.data-pipeline.md +2 -0
  151. package/skills/roles/qa.md +2 -0
  152. package/skills/roles/qa.test-automation.md +2 -0
  153. package/skills/roles/qa.web-ui.md +2 -0
  154. package/skills/roles/researcher.explorer.md +2 -0
  155. package/skills/roles/researcher.md +2 -0
  156. package/skills/roles/researcher.ux.md +2 -0
  157. package/skills/roles/reviewer.devil-advocate.md +2 -0
  158. package/skills/roles/reviewer.evaluator.md +2 -0
  159. package/skills/roles/reviewer.md +2 -0
  160. package/skills/roles/reviewer.trace.md +2 -0
  161. package/skills/roles/security.ai.md +2 -0
  162. package/skills/roles/security.appsec.md +2 -0
  163. package/skills/roles/security.cloud.md +2 -0
  164. package/skills/roles/security.legal-compliance.md +2 -0
  165. package/skills/roles/security.md +2 -0
  166. package/skills/roles/security.privacy.md +2 -0
  167. package/skills/roles/security.supply-chain.md +2 -0
  168. package/skills/security/blue-team.md +2 -0
  169. package/skills/security/code-audit.md +2 -0
  170. package/skills/security/pentest.md +2 -0
  171. package/skills/security/red-team.md +2 -0
  172. package/skills/security/threat-intel.md +2 -0
  173. package/skills/security/vuln-research.md +2 -0
  174. package/skills/strategy/competitive-landscape.md +2 -0
  175. package/skills/strategy/jobs-to-be-done.md +38 -0
  176. package/skills/strategy/market-research-methods.md +2 -0
  177. package/skills/strategy/narrative-arc.md +2 -0
  178. package/skills/strategy/pricing-positioning.md +2 -0
  179. package/skills/utility/clean-code.md +2 -0
  180. package/specialists/prompts/cx-engineer.md +1 -1
  181. package/specialists/registry.json +18 -9
  182. package/specialists/role-manifests.json +1 -1
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: quality-gates-verify-module
3
3
  description: Use this skill to check that a module or package is structurally complete and ready for use.
4
+ inputs: [change-or-diff]
5
+ artifactType: review-report
4
6
  ---
5
7
  # Verify Module
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: quality-gates-verify-quality
3
3
  description: Use this skill to check code quality, complexity, and maintainability after changes.
4
+ inputs: [change-or-diff]
5
+ artifactType: review-report
4
6
  ---
5
7
  # Verify Quality
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: quality-gates-verify-security
3
3
  description: Use this skill to scan code for security vulnerabilities before commits or releases.
4
+ inputs: [change-or-diff]
5
+ artifactType: vulnerability-report
4
6
  ---
5
7
  # Verify Security
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect-ai-systems
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — AI Systems role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — AI Systems role.
4
+ inputs: [architecture-design, adr]
5
+ artifactType: role-guidance
4
6
  role: architect.ai-systems
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect-data
3
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.
4
+ inputs: [data-model, architecture-design]
5
+ artifactType: role-guidance
4
6
  role: architect.data
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect-enterprise
3
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.
4
+ inputs: [architecture-design, compliance-requirements]
5
+ artifactType: role-guidance
4
6
  role: architect.enterprise
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect-integration
3
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.
4
+ inputs: [integration-design, sequence-diagram]
5
+ artifactType: role-guidance
4
6
  role: architect.integration
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect
3
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.
4
+ inputs: [architecture-design, requirements]
5
+ artifactType: role-guidance
4
6
  role: architect
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-architect-platform
3
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.
4
+ inputs: [platform-design, adr]
5
+ artifactType: role-guidance
4
6
  role: architect.platform
5
7
  applies_to:
6
8
  - cx-architect
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-analyst-experiment
3
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.
4
+ inputs: [experiment-plan, metrics]
5
+ artifactType: role-guidance
4
6
  role: data-analyst.experiment
5
7
  applies_to:
6
8
  - cx-data-analyst
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-analyst
3
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.
4
+ inputs: [dataset, metrics-analysis]
5
+ artifactType: role-guidance
4
6
  role: data-analyst
5
7
  applies_to:
6
8
  - cx-data-analyst
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-analyst-product-intelligence
3
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.
4
+ inputs: [customer-signals, telemetry]
5
+ artifactType: role-guidance
4
6
  role: data-analyst.product-intelligence
5
7
  applies_to:
6
8
  - cx-data-analyst
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-analyst-product
3
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.
4
+ inputs: [product-metrics, funnel-data]
5
+ artifactType: role-guidance
4
6
  role: data-analyst.product
5
7
  applies_to:
6
8
  - cx-data-analyst
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-analyst-telemetry
3
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.
4
+ inputs: [telemetry, metrics]
5
+ artifactType: role-guidance
4
6
  role: data-analyst.telemetry
5
7
  applies_to:
6
8
  - cx-data-analyst
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-engineer-pipeline
3
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.
4
+ inputs: [pipeline-design, data-contract]
5
+ artifactType: role-guidance
4
6
  role: data-engineer.pipeline
5
7
  applies_to:
6
8
  - cx-data-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-engineer-vector-retrieval
3
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.
4
+ inputs: [retrieval-design, embeddings]
5
+ artifactType: role-guidance
4
6
  role: data-engineer.vector-retrieval
5
7
  applies_to:
6
8
  - cx-data-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-data-engineer-warehouse
3
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.
4
+ inputs: [warehouse-model, metrics]
5
+ artifactType: role-guidance
4
6
  role: data-engineer.warehouse
5
7
  applies_to:
6
8
  - cx-data-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-debugger
3
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.
4
+ inputs: [bug-report, failure-signal]
5
+ artifactType: role-guidance
4
6
  role: debugger
5
7
  applies_to:
6
8
  - cx-debugger
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-designer-accessibility
3
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.
4
+ inputs: [ui-design, component]
5
+ artifactType: role-guidance
4
6
  role: designer.accessibility
5
7
  applies_to:
6
8
  - cx-accessibility
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-designer
3
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.
4
+ inputs: [ui-design]
5
+ artifactType: role-guidance
4
6
  role: designer
5
7
  applies_to:
6
8
  - cx-designer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-engineer-ai
3
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.
4
+ inputs: [code-diff, prompt]
5
+ artifactType: role-guidance
4
6
  role: engineer.ai
5
7
  applies_to:
6
8
  - cx-ai-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-engineer-data
3
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.
4
+ inputs: [code-diff, data-pipeline]
5
+ artifactType: role-guidance
4
6
  role: engineer.data
5
7
  applies_to:
6
8
  - cx-data-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-engineer
3
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.
4
+ inputs: [code-diff, task-context]
5
+ artifactType: role-guidance
4
6
  role: engineer
5
7
  applies_to:
6
8
  - cx-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-engineer-platform
3
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.
4
+ inputs: [code-diff, internal-tooling]
5
+ artifactType: role-guidance
4
6
  role: engineer.platform
5
7
  applies_to:
6
8
  - cx-platform-engineer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-operator-docs
3
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.
4
+ inputs: [docs, runbook]
5
+ artifactType: role-guidance
4
6
  role: operator.docs
5
7
  applies_to:
6
8
  - cx-docs-keeper
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-operator
3
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.
4
+ inputs: [runbook, deployment-plan]
5
+ artifactType: role-guidance
4
6
  role: operator
5
7
  applies_to:
6
8
  - cx-sre
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-operator-release
3
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.
4
+ inputs: [release-plan, changelog]
5
+ artifactType: role-guidance
4
6
  role: operator.release
5
7
  applies_to:
6
8
  - cx-release-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-operator-sre
3
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.
4
+ inputs: [alert-config, slo]
5
+ artifactType: role-guidance
4
6
  role: operator.sre
5
7
  applies_to:
6
8
  - cx-sre
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-orchestrator
3
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.
4
+ inputs: [task-context, request]
5
+ artifactType: role-guidance
4
6
  role: orchestrator
5
7
  applies_to:
6
8
  - cx-orchestrator
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-ai-product
3
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.
4
+ inputs: [prd, eval-criteria]
5
+ artifactType: role-guidance
4
6
  role: product-manager.ai-product
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-business-strategy
3
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.
4
+ inputs: [strategy-doc, competitive-analysis]
5
+ artifactType: guidance
4
6
  role: product-manager.business-strategy
5
7
  applies_to:
6
8
  - cx-business-strategist
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-enterprise
3
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.
4
+ inputs: [prd, task-context]
5
+ artifactType: guidance
4
6
  role: product-manager.enterprise
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-growth
3
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.
4
+ inputs: [prd, growth-metrics]
5
+ artifactType: guidance
4
6
  role: product-manager.growth
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager
3
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.
4
+ inputs: [prd, user-evidence]
5
+ artifactType: guidance
4
6
  role: product-manager
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-platform
3
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.
4
+ inputs: [prd, api-spec]
5
+ artifactType: guidance
4
6
  role: product-manager.platform
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-product-manager-product
3
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.
4
+ inputs: [prd, task-context]
5
+ artifactType: guidance
4
6
  role: product-manager.product
5
7
  applies_to:
6
8
  - cx-product-manager
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa-ai-eval
3
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.
4
+ inputs: [eval-set, model-output]
5
+ artifactType: guidance
4
6
  role: qa.ai-eval
5
7
  applies_to:
6
8
  - cx-qa
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa-api-contract
3
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.
4
+ inputs: [api-spec, test-suite]
5
+ artifactType: guidance
4
6
  role: qa.api-contract
5
7
  applies_to:
6
8
  - cx-qa
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa-data-pipeline
3
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.
4
+ inputs: [pipeline, test-suite]
5
+ artifactType: guidance
4
6
  role: qa.data-pipeline
5
7
  applies_to:
6
8
  - cx-qa
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa
3
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.
4
+ inputs: [test-suite, code-diff]
5
+ artifactType: guidance
4
6
  role: qa
5
7
  applies_to:
6
8
  - cx-qa
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa-test-automation
3
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.
4
+ inputs: [test-suite, task-context]
5
+ artifactType: guidance
4
6
  role: qa.test-automation
5
7
  applies_to:
6
8
  - cx-test-automation
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-qa-web-ui
3
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.
4
+ inputs: [test-suite, ui]
5
+ artifactType: guidance
4
6
  role: qa.web-ui
5
7
  applies_to:
6
8
  - cx-qa
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-researcher-explorer
3
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.
4
+ inputs: [repo, task-context]
5
+ artifactType: guidance
4
6
  role: researcher.explorer
5
7
  applies_to:
6
8
  - cx-explorer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-researcher
3
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.
4
+ inputs: [research-question, sources]
5
+ artifactType: guidance
4
6
  role: researcher
5
7
  applies_to:
6
8
  - cx-researcher
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-researcher-ux
3
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.
4
+ inputs: [user-research, interview-data]
5
+ artifactType: guidance
4
6
  role: researcher.ux
5
7
  applies_to:
6
8
  - cx-ux-researcher
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-reviewer-devil-advocate
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Devil Advocate role. Use when reviewing or generating work by cx-devil-advocate, or when an agent is acting in the Reviewer — Devil Advocate role.
4
+ inputs: [plan, proposal]
5
+ artifactType: guidance
4
6
  role: reviewer.devil-advocate
5
7
  applies_to:
6
8
  - cx-devil-advocate
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-reviewer-evaluator
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Evaluator role. Use when reviewing or generating work by cx-evaluator, or when an agent is acting in the Reviewer — Evaluator role.
4
+ inputs: [model-output, eval-set]
5
+ artifactType: guidance
4
6
  role: reviewer.evaluator
5
7
  applies_to:
6
8
  - cx-evaluator
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-reviewer
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer role. Use when reviewing or generating work by cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer, or when an agent is acting in the Reviewer role.
4
+ inputs: [code-diff, pull-request]
5
+ artifactType: review-report
4
6
  role: reviewer
5
7
  applies_to:
6
8
  - cx-reviewer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-reviewer-trace
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Trace role. Use when reviewing or generating work by cx-trace-reviewer, or when an agent is acting in the Reviewer — Trace role.
4
+ inputs: [trace, task-context]
5
+ artifactType: guidance
4
6
  role: reviewer.trace
5
7
  applies_to:
6
8
  - cx-trace-reviewer
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-ai
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — AI role. Use when reviewing or generating work by cx-security, cx-ai-engineer, or when an agent is acting in the Security — AI role.
4
+ inputs: [ai-system, task-context]
5
+ artifactType: guidance
4
6
  role: security.ai
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-appsec
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Appsec role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Appsec role.
4
+ inputs: [code-diff, task-context]
5
+ artifactType: guidance
4
6
  role: security.appsec
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-cloud
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Cloud role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Cloud role.
4
+ inputs: [cloud-config, iam-policy]
5
+ artifactType: guidance
4
6
  role: security.cloud
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-legal-compliance
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Legal Compliance role. Use when reviewing or generating work by cx-legal-compliance, or when an agent is acting in the Security — Legal Compliance role.
4
+ inputs: [policy, task-context]
5
+ artifactType: guidance
4
6
  role: security.legal-compliance
5
7
  applies_to:
6
8
  - cx-legal-compliance
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security role.
4
+ inputs: [code-diff, threat-model]
5
+ artifactType: guidance
4
6
  role: security
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-privacy
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Privacy role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security — Privacy role.
4
+ inputs: [data-flow, task-context]
5
+ artifactType: guidance
4
6
  role: security.privacy
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: roles-security-supply-chain
3
3
  description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Supply Chain role. Use when reviewing or generating work by cx-security, cx-platform-engineer, or when an agent is acting in the Security — Supply Chain role.
4
+ inputs: [dependencies, ci-config]
5
+ artifactType: guidance
4
6
  role: security.supply-chain
5
7
  applies_to:
6
8
  - cx-security
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-blue-team
3
3
  description: Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities.
4
+ inputs: [system-design]
5
+ artifactType: guidance
4
6
  ---
5
7
  # Blue Team
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-code-audit
3
3
  description: Use this skill when reviewing source code for security vulnerabilities through static analysis.
4
+ inputs: [code]
5
+ artifactType: vulnerability-report
4
6
  ---
5
7
  # Code Audit
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-pentest
3
3
  description: Use this skill when testing web applications or APIs for security vulnerabilities.
4
+ inputs: [system-design, binary]
5
+ artifactType: pentest-report
4
6
  ---
5
7
  # Penetration Testing
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-red-team
3
3
  description: Use this skill when planning or executing offensive security assessments, adversary emulation, or attack simulations.
4
+ inputs: [system-design, binary]
5
+ artifactType: pentest-report
4
6
  ---
5
7
  # Red Team
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-threat-intel
3
3
  description: Use this skill when performing OSINT, threat modeling, or building threat intelligence programs.
4
+ inputs: [system-design]
5
+ artifactType: threat-model
4
6
  ---
5
7
  # Threat Intelligence
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: security-vuln-research
3
3
  description: Use this skill when analyzing binaries, fuzzing software, or developing exploits for security research.
4
+ inputs: [target-binary-or-software]
5
+ artifactType: vulnerability-report
4
6
  ---
5
7
  # Vulnerability Research
6
8