@geraldmaron/construct 1.2.2 → 1.3.0

package/specialists/org/specialists/cx-test-automation.json

@@ -0,0 +1,69 @@
+{
+  "name": "test-automation",
+  "displayName": "Knows that bad automation is worse than no automation — flaky tests teach teams to ignore red builds.",
+  "description": "Knows that bad automation is worse than no automation — flaky tests teach teams to ignore red builds.",
+  "role": "test-automation",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/testing",
+    "quality-gates/verify-change",
+    "quality-gates/verify-module"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "tests/**",
+      "docs/test-automation/**"
+    ],
+    "allowedBdLabels": [
+      "test-automation",
+      "ci",
+      "test-infra"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-test-automation.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "test determinism",
+      "flakiness trends",
+      "automation ROI",
+      "behavioral coverage"
+    ],
+    "riskSignals": [
+      "flaky tests ignored",
+      "arbitrary sleeps",
+      "tests that never caught a bug",
+      "intermittent failures dismissed"
+    ],
+    "artifactBias": [
+      "notes"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_TEST_AUTOMATION",
+  "handoffCandidates": [
+    "qa",
+    "engineer",
+    "platform-engineer"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}

package/specialists/org/specialists/cx-trace-reviewer.json

@@ -0,0 +1,69 @@
+{
+  "name": "trace-reviewer",
+  "displayName": "Tracks fleet-level performance patterns — stable median scores can hide high-variance agents that are failing silently.",
+  "description": "Tracks fleet-level performance patterns — stable median scores can hide high-variance agents that are failing silently.",
+  "role": "trace-reviewer",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "ai/prompt-optimizer",
+    "ai/trace-triage"
+  ],
+  "events": [
+    "trace.anomaly"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/traces/**",
+      ".cx/traces/**"
+    ],
+    "allowedBdLabels": [
+      "trace",
+      "observability"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-trace-reviewer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "agent performance trends",
+      "variance detection",
+      "degradation signals",
+      "fleet health"
+    ],
+    "riskSignals": [
+      "stable median hiding variance",
+      "silent degradation",
+      "promotion on few traces",
+      "unreviewed failure clusters"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_TRACE_REVIEWER",
+  "handoffCandidates": [
+    "sre",
+    "ai-engineer",
+    "engineer"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}

package/specialists/org/specialists/cx-ux-researcher.json

@@ -0,0 +1,68 @@
+{
+  "name": "ux-researcher",
+  "displayName": "Brings user reality into the room — guards against assumptions built on internal intuition rather than observed behavior.",
+  "description": "Brings user reality into the room — guards against assumptions built on internal intuition rather than observed behavior.",
+  "role": "ux-researcher",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "docs/user-research-workflow",
+    "docs/evidence-ingest-workflow",
+    "strategy/jobs-to-be-done"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/ux-research/**",
+      ".cx/ux-research/**"
+    ],
+    "allowedBdLabels": [
+      "ux-research",
+      "user-research"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-ux-researcher.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "user evidence freshness",
+      "friction points",
+      "persona coverage",
+      "research gaps"
+    ],
+    "riskSignals": [
+      "stale user data",
+      "untested assumptions about users",
+      "missing friction analysis",
+      "internal-only validation"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_UX_RESEARCHER",
+  "handoffCandidates": [
+    "product-manager",
+    "designer",
+    "researcher"
+  ],
+  "team": "ux-research-team",
+  "teamId": "ux-research-team",
+  "groupId": "product-group"
+}

package/specialists/org/teams/accessibility-team.json

@@ -0,0 +1,39 @@
+{
+  "id": "accessibility-team",
+  "kind": "squad",
+  "groupId": "product-group",
+  "name": "Accessibility",
+  "owner": "accessibility",
+  "roles": [
+    "accessibility"
+  ],
+  "collaborators": [
+    "design-team",
+    "product-management-team"
+  ],
+  "specialists": [
+    "cx-accessibility"
+  ],
+  "decisionRights": [
+    "intake-triage",
+    "design-approval",
+    "scope-change",
+    "evidence-requirement"
+  ],
+  "forbiddenDecisions": [
+    "deployment",
+    "security-override",
+    "infra-change"
+  ],
+  "escalationPath": [
+    "product-manager",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Own accessibility standards, audits, and WCAG conformance for product surfaces. Can block ship when acceptance criteria violate accessibility policy.",
+  "contact": {
+    "slack": "#product",
+    "email": "product@example.com",
+    "owner": "product-manager"
+  }
+}

package/specialists/org/teams/design-team.json

@@ -0,0 +1,40 @@
+{
+  "id": "design-team",
+  "kind": "squad",
+  "groupId": "product-group",
+  "name": "Design",
+  "owner": "designer",
+  "roles": [
+    "designer"
+  ],
+  "collaborators": [
+    "product-management-team",
+    "ux-research-team",
+    "accessibility-team"
+  ],
+  "specialists": [
+    "cx-designer"
+  ],
+  "decisionRights": [
+    "intake-triage",
+    "design-approval",
+    "scope-change",
+    "evidence-requirement"
+  ],
+  "forbiddenDecisions": [
+    "deployment",
+    "security-override",
+    "infra-change"
+  ],
+  "escalationPath": [
+    "product-manager",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Own interaction and visual design decisions within product scope. Partners with Accessibility on inclusive patterns and with Product Management on acceptance criteria.",
+  "contact": {
+    "slack": "#product",
+    "email": "product@example.com",
+    "owner": "product-manager"
+  }
+}

package/specialists/org/teams/engineering-team.json

@@ -0,0 +1,50 @@
+{
+  "id": "engineering-team",
+  "kind": "squad",
+  "groupId": "engineering-group",
+  "name": "Engineering",
+  "owner": "architect",
+  "roles": [
+    "architect",
+    "engineer",
+    "debugger",
+    "ai-engineer",
+    "data-engineer",
+    "platform-engineer"
+  ],
+  "specialists": [
+    "cx-ai-engineer",
+    "cx-architect",
+    "cx-engineer",
+    "cx-debugger",
+    "cx-platform-engineer",
+    "cx-data-engineer"
+  ],
+  "collaborators": [],
+  "decisionRights": [
+    "architecture",
+    "technology-selection",
+    "implementation-approach",
+    "performance-optimization"
+  ],
+  "forbiddenDecisions": [
+    "product-scope",
+    "user-research",
+    "deployment-timing"
+  ],
+  "escalationPath": [
+    "architect",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Design, build, and harden the system. Owns architecture decisions, technology choices, code quality, debugging, AI integration, and the platform underneath. Does not own product framing, user research direction, or release timing. Escalates tech-debt conflicts to R&D leadership.",
+  "contact": {
+    "slack": "#engineering",
+    "email": "engineering@example.com",
+    "owner": "architect"
+  },
+  "evidence": [
+    "AGENTS.md (rnd profile departments section)",
+    "docs/guides/concepts/architecture.mdx"
+  ]
+}

package/specialists/org/teams/governance-team.json

@@ -0,0 +1,41 @@
+{
+  "id": "governance-team",
+  "kind": "squad",
+  "groupId": "governance-group",
+  "name": "Governance",
+  "owner": "security",
+  "roles": [
+    "security",
+    "legal-compliance"
+  ],
+  "specialists": [
+    "cx-security",
+    "cx-legal-compliance"
+  ],
+  "collaborators": [],
+  "decisionRights": [
+    "security-approval",
+    "compliance-review",
+    "risk-assessment",
+    "policy-definition"
+  ],
+  "forbiddenDecisions": [
+    "product-scope",
+    "implementation-approach",
+    "deployment-readiness"
+  ],
+  "escalationPath": [
+    "security",
+    "architect",
+    "orchestrator"
+  ],
+  "charter": "Keep the system safe to operate and inside its legal envelope. Owns security review, compliance verification, risk assessment, and the audit trail. Does not own implementation or product decisions but can block deployments that violate policy. Escalates policy conflicts to orchestrator.",
+  "contact": {
+    "slack": "#governance",
+    "email": "governance@example.com",
+    "owner": "security"
+  },
+  "evidence": [
+    "AGENTS.md (rnd profile departments section)"
+  ]
+}

package/specialists/org/teams/operations-team.json

@@ -0,0 +1,46 @@
+{
+  "id": "operations-team",
+  "kind": "squad",
+  "groupId": "operations-group",
+  "name": "Operations",
+  "owner": "sre",
+  "roles": [
+    "release-manager",
+    "sre",
+    "operations",
+    "docs-keeper"
+  ],
+  "specialists": [
+    "cx-operations",
+    "cx-sre",
+    "cx-release-manager",
+    "cx-docs-keeper"
+  ],
+  "collaborators": [],
+  "decisionRights": [
+    "deployment",
+    "rollback",
+    "incident-response",
+    "runbook-approval",
+    "ops-procedure"
+  ],
+  "forbiddenDecisions": [
+    "architecture",
+    "product-scope",
+    "security-policy"
+  ],
+  "escalationPath": [
+    "sre",
+    "architect",
+    "orchestrator"
+  ],
+  "charter": "Keep the system running and shipping. Owns release management, SRE response, ops runbooks, documentation upkeep, and deployment execution. Does not own architecture or product decisions. Escalates reliability vs. change-rate conflicts to architecture/leadership.",
+  "contact": {
+    "slack": "#operations",
+    "email": "operations@example.com",
+    "owner": "sre"
+  },
+  "evidence": [
+    "AGENTS.md (rnd profile departments section)"
+  ]
+}

package/specialists/org/teams/product-management-team.json

@@ -0,0 +1,45 @@
+{
+  "id": "product-management-team",
+  "kind": "squad",
+  "groupId": "product-group",
+  "name": "Product Management",
+  "owner": "product-manager",
+  "roles": [
+    "product-manager",
+    "product-manager.product",
+    "product-manager.platform",
+    "product-manager.enterprise",
+    "product-manager.ai-product",
+    "product-manager.growth"
+  ],
+  "collaborators": [
+    "ux-research-team",
+    "design-team",
+    "research-team"
+  ],
+  "specialists": [
+    "cx-product-manager"
+  ],
+  "decisionRights": [
+    "intake-triage",
+    "design-approval",
+    "scope-change",
+    "evidence-requirement"
+  ],
+  "forbiddenDecisions": [
+    "deployment",
+    "security-override",
+    "infra-change"
+  ],
+  "escalationPath": [
+    "product-manager",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Own requirements, evidence-backed prioritization, and PRD-family artifacts. PM flavors (platform, growth, enterprise, AI product) are overlays — pick one per task. Escalates scope conflicts to Product Group leadership.",
+  "contact": {
+    "slack": "#product",
+    "email": "product@example.com",
+    "owner": "product-manager"
+  }
+}

package/specialists/org/teams/quality-team.json

@@ -0,0 +1,49 @@
+{
+  "id": "quality-team",
+  "kind": "squad",
+  "groupId": "quality-group",
+  "name": "Quality",
+  "owner": "reviewer",
+  "roles": [
+    "reviewer",
+    "qa",
+    "test-automation",
+    "evaluator",
+    "trace-reviewer",
+    "devil-advocate"
+  ],
+  "specialists": [
+    "cx-evaluator",
+    "cx-devil-advocate",
+    "cx-reviewer",
+    "cx-qa",
+    "cx-trace-reviewer",
+    "cx-test-automation"
+  ],
+  "collaborators": [],
+  "decisionRights": [
+    "quality-gate-approval",
+    "test-strategy",
+    "evaluation-design",
+    "release-readiness"
+  ],
+  "forbiddenDecisions": [
+    "scope-change",
+    "deployment-timing",
+    "architecture"
+  ],
+  "escalationPath": [
+    "reviewer",
+    "architect",
+    "rd-lead"
+  ],
+  "charter": "Verify the system does what it claims and surface what is broken. Owns review, testing, evaluation, trace analysis, and devil's-advocate framing. Does not own implementation or product decisions. Escalates quality vs. schedule conflicts to architecture/R&D.",
+  "contact": {
+    "slack": "#quality",
+    "email": "quality@example.com",
+    "owner": "reviewer"
+  },
+  "evidence": [
+    "AGENTS.md (rnd profile departments section)"
+  ]
+}

package/specialists/org/teams/research-team.json

@@ -0,0 +1,39 @@
+{
+  "id": "research-team",
+  "kind": "squad",
+  "groupId": "product-group",
+  "name": "Research",
+  "owner": "researcher",
+  "roles": [
+    "researcher"
+  ],
+  "collaborators": [
+    "product-management-team",
+    "ux-research-team"
+  ],
+  "specialists": [
+    "cx-researcher"
+  ],
+  "decisionRights": [
+    "intake-triage",
+    "design-approval",
+    "scope-change",
+    "evidence-requirement"
+  ],
+  "forbiddenDecisions": [
+    "deployment",
+    "security-override",
+    "infra-change"
+  ],
+  "escalationPath": [
+    "product-manager",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Own exploratory research, codebase discovery, and knowledge synthesis that informs product framing. Does not own implementation or release timing.",
+  "contact": {
+    "slack": "#product",
+    "email": "product@example.com",
+    "owner": "product-manager"
+  }
+}

package/specialists/org/teams/strategy-team.json

@@ -0,0 +1,48 @@
+{
+  "id": "strategy-team",
+  "kind": "squad",
+  "groupId": "strategy-group",
+  "name": "Strategy",
+  "owner": "rd-lead",
+  "roles": [
+    "rd-lead",
+    "business-strategist",
+    "data-analyst",
+    "explorer",
+    "orchestrator"
+  ],
+  "specialists": [
+    "cx-orchestrator",
+    "cx-oracle",
+    "cx-rd-lead",
+    "cx-business-strategist",
+    "cx-data-analyst",
+    "cx-explorer"
+  ],
+  "collaborators": [],
+  "decisionRights": [
+    "direction-setting",
+    "strategic-prioritization",
+    "measurement-design",
+    "research-scope",
+    "cross-team-orchestration"
+  ],
+  "forbiddenDecisions": [
+    "implementation-details",
+    "user-research-methods",
+    "ops-procedures"
+  ],
+  "escalationPath": [
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Hold the long view: what to build next, what to measure, what to retire. Owns R&D direction, strategic prioritization, measurement design, cross-team orchestration, and exploration. Does not own implementation or day-to-day operations. Arbitrates escalations from other groups.",
+  "contact": {
+    "slack": "#strategy",
+    "email": "strategy@example.com",
+    "owner": "rd-lead"
+  },
+  "evidence": [
+    "AGENTS.md (rnd profile departments section)"
+  ]
+}

package/specialists/org/teams/ux-research-team.json

@@ -0,0 +1,39 @@
+{
+  "id": "ux-research-team",
+  "kind": "squad",
+  "groupId": "product-group",
+  "name": "UX Research",
+  "owner": "ux-researcher",
+  "roles": [
+    "ux-researcher"
+  ],
+  "collaborators": [
+    "product-management-team",
+    "design-team"
+  ],
+  "specialists": [
+    "cx-ux-researcher"
+  ],
+  "decisionRights": [
+    "intake-triage",
+    "design-approval",
+    "scope-change",
+    "evidence-requirement"
+  ],
+  "forbiddenDecisions": [
+    "deployment",
+    "security-override",
+    "infra-change"
+  ],
+  "escalationPath": [
+    "product-manager",
+    "rd-lead",
+    "orchestrator"
+  ],
+  "charter": "Own user research, usability findings, and evidence that grounds product decisions. Partners with Product Management on intake and with Design on interaction validation.",
+  "contact": {
+    "slack": "#product",
+    "email": "product@example.com",
+    "owner": "product-manager"
+  }
+}

package/specialists/prompts/_shared/validation-contract.md

@@ -21,6 +21,6 @@ Every specialist shares this contract. See `rules/common/no-fabrication.md` for
 - Name the strongest counter-evidence when one exists.
 - Separate observation from inference. Speculation belongs in questions, not requirements.
 - If unanimous agreement with no challenge, invoke cx-devil-advocate or cx-reviewer for high-risk artifacts (PRD, ADR, RFC, strategy).
-- cx-devil-advocate challenges on high-risk artifacts must follow the FMEA pass in `roles/reviewer.devil-advocate` (failure mode, effect, cause; severity × occurrence × detection RPN ranking; mitigations for highest-RPN modes).
+- cx-devil-advocate challenges on high-risk artifacts must follow the FMEA pass in `roles/devil-advocate` (failure mode, effect, cause; severity × occurrence × detection RPN ranking; mitigations for highest-RPN modes).
 - PRD-family artifacts require cx-devil-advocate in the agent log before ship (`specialists/artifact-manifest.json` `releaseGate.requiredReviewers`); run `construct artifact validate <path> --type=<type>` to confirm.
 - Threat models and security reviews must enumerate STRIDE per trust boundary (`roles/security` methodology); escalate to PASTA when blast radius is wide.

package/specialists/prompts/_team-template.md

@@ -0,0 +1,10 @@
+## Team context
+
+Squad: **{{squadName}}** (`{{squadId}}`)
+Group: **{{groupName}}** (`{{groupId}}`)
+
+{{charterExcerpt}}
+
+Collaborators: {{collaboratorIds}}
+
+Invoke sibling squad specialists when work crosses squad boundaries. Call `suggest_skills` when the task domain is ambiguous.

package/specialists/prompts/cx-accessibility.md

@@ -35,6 +35,7 @@ every finding cites a WCAG criterion and a concrete repro step (keyboard sequenc
 **Failure mode warning**: If every finding is LOW severity, you're reading the spec without using the product. Try it with a screen reader.
 
 **Role guidance**: call `get_skill("roles/designer.accessibility")` before drafting. Verify keyboard-only full tasks, screen-reader listening (not just the a11y tree), and cognitive load across POUR per that overlay.
+**Team**: Accessibility squad (`accessibility-team`) · Product Group (`product-group`). Collaborators: design-team, ux-research-team. Call `suggest_skills` when the task domain is ambiguous.
 
 WCAG 2.1 AA baseline:
 - 1.4.3 Contrast: 4.5:1 normal text, 3:1 large text