@geraldmaron/construct 1.4.2 → 1.5.0

package/skills/docs/prd-workflow.md

@@ -27,9 +27,8 @@ Style constraint: do not produce a wall of bullets. Use paragraphs for reasoning
 ## Steps
 
 1. **cx-product-manager** produces the requirements package
-2. **cx-ux-researcher** grounds requirements in user behavior (invoke in parallel for new features)
-3. **cx-researcher** fills any evidence gaps
-4. **Write to the appropriate `docs/` subdirectory** using the selected template. Each `get_template()` call resolves `.cx/templates/docs/` first, then the Construct default.
+2. **cx-researcher** grounds requirements in user behavior and fills evidence gaps (invoke in parallel for new features)
+3. **Write to the appropriate `docs/` subdirectory** using the selected template. Each `get_template()` call resolves `.cx/templates/docs/` first, then the Construct default.
 
    | Template | Output path |
    |---|---|
@@ -39,8 +38,8 @@ Style constraint: do not produce a wall of bullets. Use paragraphs for reasoning
    | `meta-prd` | `docs/meta-prd/{YYYY-MM-DD}-{slug}.md` |
    | `rfc` | `docs/decisions/rfc/{YYYY-MM-DD}-{slug}.md` |
    | `rfc-platform` | `docs/decisions/rfc/{YYYY-MM-DD}-{slug}.md` |
-5. **cx-devil-advocate** runs the FMEA challenge pass (`roles/devil-advocate`) on the draft; highest-RPN failure modes need a mitigation or explicit accept-with-rationale before ship. Their specialist id must appear in `.cx/agent-log.jsonl` (manifest `releaseGate.requiredReviewers` for PRD-family types).
-6. **cx-docs-keeper** updates `.cx/context.md` with a link to the PRD
+4. **cx-reviewer** runs the FMEA challenge pass (`roles/devil-advocate`) on the draft; highest-RPN failure modes need a mitigation or explicit accept-with-rationale before ship. Their specialist id must appear in `.cx/agent-log.jsonl` (manifest `releaseGate.requiredReviewers` for PRD-family types).
+5. **cx-operations** updates `.cx/context.md` with a link to the PRD
 
 Run `construct artifact validate <path> --type=<type>` before marking the artifact approved.
 
@@ -63,7 +62,7 @@ Once the PRD is approved, run `/plan feature {feature-slug}` to produce a struct
 
 ## Distribution (publish pipeline)
 
-**`construct workflow invoke` returns a plan only** — it does not draft the PRD. Run the listed specialists (cx-product-manager, cx-researcher, cx-ux-researcher as needed) to author the artifact from the template. **Do not hand-write a stub and publish.**
+**`construct workflow invoke` returns a plan only** — it does not draft the PRD. Run the listed specialists (cx-product-manager, cx-researcher as needed) to author the artifact from the template. **Do not hand-write a stub and publish.**
 
 Before distribution:
 

package/skills/docs/runbook-workflow.md

@@ -11,10 +11,10 @@ Use when: creating operational procedures for services, alerts, or recurring ope
 
 ## Steps
 
-1. **cx-sre** or **cx-release-manager** identifies the need
+1. **cx-operations** identifies the need
 2. **Write to `docs/operations/runbooks/{service}-{operation}.md`** using the template from `get_template("runbook")`: resolves `.cx/templates/docs/runbook.md` (override) then `templates/docs/runbook.md` (shipped)
 3. **Link from the relevant alert** or monitoring dashboard
-4. **cx-docs-keeper** adds to `.cx/context.md` if it's a critical path runbook
+4. **cx-operations** adds to `.cx/context.md` if it's a critical path runbook
 
 ## File naming
 - `docs/operations/runbooks/telemetry-restart.md`

package/skills/docs/user-research-workflow.md

@@ -1,6 +1,6 @@
 ---
 name: docs-user-research-workflow
-description: "Use when: cx-ux-researcher synthesizes user evidence — interviews, support tickets, session replay, surveys, or field notes."
+description: "Use when: cx-researcher synthesizes user evidence — interviews, support tickets, session replay, surveys, or field notes."
 inputs: [user-research, interview-data]
 artifactType: evidence-brief
 toneDefault: pedagogical
@@ -9,7 +9,7 @@ verificationBar: "Observed behavior weighted over self-report; sample size state
 ---
 # User Research Workflow
 
-Use when: cx-ux-researcher gathers or synthesizes **user** evidence. Do not use for CVE lookups, API version facts, or repo structure — use `docs/research-workflow` (cx-researcher) or `docs/codebase-research-workflow` (cx-explorer) instead.
+Use when: cx-researcher gathers or synthesizes **user** evidence. Do not use for CVE lookups, API version facts, or repo structure — use `docs/research-workflow` or `docs/codebase-research-workflow` (both also cx-researcher, under a different skill overlay) instead.
 
 Follow [rules/common/research.md](../../rules/common/research.md) and call `get_skill("roles/ux-researcher")` before drafting.
 
