@geraldmaron/construct 1.0.16 → 1.0.18

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 (191) hide show
  1. package/README.md +4 -1
  2. package/bin/construct +236 -21
  3. package/bin/construct-postinstall.mjs +17 -2
  4. package/commands/design/flow.md +2 -0
  5. package/commands/design/ui.md +2 -0
  6. package/lib/cli-commands.mjs +65 -13
  7. package/lib/embed/semantic.mjs +5 -3
  8. package/lib/embedded-contract/audit.mjs +52 -0
  9. package/lib/embedded-contract/capability.mjs +179 -0
  10. package/lib/embedded-contract/contract-version.mjs +39 -0
  11. package/lib/embedded-contract/envelope.mjs +70 -0
  12. package/lib/embedded-contract/index.mjs +71 -0
  13. package/lib/embedded-contract/ingest.mjs +77 -0
  14. package/lib/embedded-contract/model-resolve.mjs +186 -0
  15. package/lib/embedded-contract/redaction.mjs +91 -0
  16. package/lib/embedded-contract/role-facts.mjs +66 -0
  17. package/lib/embedded-contract/triage.mjs +134 -0
  18. package/lib/embedded-contract/workflow-defs.mjs +125 -0
  19. package/lib/embedded-contract/workflow-invoke.mjs +218 -0
  20. package/lib/hooks/config-protection.mjs +12 -5
  21. package/lib/init-unified.mjs +36 -26
  22. package/lib/intake/classify.mjs +6 -0
  23. package/lib/intake/tables/rnd.mjs +33 -0
  24. package/lib/mcp/server.mjs +69 -0
  25. package/lib/mcp/tools/embedded-contract.mjs +77 -0
  26. package/lib/model-router.mjs +40 -0
  27. package/lib/op-log.mjs +61 -0
  28. package/lib/roles/catalog.mjs +26 -95
  29. package/lib/service-manager.mjs +33 -11
  30. package/lib/setup.mjs +21 -3
  31. package/lib/validators/skills.mjs +21 -0
  32. package/package.json +12 -7
  33. package/scripts/sync-specialists.mjs +12 -3
  34. package/skills/ai/agent-dev.md +2 -0
  35. package/skills/ai/llm-security.md +2 -0
  36. package/skills/ai/ml-ops.md +2 -0
  37. package/skills/ai/orchestration-workflow.md +2 -0
  38. package/skills/ai/prompt-and-eval.md +2 -0
  39. package/skills/ai/prompt-optimizer.md +2 -0
  40. package/skills/ai/rag-system.md +2 -0
  41. package/skills/ai/trace-triage.md +36 -0
  42. package/skills/architecture/api-design.md +2 -0
  43. package/skills/architecture/caching.md +2 -0
  44. package/skills/architecture/cloud-native.md +2 -0
  45. package/skills/architecture/message-queue.md +2 -0
  46. package/skills/architecture/security-arch.md +2 -0
  47. package/skills/compliance/ai-disclosure.md +2 -0
  48. package/skills/compliance/data-privacy.md +2 -0
  49. package/skills/compliance/license-audit.md +2 -0
  50. package/skills/compliance/regulatory-review.md +2 -0
  51. package/skills/development/cpp.md +2 -0
  52. package/skills/development/go.md +2 -0
  53. package/skills/development/java.md +2 -0
  54. package/skills/development/kotlin.md +2 -0
  55. package/skills/development/mobile-crossplatform.md +2 -0
  56. package/skills/development/python.md +2 -0
  57. package/skills/development/rust.md +2 -0
  58. package/skills/development/shell.md +2 -0
  59. package/skills/development/swift.md +2 -0
  60. package/skills/development/typescript.md +2 -0
  61. package/skills/devops/ci-cd.md +2 -0
  62. package/skills/devops/containerization.md +2 -0
  63. package/skills/devops/cost-optimization.md +2 -0
  64. package/skills/devops/data-engineering.md +2 -0
  65. package/skills/devops/database.md +2 -0
  66. package/skills/devops/dependency-management.md +2 -0
  67. package/skills/devops/devsecops.md +2 -0
  68. package/skills/devops/git-workflow.md +2 -0
  69. package/skills/devops/incident-response.md +2 -0
  70. package/skills/devops/monorepo.md +2 -0
  71. package/skills/devops/observability.md +2 -0
  72. package/skills/devops/performance.md +2 -0
  73. package/skills/devops/testing.md +2 -0
  74. package/skills/docs/adr-workflow.md +2 -0
  75. package/skills/docs/backlog-proposal-workflow.md +2 -0
  76. package/skills/docs/customer-profile-workflow.md +2 -0
  77. package/skills/docs/document-ingest-workflow.md +2 -0
  78. package/skills/docs/evidence-ingest-workflow.md +2 -0
  79. package/skills/docs/init-docs.md +2 -0
  80. package/skills/docs/init-project.md +2 -0
  81. package/skills/docs/memo-and-decision-capture.md +45 -0
  82. package/skills/docs/prd-workflow.md +2 -0
  83. package/skills/docs/prfaq-workflow.md +2 -0
  84. package/skills/docs/product-intelligence-review.md +2 -0
  85. package/skills/docs/product-intelligence-workflow.md +2 -0
  86. package/skills/docs/product-signal-workflow.md +2 -0
  87. package/skills/docs/research-workflow.md +2 -0
  88. package/skills/docs/runbook-workflow.md +2 -0
  89. package/skills/docs/strategy-workflow.md +2 -0
  90. package/skills/docs/transcript-synthesis.md +43 -0
  91. package/skills/exploration/dependency-graph-reading.md +2 -0
  92. package/skills/exploration/repo-map.md +2 -0
  93. package/skills/exploration/tracer-bullet-method.md +2 -0
  94. package/skills/exploration/unknown-codebase-onboarding.md +2 -0
  95. package/skills/frameworks/django.md +2 -0
  96. package/skills/frameworks/nextjs.md +2 -0
  97. package/skills/frameworks/react.md +2 -0
  98. package/skills/frameworks/spring-boot.md +2 -0
  99. package/skills/frontend-design/accessibility.md +2 -0
  100. package/skills/frontend-design/component-patterns.md +2 -0
  101. package/skills/frontend-design/engineering.md +2 -0
  102. package/skills/frontend-design/screen-reader-testing.md +34 -0
  103. package/skills/frontend-design/state-management.md +2 -0
  104. package/skills/frontend-design/ui-aesthetics.md +2 -0
  105. package/skills/frontend-design/ux-principles.md +2 -0
  106. package/skills/operating/change-management.md +2 -0
  107. package/skills/operating/incident-response.md +2 -0
  108. package/skills/operating/oncall-rotation.md +2 -0
  109. package/skills/operating/orchestration-reference.md +2 -0
  110. package/skills/operating/raw-data-structuring.md +44 -0
  111. package/skills/operating/unstructured-triage.md +45 -0
  112. package/skills/quality-gates/premortem.md +37 -0
  113. package/skills/quality-gates/review-work.md +2 -0
  114. package/skills/quality-gates/verify-change.md +2 -0
  115. package/skills/quality-gates/verify-module.md +2 -0
  116. package/skills/quality-gates/verify-quality.md +2 -0
  117. package/skills/quality-gates/verify-security.md +2 -0
  118. package/skills/roles/architect.ai-systems.md +2 -0
  119. package/skills/roles/architect.data.md +2 -0
  120. package/skills/roles/architect.enterprise.md +2 -0
  121. package/skills/roles/architect.integration.md +2 -0
  122. package/skills/roles/architect.md +2 -0
  123. package/skills/roles/architect.platform.md +2 -0
  124. package/skills/roles/data-analyst.experiment.md +2 -0
  125. package/skills/roles/data-analyst.md +2 -0
  126. package/skills/roles/data-analyst.product-intelligence.md +2 -0
  127. package/skills/roles/data-analyst.product.md +2 -0
  128. package/skills/roles/data-analyst.telemetry.md +2 -0
  129. package/skills/roles/data-engineer.pipeline.md +2 -0
  130. package/skills/roles/data-engineer.vector-retrieval.md +2 -0
  131. package/skills/roles/data-engineer.warehouse.md +2 -0
  132. package/skills/roles/debugger.md +2 -0
  133. package/skills/roles/designer.accessibility.md +2 -0
  134. package/skills/roles/designer.md +2 -0
  135. package/skills/roles/engineer.ai.md +2 -0
  136. package/skills/roles/engineer.data.md +2 -0
  137. package/skills/roles/engineer.md +2 -0
  138. package/skills/roles/engineer.platform.md +2 -0
  139. package/skills/roles/operator.docs.md +2 -0
  140. package/skills/roles/operator.md +2 -0
  141. package/skills/roles/operator.release.md +2 -0
  142. package/skills/roles/operator.sre.md +2 -0
  143. package/skills/roles/orchestrator.md +2 -0
  144. package/skills/roles/product-manager.ai-product.md +2 -0
  145. package/skills/roles/product-manager.business-strategy.md +2 -0
  146. package/skills/roles/product-manager.enterprise.md +2 -0
  147. package/skills/roles/product-manager.growth.md +2 -0
  148. package/skills/roles/product-manager.md +2 -0
  149. package/skills/roles/product-manager.platform.md +2 -0
  150. package/skills/roles/product-manager.product.md +2 -0
  151. package/skills/roles/qa.ai-eval.md +2 -0
  152. package/skills/roles/qa.api-contract.md +2 -0
  153. package/skills/roles/qa.data-pipeline.md +2 -0
  154. package/skills/roles/qa.md +2 -0
  155. package/skills/roles/qa.test-automation.md +2 -0
  156. package/skills/roles/qa.web-ui.md +2 -0
  157. package/skills/roles/researcher.explorer.md +2 -0
  158. package/skills/roles/researcher.md +2 -0
  159. package/skills/roles/researcher.ux.md +2 -0
  160. package/skills/roles/reviewer.devil-advocate.md +2 -0
  161. package/skills/roles/reviewer.evaluator.md +2 -0
  162. package/skills/roles/reviewer.md +2 -0
  163. package/skills/roles/reviewer.trace.md +2 -0
  164. package/skills/roles/security.ai.md +2 -0
  165. package/skills/roles/security.appsec.md +2 -0
  166. package/skills/roles/security.cloud.md +2 -0
  167. package/skills/roles/security.legal-compliance.md +2 -0
  168. package/skills/roles/security.md +2 -0
  169. package/skills/roles/security.privacy.md +2 -0
  170. package/skills/roles/security.supply-chain.md +2 -0
  171. package/skills/security/blue-team.md +2 -0
  172. package/skills/security/code-audit.md +2 -0
  173. package/skills/security/pentest.md +2 -0
  174. package/skills/security/red-team.md +2 -0
  175. package/skills/security/threat-intel.md +2 -0
  176. package/skills/security/vuln-research.md +2 -0
  177. package/skills/strategy/competitive-landscape.md +2 -0
  178. package/skills/strategy/jobs-to-be-done.md +38 -0
  179. package/skills/strategy/market-research-methods.md +2 -0
  180. package/skills/strategy/narrative-arc.md +2 -0
  181. package/skills/strategy/pricing-positioning.md +2 -0
  182. package/skills/utility/clean-code.md +2 -0
  183. package/specialists/prompts/cx-architect.md +1 -0
  184. package/specialists/prompts/cx-designer.md +1 -1
  185. package/specialists/prompts/cx-engineer.md +1 -1
  186. package/specialists/prompts/cx-operations.md +1 -0
  187. package/specialists/prompts/cx-rd-lead.md +1 -0
  188. package/specialists/prompts/cx-sre.md +1 -0
  189. package/specialists/registry.json +20 -11
  190. package/specialists/role-manifests.json +1 -1
  191. package/templates/docs/test-plan.md +96 -0
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: quality-gates-premortem
3
+ description: "Use when: a plan or design needs a premortem — imagining it has already failed and working backward to the failure modes — before committing to it."
4
+ inputs: [plan-or-design]
5
+ artifactType: risk-list
6
+ ---
7
+ # Premortem
8
+
9
+ Use this skill when a plan, design, or proposal needs to be stress-tested before commitment, by imagining it has already failed.
10
+
11
+ A premortem inverts optimism: instead of asking "will this work?", it asserts "it's six months later and this failed — why?". Stating failure as a given frees people to name risks that politeness or momentum would otherwise suppress.
12
+
13
+ ## Steps
14
+
15
+ 1. **Set the frame**: "It is <horizon> from now. This shipped and failed badly. Write the post-mortem headline."
16
+ 2. **Generate failure modes** independently across categories: technical (it didn't work), adoption (no one used it), operational (it broke in prod), people (the owner left), external (a dependency/market moved).
17
+ 3. **For each failure mode**, state the mechanism (how it leads to failure), a rough likelihood (low/med/high), and the earliest observable signal that it is happening.
18
+ 4. **Separate the fatal from the survivable.** A premortem's value is finding the one or two failures that would be unrecoverable.
19
+ 5. **Propose a cheap probe or guardrail** for each high-likelihood or fatal mode — something that would surface it early.
20
+ 6. **Name the assumption** each fatal failure depends on, and whether it has been validated.
21
+
22
+ ## Output shape
23
+
24
+ ```
25
+ ## Failure modes
26
+ | failure | category | likelihood | earliest signal | guardrail |
27
+ |---|---|---|---|---|
28
+
29
+ ## Fatal (unrecoverable) modes
30
+ - <failure> — depends on assumption: <assumption> (validated? yes/no)
31
+ ```
32
+
33
+ ## Verification bar
34
+
35
+ - Failure modes are concrete mechanisms, not vague worries ("it might be hard").
36
+ - Each fatal mode names the specific assumption it rests on.
37
+ - Likelihoods are stated as judgments, labeled as such — not presented as data.
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: quality-gates-review-work
3
3
  description: Use this methodology when a change needs rigorous pre-merge validation. Five independent review roles run concurrently. All must pass.
4
+ inputs: [change-or-diff, acceptance-criteria]
5
+ artifactType: review-report
4
6
  ---
5
7
  # Parallel Adversarial Review
6
8
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: quality-gates-verify-change
3
3
  description: Use this skill to analyze the impact of code changes and verify documentation and tests are in sync.
4
+ inputs: [change-or-diff]
5
+ artifactType: review-report
4
6
  ---
5
7
  # Verify Change
6
8
 
@@ -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