@geraldmaron/construct 1.2.3 → 1.3.1

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

@@ -8,7 +8,7 @@ applies_to:
   - cx-product-manager
 inherits: product-manager
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

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

@@ -10,7 +10,7 @@ applies_to:
   - cx-evaluator
 inherits: qa
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

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

@@ -9,7 +9,7 @@ applies_to:
   - cx-test-automation
 inherits: qa
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

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

@@ -9,7 +9,7 @@ applies_to:
   - cx-test-automation
 inherits: qa
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/qa.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-test-automation
 inherits: null
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/qa.web-ui.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-test-automation
 inherits: qa
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/{operator.release.md → release-manager.md}

@@ -3,12 +3,12 @@ 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.
 inputs: [release-plan, changelog]
 artifactType: role-guidance
-role: operator.release
+role: release-manager
 applies_to:
   - cx-release-manager
-inherits: operator
+inherits: operations
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/researcher.md

@@ -10,7 +10,7 @@ applies_to:
   - cx-explorer
 inherits: null
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/reviewer.md

@@ -11,7 +11,7 @@ applies_to:
   - cx-trace-reviewer
 inherits: null
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.ai.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-ai-engineer
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.appsec.md

@@ -8,7 +8,7 @@ applies_to:
   - cx-security
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.cloud.md

@@ -8,7 +8,7 @@ applies_to:
   - cx-security
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.legal-compliance.md

@@ -8,7 +8,7 @@ applies_to:
   - cx-legal-compliance
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-legal-compliance
 inherits: null
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.privacy.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-legal-compliance
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/security.supply-chain.md

@@ -9,7 +9,7 @@ applies_to:
   - cx-platform-engineer
 inherits: security
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/{operator.sre.md → sre.md}

@@ -3,12 +3,12 @@ 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.
 inputs: [alert-config, slo]
 artifactType: role-guidance
-role: operator.sre
+role: sre
 applies_to:
   - cx-sre
-inherits: operator
+inherits: operations
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/{qa.test-automation.md → test-automation.md}

@@ -3,12 +3,12 @@ name: roles-qa-test-automation
 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.
 inputs: [test-suite, task-context]
 artifactType: guidance
-role: qa.test-automation
+role: test-automation
 applies_to:
   - cx-test-automation
 inherits: qa
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/{reviewer.trace.md → trace-reviewer.md}

@@ -3,12 +3,12 @@ name: roles-reviewer-trace
 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.
 inputs: [trace, task-context]
 artifactType: guidance
-role: reviewer.trace
+role: trace-reviewer
 applies_to:
   - cx-trace-reviewer
 inherits: reviewer
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/roles/{researcher.ux.md → ux-researcher.md}

@@ -3,12 +3,12 @@ name: roles-researcher-ux
 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.
 inputs: [user-research, interview-data]
 artifactType: guidance
-role: researcher.ux
+role: ux-researcher
 applies_to:
   - cx-ux-researcher
 inherits: researcher
 version: 2
-profiles:
+scopes:
   - rnd
 cap: 1
 ---

package/skills/routing.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "routes": [
+    { "domain": "exploration", "keywords": ["explore repo", "map codebase", "codebase map", "unfamiliar codebase", "how is this structured"], "path": "exploration/repo-map", "priority": 10 },
+    { "domain": "quality-gates", "keywords": ["security scan", "vulnerability", "secrets", "auth audit"], "path": "quality-gates/verify-security", "priority": 10 },
+    { "domain": "quality-gates", "keywords": ["code quality", "complexity", "code smell"], "path": "quality-gates/verify-quality", "priority": 10 },
+    { "domain": "quality-gates", "keywords": ["change impact", "regression", "what broke"], "path": "quality-gates/verify-change", "priority": 10 },
+    { "domain": "docs", "keywords": ["prd", "product requirements", "write a prd"], "path": "docs/prd-workflow", "priority": 20 },
+    { "domain": "docs", "keywords": ["adr", "architecture decision"], "path": "docs/adr-workflow", "priority": 20 },
+    { "domain": "docs", "keywords": ["research brief", "user research"], "path": "docs/research-workflow", "priority": 15 },
+    { "domain": "docs", "keywords": ["strategy", "bets", "non-bets"], "path": "docs/strategy-workflow", "priority": 15 },
+    { "domain": "ai", "keywords": ["rag", "retrieval", "vector database", "embedding"], "path": "ai/rag-system", "priority": 10 },
+    { "domain": "ai", "keywords": ["orchestration", "handoff contract", "workflow state"], "path": "ai/orchestration-workflow", "priority": 10 },
+    { "domain": "security", "keywords": ["pentest", "owasp", "sql injection", "xss"], "path": "security/pentest", "priority": 10 },
+    { "domain": "brand", "keywords": ["prd", "write a prd", "product requirements doc"], "path": "brand/output-vibe", "priority": 12 },
+    { "domain": "brand", "keywords": ["export", "deck", "pdf", "presentation", "artifact vibe"], "path": "brand/output-vibe", "priority": 5 }
+  ]
+}

package/skills/routing.md

@@ -145,4 +145,4 @@ Read the matching skill file before responding when the user's request matches t
 
 **cx-engineer vs cx-platform-engineer:** cx-engineer builds product features for end users. cx-platform-engineer builds the internal platform: CI/CD, deployment tooling, developer environments, internal APIs, and reliability infrastructure. They operate in distinct domains with different quality bars (user-facing UX vs. developer ergonomics and system reliability). Use cx-platform-engineer when the subject is a platform service, internal tool, build pipeline, or infrastructure component that engineers consume, not end users.
 
-**Platform domain overlays** (`roles/product-manager.platform`, `roles/architect.platform`, `roles/engineer.platform`) apply when the PRODUCT being designed or built is a platform: an API, SDK, or developer surface consumed by other developers. These are skill overlays on PM/architect/engineer roles, not routing to cx-platform-engineer. Route to cx-platform-engineer only when the work is infra/ops, not product.
+**Platform domain overlays** (`roles/product-manager.platform`, `roles/architect.platform`) apply when the **product** being designed is a developer-facing platform (API, SDK, extensibility). **Platform engineering work** (CI/CD, internal tooling, IaC) routes to `cx-platform-engineer` and loads `roles/platform-engineer` per ADR-0047.

package/specialists/artifact-manifest.json