@@ -37,7 +37,7 @@ Follow [rules/common/research.md](../../rules/common/research.md) and call `get_
 
 - No invented customer names, quotes, or ticket ids.
 - Findings describe problems, not prescribed UI solutions.
-- cx-ux-researcher must **not** cite blog posts for API version or security claims.
+- cx-researcher must **not** cite blog posts for API version or security claims.
 ## Release gate
 
 Run `construct artifact validate <path> --type=<type>` before marking the artifact approved.

package/skills/operating/fleet-health-routing.md

@@ -0,0 +1,77 @@
+---
+name: operating-fleet-health-routing
+description: fleet-level gap routing and bounded-auto policy for cx-orchestrator's absorbed fleet-health synthesis duty (formerly cx-oracle). Use when handling an Oracle synthesis packet or any systemic-gap remediation routing.
+inputs: [oracle-synthesis-packet]
+artifactType: guidance
+---
+# Fleet-health routing (absorbed from cx-oracle, construct-rf26.11)
+
+Loaded on demand via `get_skill("operating/fleet-health-routing")`.
+
+`cx-oracle` retired as a standalone specialist at construct-rf26.11 (the roster-consolidation pass): it had no footprint of its own in `skills/roles/` and its declared skills were already just `ai/orchestration-workflow` (the Orchestrator's own) plus a borrowed reference to what is now the Reviewer role's trace overlay. Its meta-controller function — synthesizing fleet-health gaps from the Oracle read model and routing remediation to the specialists who own it — is folded into `cx-orchestrator`. This skill is the verbatim reference for that duty; do not paraphrase the routing table or bounded-auto policy from memory.
+
+## Scope boundary
+
+Diagnose fleet-level health and route work; do not implement fixes directly unless the gap is purely informational. Never commit, push, or merge as part of fleet-health routing.
+
+## Anti-fabrication contract
+
+Every gap cited must trace to a signal in the Oracle read model or a durable artifact path the operator can re-verify. Do not invent violation counts, success rates, or parity summaries. When a signal is absent, write `unknown`.
+
+## Inputs
+
+An Oracle synthesis packet:
+- `verdict` — `healthy` | `attention` | `degraded`
+- `gaps[]` — `{ id, severity, signal, detail, remediationRoute: { primary, secondary, gateType } }`
+- `recommendedActions[]` — `{ kind, summary, classification?, remediationRoute: { primary, gateType } }`
+- `readModel` — optional full snapshot from `collectReadModel`
+
+Treat `readModel.parity`, `readModel.contractViolations`, `readModel.doctorLog`, `readModel.outcomes`, `readModel.alignmentCensus`, and `readModel.teamGovernance` as authoritative for their domains.
+
+## Routing table
+
+| Gap signal | Primary specialist | Secondary |
+|---|---|---|
+| `parity-drift` | cx-engineer | cx-operations (if front-door rule stale) |
+| `contract-violations` | owning producer specialist from `contractId` | cx-reviewer |
+| `doctor-escalation` | cx-operations | cx-operations (beads issue) |
+| `outcomes-degradation` | cx-reviewer (fleet-trace triage mode) | specialist named in degraded role |
+| `census-stale` / alignment | cx-architect | cx-operations |
+| `observations-empty` | cx-researcher (explorer mode) | cx-engineer |
+| `team-understaffed` | cx-operations | cx-orchestrator (escalation) |
+| `escalation-path-broken` | cx-operations | cx-architect (registry) |
+| `team-decision-violation` | cx-operations | cx-orchestrator (role assignment) |
+| `cross-team-handoff-blocked` | cx-operations | owning team specialist |
+
+Note on the last four rows: the pre-consolidation routing table sent team-governance signals to `cx-rd-lead` (retired). This skill repoints them to `cx-operations`, which already owns dependency/ownership mapping and delivery logistics — the closer functional match — rather than to `cx-architect` (rd-lead's other absorbed function, pre-architecture framing). This is a construct-rf26.11 judgment call distinct from the rd-lead retirement itself; flag for reviewer override if a different owner is preferred.
+
+## Bounded-auto policy (do not override)
+
+- **Auto** (may execute without approval): `census-run`, `registry-validate`, `adapters-sync` (tool repo only)
+- **Approve** (queue to `.cx/oracle/pending.jsonl`): specialist dispatch, doctor follow-up, trace review, outcomes aggregate
+- **Deny**: git push/commit, destructive deletes, force sync
+
+## Output format
+
+```
+ORACLE ROUTING — {date}
+
+VERDICT: {verdict}
+
+GAPS:
+  [{severity}] {id} — {detail}
+    signal: {signal}
+    route: cx-{specialist}
+    handoff: {one-line DONE definition}
+
+AUTO (already executed or skipped):
+  {kind}: {status}
+
+APPROVAL QUEUE:
+  {id} {kind} — {summary}
+
+BLOCKED:
+  {reason or "none"}
+```
+
+Return DONE when every high-severity gap has a routed handoff or explicit approval-queue entry. Return BLOCKED when a required signal is missing and remediation cannot be scoped. Return NEEDS_MAIN_INPUT when human approval is required before any specialist dispatch.

package/skills/roles/ai-engineer.md

@@ -5,7 +5,7 @@ inputs: [code-diff, prompt]
 artifactType: role-guidance
 role: ai-engineer
 applies_to:
-  - cx-ai-engineer
+  - cx-engineer
 inherits: engineer
 version: 2
 scopes:

package/skills/roles/architect.md

@@ -6,7 +6,6 @@ artifactType: role-guidance
 role: architect
 applies_to:
   - cx-architect
-  - cx-rd-lead
 inherits: null
 version: 2
 scopes:

package/skills/roles/business-strategist.md

@@ -5,7 +5,7 @@ inputs: [strategy-doc, competitive-analysis]
 artifactType: guidance
 role: business-strategist
 applies_to:
-  - cx-business-strategist
+  - cx-product-manager
 inherits: null
 version: 2
 scopes:

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

@@ -6,7 +6,7 @@ artifactType: role-guidance
 role: data-analyst.telemetry
 applies_to:
   - cx-data-analyst
-  - cx-sre
+  - cx-operations
 inherits: data-analyst
 version: 2
 scopes:

package/skills/roles/data-engineer.md

@@ -5,7 +5,7 @@ inputs: [code-diff, data-pipeline]
 artifactType: role-guidance
 role: data-engineer
 applies_to:
-  - cx-data-engineer
+  - cx-engineer
 inherits: engineer
 version: 2
 scopes:

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

@@ -5,7 +5,7 @@ inputs: [pipeline-design, data-contract]
 artifactType: role-guidance
 role: data-engineer.pipeline
 applies_to:
-  - cx-data-engineer
+  - cx-engineer
 inherits: data-engineer
 version: 2
 scopes:

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

@@ -5,8 +5,7 @@ inputs: [retrieval-design, embeddings]
 artifactType: role-guidance
 role: data-engineer.vector-retrieval
 applies_to:
-  - cx-data-engineer
-  - cx-ai-engineer
+  - cx-engineer
 inherits: data-engineer
 version: 2
 scopes:

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

@@ -5,7 +5,7 @@ inputs: [warehouse-model, metrics]
 artifactType: role-guidance
 role: data-engineer.warehouse
 applies_to:
-  - cx-data-engineer
+  - cx-engineer
 inherits: data-engineer
 version: 2
 scopes:

package/skills/roles/designer.accessibility.md

@@ -5,7 +5,7 @@ inputs: [ui-design, component]
 artifactType: role-guidance
 role: designer.accessibility
 applies_to:
-  - cx-accessibility
+  - cx-designer
 inherits: designer
 version: 2
 scopes:

package/skills/roles/designer.md

@@ -6,7 +6,6 @@ artifactType: role-guidance
 role: designer
 applies_to:
   - cx-designer
-  - cx-accessibility
 inherits: null
 version: 2
 scopes:

package/skills/roles/devil-advocate.md

@@ -5,7 +5,7 @@ inputs: [plan, proposal]
 artifactType: guidance
 role: devil-advocate
 applies_to:
-  - cx-devil-advocate
+  - cx-reviewer
 inherits: reviewer
 version: 2
 scopes:

package/skills/roles/docs-keeper.md

@@ -5,7 +5,7 @@ inputs: [docs, runbook]
 artifactType: role-guidance
 role: docs-keeper
 applies_to:
-  - cx-docs-keeper
+  - cx-operations
 inherits: operations
 version: 2
 scopes:

package/skills/roles/evaluator.md

@@ -5,7 +5,7 @@ inputs: [model-output, eval-set]
 artifactType: guidance
 role: evaluator
 applies_to:
-  - cx-evaluator
+  - cx-reviewer
 inherits: reviewer
 version: 2
 scopes:

package/skills/roles/explorer.md

@@ -5,7 +5,7 @@ inputs: [repo, task-context]
 artifactType: guidance
 role: explorer
 applies_to:
-  - cx-explorer
+  - cx-researcher
 inherits: researcher
 version: 2
 scopes:

package/skills/roles/platform-engineer.md

@@ -5,7 +5,7 @@ inputs: [code-diff, internal-tooling]
 artifactType: role-guidance
 role: platform-engineer
 applies_to:
-  - cx-platform-engineer
+  - cx-engineer
 inherits: engineer
 version: 2
 scopes:

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

@@ -6,8 +6,7 @@ artifactType: guidance
 role: qa.ai-eval
 applies_to:
   - cx-qa
-  - cx-test-automation
-  - cx-evaluator
+  - cx-reviewer
 inherits: qa
 version: 2
 scopes:

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

@@ -6,7 +6,6 @@ artifactType: guidance
 role: qa.api-contract
 applies_to:
   - cx-qa
-  - cx-test-automation
 inherits: qa
 version: 2
 scopes:

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

@@ -6,7 +6,6 @@ artifactType: guidance
 role: qa.data-pipeline
 applies_to:
   - cx-qa
-  - cx-test-automation
 inherits: qa
 version: 2
 scopes:

package/skills/roles/qa.md

@@ -6,7 +6,6 @@ artifactType: guidance
 role: qa
 applies_to:
   - cx-qa
-  - cx-test-automation
 inherits: null
 version: 2
 scopes:

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

@@ -6,7 +6,6 @@ artifactType: guidance
 role: qa.web-ui
 applies_to:
   - cx-qa
-  - cx-test-automation
 inherits: qa
 version: 2
 scopes:

package/skills/roles/release-manager.md

@@ -5,7 +5,7 @@ inputs: [release-plan, changelog]
 artifactType: role-guidance
 role: release-manager
 applies_to:
-  - cx-release-manager
+  - cx-operations
 inherits: operations
 version: 2
 scopes:

package/skills/roles/researcher.md

@@ -6,8 +6,6 @@ artifactType: guidance
 role: researcher
 applies_to:
   - cx-researcher
-  - cx-ux-researcher
-  - cx-explorer
 inherits: null
 version: 2
 scopes:

package/skills/roles/reviewer.md

@@ -6,9 +6,6 @@ artifactType: review-report
 role: reviewer
 applies_to:
   - cx-reviewer
-  - cx-devil-advocate
-  - cx-evaluator
-  - cx-trace-reviewer
 inherits: null
 version: 2
 scopes:

package/skills/roles/security.ai.md

@@ -6,7 +6,7 @@ artifactType: guidance
 role: security.ai
 applies_to:
   - cx-security
-  - cx-ai-engineer
+  - cx-engineer
 inherits: security
 version: 2
 scopes:

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

@@ -5,7 +5,7 @@ inputs: [policy, task-context]
 artifactType: guidance
 role: security.legal-compliance
 applies_to:
-  - cx-legal-compliance
+  - cx-security
 inherits: security
 version: 2
 scopes:

package/skills/roles/security.md

@@ -6,7 +6,6 @@ artifactType: guidance
 role: security
 applies_to:
   - cx-security
-  - cx-legal-compliance
 inherits: null
 version: 2
 scopes:

package/skills/roles/security.privacy.md

@@ -6,7 +6,6 @@ artifactType: guidance
 role: security.privacy
 applies_to:
   - cx-security
-  - cx-legal-compliance
 inherits: security
 version: 2
 scopes:

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

@@ -6,7 +6,7 @@ artifactType: guidance
 role: security.supply-chain
 applies_to:
   - cx-security
-  - cx-platform-engineer
+  - cx-engineer
 inherits: security
 version: 2
 scopes:

package/skills/roles/sre.md

@@ -5,7 +5,7 @@ inputs: [alert-config, slo]
 artifactType: role-guidance
 role: sre
 applies_to:
-  - cx-sre
+  - cx-operations
 inherits: operations
 version: 2
 scopes:

package/skills/roles/test-automation.md

@@ -5,7 +5,7 @@ inputs: [test-suite, task-context]
 artifactType: guidance
 role: test-automation
 applies_to:
-  - cx-test-automation
+  - cx-qa
 inherits: qa
 version: 2
 scopes:

package/skills/roles/trace-reviewer.md

@@ -5,7 +5,7 @@ inputs: [trace, task-context]
 artifactType: guidance
 role: trace-reviewer
 applies_to:
-  - cx-trace-reviewer
+  - cx-reviewer
 inherits: reviewer
 version: 2
 scopes:

package/skills/roles/ux-researcher.md

@@ -5,7 +5,7 @@ inputs: [user-research, interview-data]
 artifactType: guidance
 role: ux-researcher
 applies_to:
-  - cx-ux-researcher
+  - cx-researcher
 inherits: researcher
 version: 2
 scopes: