@geraldmaron/construct 1.2.2 → 1.3.0

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": ""
+}

package/specialists/org/contracts/any-to-trace-reviewer.json

@@ -0,0 +1,32 @@
+{
+  "id": "any-to-trace-reviewer",
+  "producer": "*",
+  "consumer": "cx-trace-reviewer",
+  "trigger": {
+    "trace.anomaly": true
+  },
+  "input": {
+    "shape": "trace-analysis-request",
+    "mustContain": [
+      "scope",
+      "window"
+    ]
+  },
+  "output": {
+    "shape": "trace-analysis",
+    "mustContain": [
+      "flaggedAgents",
+      "evidence",
+      "recommendation"
+    ]
+  },
+  "preconditions": [
+    "Trace backend reachable via the configured `CONSTRUCT_TRACE_BACKEND` adapter"
+  ],
+  "postconditions": [
+    "Every performance claim cites the trace id and span",
+    "Promotion verdicts cite the staging-vs-production score delta, not a vibe",
+    "Variance and trend reported alongside median; stable medians that hide tail variance are surfaced"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/architect-to-ai-engineer.json

@@ -0,0 +1,32 @@
+{
+  "id": "architect-to-ai-engineer",
+  "producer": "cx-architect",
+  "consumer": "cx-ai-engineer",
+  "trigger": {
+    "riskFlags": [
+      "ai"
+    ],
+    "intent": [
+      "implementation"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "evalCriteria"
+    ]
+  },
+  "output": {
+    "schema": "lib/contract-schemas/implementation.json",
+    "type": "implementation"
+  },
+  "preconditions": [
+    "Eval set defined with failure cases before prompt/model changes ship"
+  ],
+  "postconditions": [
+    "Eval verdict from cx-evaluator before DONE"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/architect-to-data-engineer.json

@@ -0,0 +1,52 @@
+{
+  "id": "architect-to-data-engineer",
+  "producer": "cx-architect",
+  "consumer": "cx-data-engineer",
+  "trigger": {
+    "riskFlags": [
+      "data",
+      "pipeline"
+    ],
+    "intent": [
+      "implementation"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "dataContracts"
+    ]
+  },
+  "output": {
+    "shape": "pipeline-spec",
+    "mustContain": [
+      "dataContract",
+      "schema",
+      "qualityGates",
+      "retryPolicy"
+    ]
+  },
+  "preconditions": [
+    "Data volume, latency requirements, and existing stack clarified before architecture proposed",
+    "Existing schema inspected; column names and table relationships not invented"
+  ],
+  "postconditions": [
+    "Pipeline is idempotent and observable; not running on faith",
+    "Data contract is written down; quality gates defined as part of the design",
+    {
+      "id": "pipeline-spec-has-idempotency-plan",
+      "description": "Pipeline spec must contain an Idempotency Plan section",
+      "check": "artifact-has-section",
+      "section": "Idempotency Plan"
+    },
+    {
+      "id": "pipeline-spec-has-observability",
+      "description": "Pipeline spec must contain an Observability section",
+      "check": "artifact-has-section",
+      "section": "Observability"
+    }
+  ],
+  "description": ""
+}

package/specialists/org/contracts/architect-to-devil-advocate.json

@@ -0,0 +1,38 @@
+{
+  "id": "architect-to-devil-advocate",
+  "producer": "cx-architect",
+  "consumer": "cx-devil-advocate",
+  "trigger": {
+    "framingChallenge.required": true
+  },
+  "input": {
+    "shape": "framing-proposal",
+    "mustContain": [
+      "problemStatement",
+      "proposedApproach",
+      "assumptions"
+    ]
+  },
+  "output": {
+    "shape": "challenge-report",
+    "mustContain": [
+      "verdict",
+      "counterevidence",
+      "reframingProposals"
+    ]
+  },
+  "preconditions": [
+    "Problem statement stated independent of tickets/transcripts"
+  ],
+  "postconditions": [
+    "If verdict is BLOCKED, architect revises framing before proceeding",
+    "Challenge checkpoint logged to audit trail"
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "engineering-group",
+    "consumerTeam": "quality-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/architect-to-engineer.json

@@ -0,0 +1,34 @@
+{
+  "id": "architect-to-engineer",
+  "producer": "cx-architect",
+  "consumer": "cx-engineer",
+  "trigger": {
+    "intent": [
+      "implementation",
+      "fix"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "tasks",
+      "acceptanceCriteria"
+    ]
+  },
+  "output": {
+    "schema": "lib/contract-schemas/implementation.json",
+    "type": "implementation"
+  },
+  "preconditions": [
+    "ADR approved (or fast-track noted); no pending CRITICAL review findings",
+    "Task packet contains readFirst and doNotChange lists"
+  ],
+  "postconditions": [
+    "Implementation cites the ADR tasks it completed",
+    "filesChanged matches tasks in the ADR",
+    "verificationChecklist evaluated before DONE"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/architect-to-evaluator.json

@@ -0,0 +1,59 @@
+{
+  "id": "architect-to-evaluator",
+  "producer": "cx-architect",
+  "consumer": "cx-evaluator",
+  "trigger": {
+    "riskFlags": [
+      "ai",
+      "quality"
+    ],
+    "intent": [
+      "implementation"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "evalCriteria"
+    ]
+  },
+  "output": {
+    "shape": "eval-spec",
+    "mustContain": [
+      "evaluationCriteria",
+      "scoringRubric",
+      "testCases",
+      "comparisonProtocol",
+      "passFailThreshold"
+    ]
+  },
+  "preconditions": [
+    "What 'better' means is defined in writing before the work is done",
+    "Baseline run identified or scheduled before proposed change runs"
+  ],
+  "postconditions": [
+    "Failing case is defined before results are seen",
+    "Regression checks enumerated; not just success-path test cases",
+    {
+      "id": "eval-spec-has-success-criteria",
+      "description": "Eval spec must contain a Success Criteria section",
+      "check": "artifact-has-section",
+      "section": "Success Criteria"
+    },
+    {
+      "id": "eval-spec-has-baseline",
+      "description": "Eval spec must contain a Baseline section",
+      "check": "artifact-has-section",
+      "section": "Baseline"
+    }
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "engineering-group",
+    "consumerTeam": "quality-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/architect-to-legal-compliance.json

@@ -0,0 +1,55 @@
+{
+  "id": "architect-to-legal-compliance",
+  "producer": "cx-architect",
+  "consumer": "cx-legal-compliance",
+  "trigger": {
+    "riskFlags": [
+      "compliance",
+      "privacy",
+      "licensing"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "dataFlows"
+    ]
+  },
+  "output": {
+    "shape": "compliance-memo",
+    "mustContain": [
+      "risks",
+      "severity",
+      "remediation"
+    ]
+  },
+  "preconditions": [
+    "Data flows enumerated: what is collected, stored, processed, and exported",
+    "Dependency tree surfaced past the first layer for licensing review"
+  ],
+  "postconditions": [
+    "Every assertion cites the regulation, standard, or contract clause it rests on",
+    "AI-generated user-facing content has a disclosure strategy noted, or is marked not-applicable with reason",
+    {
+      "id": "compliance-memo-has-regulatory-citations",
+      "description": "Compliance memo must contain a Regulatory Citations section",
+      "check": "artifact-has-section",
+      "section": "Regulatory Citations"
+    },
+    {
+      "id": "compliance-memo-has-remediation-plan",
+      "description": "Compliance memo must contain a Remediation Plan section",
+      "check": "artifact-has-section",
+      "section": "Remediation Plan"
+    }
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "engineering-group",
+    "consumerTeam": "governance-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/architect-to-operations.json

@@ -0,0 +1,45 @@
+{
+  "id": "architect-to-operations",
+  "producer": "cx-architect",
+  "consumer": "cx-operations",
+  "trigger": {
+    "intent": [
+      "implementation"
+    ],
+    "workCategory": "deep"
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "tasks",
+      "acceptanceCriteria"
+    ]
+  },
+  "output": {
+    "shape": "ops-plan",
+    "mustContain": [
+      "sequencedTasks",
+      "dependencyGraph",
+      "ownershipMatrix",
+      "verificationGates"
+    ]
+  },
+  "preconditions": [
+    "Architect plan and devil-advocate feedback resolved",
+    "Tasks are atomic and individually verifiable"
+  ],
+  "postconditions": [
+    "Every task names a single owner",
+    "Every task names a verification gate and definition-of-done",
+    "Dependency graph identifies blockers; no task lies on a hidden critical path"
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "engineering-group",
+    "consumerTeam": "operations-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/architect-to-platform-engineer.json

@@ -0,0 +1,42 @@
+{
+  "id": "architect-to-platform-engineer",
+  "producer": "cx-architect",
+  "consumer": "cx-platform-engineer",
+  "trigger": {
+    "riskFlags": [
+      "platform",
+      "infrastructure"
+    ],
+    "intent": [
+      "implementation"
+    ]
+  },
+  "input": {
+    "schema": "lib/contract-schemas/decision.json",
+    "mustContain": [
+      "goal",
+      "approach",
+      "platformDependencies"
+    ]
+  },
+  "output": {
+    "shape": "platform-plan",
+    "mustContain": [
+      "problem",
+      "solution",
+      "impact",
+      "migration",
+      "rollback"
+    ]
+  },
+  "preconditions": [
+    "Observed friction quantified; not hypothetical future problems",
+    "Existing CI/CD and tooling surveyed before proposing new tooling"
+  ],
+  "postconditions": [
+    "Migration path described for existing workflows",
+    "Rollback procedure exists in case the change makes things worse",
+    "Improvement removes more configuration than it adds, or the added config is justified"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/business-strategist-to-product-manager.json

@@ -0,0 +1,39 @@
+{
+  "id": "business-strategist-to-product-manager",
+  "producer": "cx-business-strategist",
+  "consumer": "cx-product-manager",
+  "trigger": {
+    "strategy.required": true
+  },
+  "input": {
+    "shape": "strategic-memo",
+    "mustContain": [
+      "strategicContext",
+      "recommendation",
+      "evidence"
+    ]
+  },
+  "output": {
+    "shape": "prd-handoff",
+    "mustContain": [
+      "problem",
+      "users",
+      "functionalRequirements",
+      "acceptanceCriteria"
+    ]
+  },
+  "preconditions": [
+    "Strategic memo signed off; recommended option carried into PRD framing"
+  ],
+  "postconditions": [
+    "PRD Problem statement traces to the strategic memo's market context, not to internal roadmap items",
+    "PRD acknowledges the competitive dynamic named in the strategic memo"
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "strategy-group",
+    "consumerTeam": "product-group",
+    "requiresApprovalFrom": []
+  }
+}

package/specialists/org/contracts/construct-to-orchestrator.json

@@ -0,0 +1,36 @@
+{
+  "id": "construct-to-orchestrator",
+  "producer": "construct",
+  "consumer": "cx-orchestrator",
+  "trigger": {
+    "track": "orchestrated"
+  },
+  "input": {
+    "shape": "task-packet",
+    "mustContain": [
+      "goal",
+      "intent",
+      "workCategory",
+      "riskFlags",
+      "acceptanceCriteria"
+    ]
+  },
+  "output": {
+    "schema": "lib/contract-schemas/decision.json",
+    "type": "decision"
+  },
+  "preconditions": [
+    "framingChallenge gate honored if required",
+    "externalResearch gate honored if required",
+    "docAuthoring.owner present if authoring a typed document"
+  ],
+  "postconditions": [
+    "Dispatch plan emitted with specialists in sequence",
+    "Parallel work marked with [parallel: ...] tags"
+  ],
+  "skillHints": [
+    "ai/orchestration-workflow",
+    "operating/orchestration-reference"
+  ],
+  "description": ""
+}

package/specialists/org/contracts/construct-to-rd-lead.json

@@ -0,0 +1,53 @@
+{
+  "id": "construct-to-rd-lead",
+  "producer": "construct",
+  "consumer": "cx-rd-lead",
+  "trigger": {
+    "framingChallenge.required": true
+  },
+  "input": {
+    "shape": "framing-request",
+    "mustContain": [
+      "goal",
+      "uncertainty",
+      "assumptions"
+    ]
+  },
+  "output": {
+    "shape": "framing-brief",
+    "mustContain": [
+      "problemStatement",
+      "hypothesis",
+      "keyUnknowns",
+      "evidenceThreshold",
+      "recommendation"
+    ]
+  },
+  "preconditions": [
+    "Framing gate fires before architecture work begins",
+    "Strategy bets and non-bets reviewed in `.cx/knowledge/decisions/strategy/`"
+  ],
+  "postconditions": [
+    "Hypothesis is falsifiable and stated as 'We believe [X] will result in [Y] because [Z].'",
+    "Evidence threshold names a specific result that would confirm or disconfirm",
+    {
+      "id": "rd-framing-has-problem-section",
+      "description": "Framing artifact must contain a Problem section",
+      "check": "artifact-has-section",
+      "section": "Problem"
+    },
+    {
+      "id": "rd-framing-has-constraints-section",
+      "description": "Framing artifact must contain a Constraints section",
+      "check": "artifact-has-section",
+      "section": "Constraints"
+    },
+    {
+      "id": "rd-framing-has-open-questions-section",
+      "description": "Framing artifact must contain an Open Questions section",
+      "check": "artifact-has-section",
+      "section": "Open Questions"
+    }
+  ],
+  "description": ""
+}

package/specialists/org/contracts/data-analyst-to-product-manager.json

@@ -0,0 +1,43 @@
+{
+  "id": "data-analyst-to-product-manager",
+  "producer": "cx-data-analyst",
+  "consumer": "cx-product-manager",
+  "trigger": {
+    "docAuthoring.docType": [
+      "prd",
+      "meta-prd"
+    ],
+    "riskFlags": [
+      "metrics"
+    ]
+  },
+  "input": {
+    "shape": "metrics-analysis",
+    "mustContain": [
+      "metricDefinition",
+      "baseline",
+      "successThreshold"
+    ]
+  },
+  "output": {
+    "shape": "prd-handoff",
+    "mustContain": [
+      "acceptanceCriteria",
+      "successMetrics"
+    ]
+  },
+  "preconditions": [
+    "Metric definition reviewed for vanity-metric risk and for hit-without-solving-the-problem risk"
+  ],
+  "postconditions": [
+    "PRD success metrics carry the cited baseline and threshold from the analysis",
+    "Metrics that can be hit without solving the problem are flagged and replaced"
+  ],
+  "description": "",
+  "teamBoundary": {
+    "crosses": true,
+    "producerTeam": "strategy-group",
+    "consumerTeam": "product-group",
+    "requiresApprovalFrom": []
+  }
+}