@@ -13,12 +13,13 @@
   },
   "artifacts": {
     "prd": {
+      "vibeProfile": "construct-modern",
       "template": "templates/docs/prd.md",
       "primaryOwners": ["cx-product-manager"],
       "workflowSkill": "docs/prd-workflow",
       "toneDefault": "decision-forcing-direct",
       "toneAllowed": ["decision-forcing-direct", "executive-concise"],
-      "structureRequirements": ["Problem", "Goals", "Success metrics", "Risks and mitigations"],
+      "structureRequirements": ["Problem", "Goals", "Success metrics", "Phases", "Risks and mitigations"],
       "visualRequirements": [
         { "id": "prd-user-flow", "check": "artifact-has-mermaid", "diagram": "flowchart" },
         { "id": "prd-metrics-table", "check": "artifact-table-has-columns", "columns": ["Metric", "Baseline", "Target"] }

package/specialists/audit-enrichments.json

@@ -309,32 +309,32 @@
       "grade": "strong",
       "gap": "—"
     },
-    "engineer.ai": {
+    "ai-engineer": {
       "grade": "strong",
       "gap": "—"
     },
-    "engineer.data": {
+    "data-engineer": {
       "grade": "strong",
       "gap": "—"
     },
-    "engineer.platform": {
+    "platform-engineer": {
       "grade": "strong",
       "gap": "—",
       "beadId": "construct-fb8s.7"
     },
-    "operator": {
+    "operations": {
       "grade": "strong",
       "gap": "—"
     },
-    "operator.docs": {
+    "docs-keeper": {
       "grade": "strong",
       "gap": "—"
     },
-    "operator.release": {
+    "release-manager": {
       "grade": "strong",
       "gap": "—"
     },
-    "operator.sre": {
+    "sre": {
       "grade": "strong",
       "gap": "—"
     },
@@ -350,7 +350,7 @@
       "grade": "strong",
       "gap": "—"
     },
-    "product-manager.business-strategy": {
+    "business-strategist": {
       "grade": "strong",
       "gap": "—"
     },
@@ -386,7 +386,7 @@
       "grade": "strong",
       "gap": "—"
     },
-    "qa.test-automation": {
+    "test-automation": {
       "grade": "strong",
       "gap": "—"
     },
@@ -398,11 +398,11 @@
       "grade": "strong",
       "gap": "—"
     },
-    "researcher.explorer": {
+    "explorer": {
       "grade": "strong",
       "gap": "—"
     },
-    "researcher.ux": {
+    "ux-researcher": {
       "grade": "strong",
       "gap": "—"
     },
@@ -410,15 +410,15 @@
       "grade": "strong",
       "gap": "—"
     },
-    "reviewer.devil-advocate": {
+    "devil-advocate": {
       "grade": "strong",
       "gap": "—"
     },
-    "reviewer.evaluator": {
+    "evaluator": {
       "grade": "strong",
       "gap": "—"
     },
-    "reviewer.trace": {
+    "trace-reviewer": {
       "grade": "strong",
       "gap": "—"
     },

package/specialists/org/contracts/accessibility-to-qa.json

@@ -0,0 +1,37 @@
+{
+  "id": "accessibility-to-qa",
+  "producer": "cx-accessibility",
+  "consumer": "cx-qa",
+  "trigger": {
+    "riskFlags": [
+      "ui",
+      "accessibility"
+    ]
+  },
+  "input": {
+    "shape": "a11y-findings",
+    "mustContain": [
+      "findings",
+      "wcagCriterion",
+      "userImpact"
+    ]
+  },
+  "output": {
+    "schema": "lib/contract-schemas/test-report.json",
+    "type": "test-report"
+  },
+  "preconditions": [
+    "A11y findings filed against specific elements (file:line) before QA verification"
+  ],
+  "postconditions": [
+    "QA test plan covers keyboard-only and screen-reader paths for each finding",
+    "Findings flagged 'unverified' by accessibility get a verified test in QA before close"
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "product-group",
+    "consumerTeam": "quality-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/any-to-business-strategist.json

@@ -0,0 +1,57 @@
+{
+  "id": "any-to-business-strategist",
+  "producer": "*",
+  "consumer": "cx-business-strategist",
+  "trigger": {
+    "strategy.required": true
+  },
+  "input": {
+    "shape": "strategy-request",
+    "mustContain": [
+      "goal",
+      "marketContext",
+      "decisionPending"
+    ]
+  },
+  "output": {
+    "shape": "strategic-memo",
+    "mustContain": [
+      "strategicContext",
+      "options",
+      "recommendation",
+      "evidence",
+      "decisionDeadline"
+    ]
+  },
+  "preconditions": [
+    "Strategy documents in `.cx/knowledge/decisions/strategy/` reviewed for declared Bets and Non-bets"
+  ],
+  "postconditions": [
+    "Options section contains 2-4 genuinely distinct strategic paths, not implementation variants",
+    "Any recommendation that contradicts a declared Non-bet is surfaced explicitly with a user-decision marker",
+    {
+      "id": "strategic-memo-has-market-context",
+      "description": "Strategic memo must contain a Market Context section",
+      "check": "artifact-has-section",
+      "section": "Market Context"
+    },
+    {
+      "id": "strategic-memo-options-nonempty",
+      "description": "Strategic memo Options section is present and non-empty",
+      "check": "artifact-section-nonempty",
+      "section": "Options"
+    },
+    {
+      "id": "strategic-memo-has-strategic-risks",
+      "description": "Strategic memo must contain a Strategic Risks section",
+      "check": "artifact-has-section",
+      "section": "Strategic Risks"
+    },
+    {
+      "id": "strategic-memo-claims-cited",
+      "description": "Every market/competitive numeric claim cites a primary source with a date",
+      "check": "artifact-claims-cited"
+    }
+  ],
+  "description": ""
+}

package/specialists/org/contracts/any-to-debugger.json

@@ -0,0 +1,38 @@
+{
+  "id": "any-to-debugger",
+  "producer": "*",
+  "consumer": "cx-debugger",
+  "trigger": {
+    "intent": "investigation",
+    "category": "bug"
+  },
+  "input": {
+    "shape": "bug-signal",
+    "mustContain": [
+      "symptoms",
+      "scope"
+    ]
+  },
+  "output": {
+    "shape": "root-cause-report",
+    "mustContain": [
+      "rootCause",
+      "rootCauseConfirmedVia",
+      "fix"
+    ],
+    "mustMatchEnum": {
+      "rootCauseConfirmedVia": [
+        "reproduction",
+        "trace",
+        "test"
+      ]
+    }
+  },
+  "preconditions": [
+    "Bug reproduced or trace captured before proposing a fix"
+  ],
+  "postconditions": [
+    "rootCauseConfirmedVia in {reproduction, trace, test} — prevents symptom-only fixes that don't address the actual cause"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/any-to-designer.json

@@ -0,0 +1,33 @@
+{
+  "id": "any-to-designer",
+  "producer": "*",
+  "consumer": "cx-designer",
+  "trigger": {
+    "riskFlags": [
+      "ui",
+      "accessibility"
+    ]
+  },
+  "input": {
+    "shape": "design-brief",
+    "mustContain": [
+      "surface",
+      "users",
+      "context"
+    ]
+  },
+  "output": {
+    "shape": "design-deliverable",
+    "mustContain": [
+      "deliverable",
+      "accessibilityCheckRan"
+    ]
+  },
+  "preconditions": [
+    "Affected surface scoped"
+  ],
+  "postconditions": [
+    "accessibilityCheckRan=true — prevents post-hoc a11y fixes by forcing a pre-ship check on every design deliverable"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/any-to-docs-keeper.json

@@ -0,0 +1,34 @@
+{
+  "id": "any-to-docs-keeper",
+  "producer": "*",
+  "consumer": "cx-docs-keeper",
+  "trigger": {
+    "postConsumer": true,
+    "changedCoreDocs": true
+  },
+  "input": {
+    "shape": "doc-delta",
+    "mustContain": [
+      "filesChanged",
+      "decision"
+    ]
+  },
+  "output": {
+    "shape": "doc-sync",
+    "mustContain": [
+      "updatedDocs",
+      "crossReferencesAdded",
+      "crossDocCoherenceCheckRan",
+      "coherenceDiff"
+    ]
+  },
+  "preconditions": [
+    "Implementation or decision is marked DONE"
+  ],
+  "postconditions": [
+    "Cross-doc coherence preserved (PRD ↔ ADR ↔ code)",
+    "AUTO-managed regions regenerated via construct sync",
+    "crossDocCoherenceCheckRan=true with a named coherenceDiff — prevents stale-doc PRs that claim 'docs updated' without a real diff"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/any-to-explorer.json

@@ -0,0 +1,39 @@
+{
+  "id": "any-to-explorer",
+  "producer": "*",
+  "consumer": "cx-explorer",
+  "trigger": {
+    "intent": "investigation",
+    "category": "exploration"
+  },
+  "input": {
+    "shape": "exploration-request",
+    "mustContain": [
+      "question",
+      "scope"
+    ]
+  },
+  "output": {
+    "shape": "exploration-findings",
+    "mustContain": [
+      "entryPoints",
+      "executionPath",
+      "keyFiles",
+      "dataFlow",
+      "gaps"
+    ]
+  },
+  "preconditions": [
+    "Scope tagged; investigation does not follow imports past two hops from named entry points"
+  ],
+  "postconditions": [
+    "Every claim about existing code cites file:line from a read actually performed",
+    "One match is not called a pattern; multi-callsite patterns cite each call site",
+    {
+      "id": "exploration-findings-claims-cited",
+      "description": "Every load-bearing claim cites file:line or a primary external reference",
+      "check": "artifact-claims-cited"
+    }
+  ],
+  "description": ""
+}

package/specialists/org/contracts/any-to-sre-incident.json

@@ -0,0 +1,33 @@
+{
+  "id": "any-to-sre-incident",
+  "producer": "*",
+  "consumer": "cx-sre",
+  "trigger": {
+    "intent": "investigation",
+    "category": "incident"
+  },
+  "input": {
+    "shape": "incident-signal",
+    "mustContain": [
+      "symptoms",
+      "scope",
+      "firstObserved"
+    ]
+  },
+  "output": {
+    "shape": "incident-report",
+    "mustContain": [
+      "rootCause",
+      "timeline",
+      "remediation",
+      "preventions"
+    ]
+  },
+  "preconditions": [
+    "Blast radius assessed before remediation"
+  ],
+  "postconditions": [
+    "Blameless postmortem; no tickets in Problem statement"
+  ],
+  "description": ""
+}