@geraldmaron/construct 1.4.1 → 1.5.0

package/specialists/org/groups/product-group.json

@@ -4,10 +4,8 @@
   "owner": "product-manager",
   "roles": [
     "product-manager",
-    "ux-researcher",
     "designer",
-    "researcher",
-    "accessibility"
+    "researcher"
   ],
   "decisionRights": [
     "intake-triage",
@@ -22,10 +20,10 @@
   ],
   "escalationPath": [
     "product-manager",
-    "rd-lead",
+    "architect",
     "orchestrator"
   ],
-  "charter": "Translate user reality into shippable change. Owns problem framing, requirements, evidence gathering, design decisions, and acceptance criteria. Does not own implementation choices, deployment decisions, or security policy. Escalates scope conflicts to R&D leadership.",
+  "charter": "Translate user reality into shippable change. Owns problem framing, requirements, evidence gathering, design decisions, and acceptance criteria — including strategic/market framing (business-strategist), accessibility (designer), and user/UX + codebase research (researcher), all folded in at construct-rf26.11. Does not own implementation choices, deployment decisions, or security policy.",
   "contact": {
     "slack": "#product",
     "email": "product@example.com",
@@ -38,9 +36,7 @@
   "kind": "group",
   "squads": [
     "product-management-team",
-    "ux-research-team",
     "design-team",
-    "research-team",
-    "accessibility-team"
+    "research-team"
   ]
 }

package/specialists/org/groups/quality-group.json

@@ -4,11 +4,7 @@
   "owner": "reviewer",
   "roles": [
     "reviewer",
-    "qa",
-    "test-automation",
-    "evaluator",
-    "trace-reviewer",
-    "devil-advocate"
+    "qa"
   ],
   "decisionRights": [
     "quality-gate-approval",
@@ -24,9 +20,9 @@
   "escalationPath": [
     "reviewer",
     "architect",
-    "rd-lead"
+    "orchestrator"
   ],
-  "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.",
+  "charter": "Verify the system does what it claims and surface what is broken. Owns code review, plan-challenge framing, AI/eval rigor, and fleet-level trace analysis (devil-advocate, evaluator, trace-reviewer folded into cx-reviewer; test-automation folded into cx-qa; construct-rf26.11), plus test strategy and automation. Does not own implementation or product decisions. Escalates quality vs. schedule conflicts to architecture.",
   "contact": {
     "slack": "#quality",
     "email": "quality@example.com",

package/specialists/org/groups/strategy-group.json

@@ -1,13 +1,10 @@
 {
   "id": "strategy-group",
   "name": "Strategy Group",
-  "owner": "rd-lead",
+  "owner": "orchestrator",
   "roles": [
-    "rd-lead",
-    "business-strategist",
-    "data-analyst",
-    "explorer",
-    "orchestrator"
+    "orchestrator",
+    "data-analyst"
   ],
   "decisionRights": [
     "direction-setting",
@@ -22,14 +19,14 @@
     "ops-procedures"
   ],
   "escalationPath": [
-    "rd-lead",
+    "architect",
     "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.",
+  "charter": "Hold the long view on measurement and cross-team dispatch. Owns metrics/measurement design (cx-data-analyst) and cross-team orchestration (cx-orchestrator). R&D framing-gate duties folded into cx-architect and exploration folded into cx-researcher (rd-lead and explorer retired/folded; construct-rf26.11) — this group no longer owns R&D direction or exploration directly. Does not own implementation or day-to-day operations.",
   "contact": {
     "slack": "#strategy",
     "email": "strategy@example.com",
-    "owner": "rd-lead"
+    "owner": "orchestrator"
   },
   "evidence": [
     "AGENTS.md (rnd profile departments section)"

package/specialists/org/models.json.example

@@ -0,0 +1,8 @@
+{
+  "_comment": "Starter model registry. Copy to models.json to activate operator-supplied tier defaults. Construct ships no active models.json: an unconfigured machine degrades honestly (no implicit model defaults) rather than resolving a model whose credentials may be absent. Precedence when active: CX_MODEL_<TIER> / CONSTRUCT_MODEL_<TIER> env pins ALWAYS win; registry tiers below fill only the tiers no env pin sets. Each tier is either a bare model id string or {\"primary\": id, \"fallback\": [ids]}. Resolution uses the primary.",
+  "models": {
+    "reasoning": { "primary": "anthropic/claude-opus-4-6", "fallback": ["anthropic/claude-sonnet-4-6"] },
+    "standard": { "primary": "anthropic/claude-sonnet-4-6", "fallback": ["anthropic/claude-opus-4-6"] },
+    "fast": { "primary": "anthropic/claude-haiku-4-5-20251001", "fallback": ["anthropic/claude-sonnet-4-6"] }
+  }
+}

package/specialists/org/scopes/creative.json

@@ -35,7 +35,12 @@
     "sessionReflect": "on",
     "sessionOptimize": "on"
   },
-  "defaultSkills": [],
+  "defaultSkills": [
+    "docs/user-research-workflow",
+    "strategy/narrative-arc",
+    "docs/memo-and-decision-capture",
+    "quality-gates/review-work"
+  ],
   "toneDefaults": {
     "one-pager": "friendly",
     "memo": "friendly",

package/specialists/org/scopes/operations.json

@@ -33,7 +33,13 @@
     "sessionReflect": "on",
     "sessionOptimize": "on"
   },
-  "defaultSkills": [],
+  "defaultSkills": [
+    "operating/incident-response",
+    "operating/oncall-rotation",
+    "operating/change-management",
+    "docs/runbook-workflow",
+    "quality-gates/verify-change"
+  ],
   "toneDefaults": {
     "runbook": "blameless",
     "incident-report": "blameless",

package/specialists/org/scopes/research.json

@@ -33,7 +33,12 @@
     "sessionReflect": "on",
     "sessionOptimize": "on"
   },
-  "defaultSkills": [],
+  "defaultSkills": [
+    "docs/research-workflow",
+    "docs/evidence-ingest-workflow",
+    "docs/transcript-synthesis",
+    "strategy/market-research-methods"
+  ],
   "toneDefaults": {
     "research-brief": "direct",
     "evidence-brief": "direct",

package/specialists/org/scopes/rnd.json

@@ -53,7 +53,13 @@
     "sessionReflect": "on",
     "sessionOptimize": "on"
   },
-  "defaultSkills": [],
+  "defaultSkills": [
+    "docs/prd-workflow",
+    "docs/adr-workflow",
+    "docs/research-workflow",
+    "quality-gates/verify-change",
+    "operating/incident-response"
+  ],
   "toneDefaults": {
     "prd": "decision-forcing-direct",
     "prfaq": "friendly",

package/specialists/org/specialists/cx-architect.json

@@ -10,11 +10,15 @@
     "architecture/caching",
     "architecture/cloud-native",
     "architecture/message-queue",
-    "architecture/security-arch"
+    "architecture/security-arch",
+    "ai/agent-dev",
+    "ai/prompt-and-eval",
+    "docs/research-workflow"
   ],
   "events": [
     "adr.requested",
-    "arch.boundary.violated"
+    "arch.boundary.violated",
+    "research.gate.required"
   ],
   "fence": {
     "allowedPaths": [
@@ -24,13 +28,20 @@
       "docs/rfc/**",
       "docs/guides/concepts/architecture.md",
       "docs/concepts/architecture.md",
-      "docs/system-design/**"
+      "docs/system-design/**",
+      "docs/notes/research/**",
+      "docs/research/**",
+      "docs/experiments/**",
+      ".cx/experiments/**"
     ],
     "allowedBdLabels": [
       "architecture",
       "adr",
       "rfc",
-      "design"
+      "design",
+      "rd",
+      "research",
+      "experiment"
     ],
     "allowedCommands": [
       "bd create",
@@ -61,13 +72,21 @@
       "coupling and cohesion",
       "unvalidated assumptions",
       "interface contracts",
-      "tech debt accumulation"
+      "tech debt accumulation",
+      "hypothesis validation",
+      "experiment progress",
+      "assumption tracking",
+      "learning velocity"
     ],
     "riskSignals": [
       "missing ADRs",
       "implicit contracts",
       "data model drift",
-      "undocumented invariants"
+      "undocumented invariants",
+      "untested assumptions",
+      "premature hardening",
+      "stalled experiments",
+      "unfalsifiable claims"
     ],
     "artifactBias": [
       "adrs",
@@ -80,8 +99,8 @@
   "killSwitchEnv": "CONSTRUCT_ROLE_ARCHITECT",
   "handoffCandidates": [
     "engineer",
-    "platform-engineer",
-    "reviewer"
+    "reviewer",
+    "researcher"
   ],
   "team": "engineering-team",
   "teamId": "engineering-team",

package/specialists/org/specialists/cx-designer.json

@@ -11,22 +11,28 @@
     "frontend-design/component-patterns",
     "frontend-design/state-management",
     "frontend-design/engineering",
-    "frontend-design/accessibility"
+    "frontend-design/accessibility",
+    "frontend-design/screen-reader-testing"
   ],
   "events": [
-    "design.requested"
+    "design.requested",
+    "a11y.violation"
   ],
   "fence": {
     "allowedPaths": [
       "docs/design/**",
       "docs/wireframes/**",
-      "design/**"
+      "design/**",
+      "docs/accessibility/**",
+      "docs/a11y/**"
     ],
     "allowedBdLabels": [
       "design",
       "ux",
       "ui",
-      "wireframe"
+      "wireframe",
+      "accessibility",
+      "a11y"
     ],
     "allowedCommands": [
       "bd create",
@@ -57,13 +63,21 @@
       "interaction completeness",
       "state coverage",
       "design consistency",
-      "accessibility compliance"
+      "accessibility compliance",
+      "keyboard navigability",
+      "screen reader compatibility",
+      "contrast compliance",
+      "ARIA correctness"
     ],
     "riskSignals": [
       "missing error states",
       "no empty states",
       "inconsistent patterns",
-      "untested responsive breakpoints"
+      "untested responsive breakpoints",
+      "ARIA added without testing",
+      "keyboard traps",
+      "contrast failures",
+      "missing focus indicators"
     ],
     "artifactBias": [
       "notes",
@@ -71,13 +85,13 @@
     ]
   },
   "canEdit": true,
-  "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
   "internal": true,
   "killSwitchEnv": "CONSTRUCT_ROLE_DESIGNER",
   "handoffCandidates": [
     "product-manager",
     "engineer",
-    "accessibility"
+    "qa"
   ],
   "team": "design-team",
   "teamId": "design-team",

package/specialists/org/specialists/cx-engineer.json

@@ -24,12 +24,30 @@
     "frameworks/spring-boot",
     "exploration/unknown-codebase-onboarding",
     "exploration/tracer-bullet-method",
-    "exploration/dependency-graph-reading"
+    "exploration/dependency-graph-reading",
+    "ai/agent-dev",
+    "ai/rag-system",
+    "ai/llm-security",
+    "ai/prompt-and-eval",
+    "ai/prompt-optimizer",
+    "ai/ml-ops",
+    "devops/data-engineering",
+    "devops/database",
+    "devops/observability",
+    "operating/raw-data-structuring",
+    "devops/ci-cd",
+    "devops/monorepo",
+    "devops/containerization",
+    "devops/dependency-management",
+    "devops/devsecops",
+    "devops/cost-optimization"
   ],
   "events": [
     "incident.handoff",
     "bug.assigned",
-    "feature.assigned"
+    "feature.assigned",
+    "infra.change.requested",
+    "service.scale.event"
   ],
   "fence": {
     "allowedPaths": [
@@ -38,14 +56,34 @@
       "src/**",
       "app/**",
       "tests/**",
-      "docs/**"
+      "docs/**",
+      "docs/ai/**",
+      "docs/specialists/**",
+      "specialists/**",
+      "skills/ai/**",
+      "docs/data/**",
+      "docs/etl/**",
+      "docs/platform/**",
+      "docs/infra/**",
+      "infra/**",
+      "terraform/**",
+      "k8s/**"
     ],
     "allowedBdLabels": [
       "bug",
       "feature",
       "task",
       "engineering",
-      "fix"
+      "fix",
+      "ai",
+      "agent",
+      "model",
+      "data",
+      "etl",
+      "pipeline",
+      "platform",
+      "infrastructure",
+      "infra"
     ],
     "allowedCommands": [
       "bd create",
@@ -65,6 +103,8 @@
       "push",
       "edit:specialists/org",
       "edit:lib/setup.mjs",
+      "edit:bin/construct-postinstall.mjs",
+      "edit:lib/hooks/**",
       "edit:claude/settings.template.json"
     ]
   },
@@ -77,13 +117,35 @@
       "implementation progress",
       "test coverage gaps",
       "build health",
-      "PR velocity"
+      "PR velocity",
+      "model reliability",
+      "failure mode coverage",
+      "prompt stability",
+      "eval health",
+      "pipeline reliability",
+      "data quality",
+      "schema contract adherence",
+      "idempotency",
+      "developer friction",
+      "dependency freshness"
     ],
     "riskSignals": [
       "failing CI",
       "stale PRs",
       "untested paths",
-      "pattern drift"
+      "pattern drift",
+      "untested failure paths",
+      "hallucination risk dismissed",
+      "prompt drift",
+      "demo-only validation",
+      "non-idempotent pipelines",
+      "missing data quality tests",
+      "schema drift",
+      "uncontracted outputs",
+      "slow CI",
+      "stale dependencies",
+      "manual steps in pipelines",
+      "config only author understands"
     ],
     "artifactBias": [
       "notes",
@@ -98,7 +160,9 @@
     "qa",
     "reviewer",
     "security",
-    "sre"
+    "operations",
+    "architect",
+    "data-analyst"
   ],
   "team": "engineering-team",
   "teamId": "engineering-team",

package/specialists/org/specialists/cx-operations.json

@@ -10,19 +10,50 @@
     "docs/init-project",
     "operating/incident-response",
     "operating/oncall-rotation",
-    "operating/change-management"
+    "operating/change-management",
+    "devops/observability",
+    "devops/ci-cd",
+    "devops/performance",
+    "devops/incident-response",
+    "devops/git-workflow",
+    "quality-gates/verify-change",
+    "docs/memo-and-decision-capture",
+    "docs/adr-workflow",
+    "docs/runbook-workflow",
+    "docs/init-docs",
+    "docs/document-ingest-workflow"
   ],
   "events": [
-    "plan.requested"
+    "plan.requested",
+    "push_gate.fail",
+    "service.down",
+    "mcp.unhealthy.persistent",
+    "edit_loop.stuck",
+    "release.candidate",
+    "version.bump.needed",
+    "pr.merged.no-docs",
+    "changelog.missing",
+    "readme.stale",
+    "document.stale"
   ],
   "fence": {
     "allowedPaths": [
-      "docs/ops/**",
-      "docs/operations/**"
+      "docs/**",
+      "**/README.md",
+      "CHANGELOG.md"
     ],
     "allowedBdLabels": [
       "ops",
-      "operations"
+      "operations",
+      "incident",
+      "sre",
+      "reliability",
+      "release",
+      "version",
+      "shipping",
+      "docs",
+      "doc-drift",
+      "changelog"
     ],
     "allowedCommands": [
       "bd create",
@@ -32,11 +63,25 @@
     "approvalRequired": [
       "commit",
       "push",
-      "edit:**"
+      "edit:package.json",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:specialists/**"
     ]
   },
-  "docArtifacts": [],
-  "watchConditions": [],
+  "docArtifacts": [
+    "runbook",
+    "incident-report",
+    "postmortem",
+    "memo",
+    "changelog"
+  ],
+  "watchConditions": [
+    {
+      "watcher": "wide-blast-radius",
+      "reason": "wide blast radius — operational readiness review"
+    }
+  ],
   "permissions": {},
   "promptFile": "specialists/prompts/cx-operations.md",
   "embedOrientation": {
@@ -44,27 +89,56 @@
       "dependency sequencing",
       "ownership clarity",
       "blocker resolution",
-      "delivery cadence"
+      "delivery cadence",
+      "reliability posture",
+      "observability coverage",
+      "incident readiness",
+      "SLO adherence",
+      "release readiness",
+      "rollback viability",
+      "changelog completeness",
+      "migration safety",
+      "documentation freshness",
+      "decision traceability",
+      "context completeness",
+      "onboarding clarity"
     ],
     "riskSignals": [
       "hidden dependencies",
       "unowned tasks",
       "blocked work aging",
-      "parallel plans with serial reality"
+      "parallel plans with serial reality",
+      "missing alerts",
+      "untested rollbacks",
+      "observability gaps",
+      "SLOs defined post-incident",
+      "untested rollback",
+      "irreversible migrations",
+      "missing changelog entries",
+      "canary without rollback trigger",
+      "stale docs",
+      "undocumented decisions",
+      "missing context updates",
+      "tribal knowledge growing"
     ],
     "artifactBias": [
       "notes",
-      "memos"
+      "memos",
+      "adrs"
     ]
   },
-  "canEdit": false,
+  "canEdit": true,
   "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
   "internal": true,
+  "severityImmediate": [
+    "service.down"
+  ],
   "killSwitchEnv": "CONSTRUCT_ROLE_OPERATIONS",
   "handoffCandidates": [
-    "sre",
-    "platform-engineer",
-    "release-manager"
+    "engineer",
+    "debugger",
+    "qa",
+    "reviewer"
   ],
   "team": "operations-team",
   "teamId": "operations-team",

package/specialists/org/specialists/cx-orchestrator.json

@@ -9,7 +9,10 @@
     "ai/orchestration-workflow",
     "operating/orchestration-reference",
     "operating/change-management",
-    "operating/unstructured-triage"
+    "operating/unstructured-triage",
+    "exploration/dependency-graph-reading",
+    "roles/trace-reviewer",
+    "operating/fleet-health-routing"
   ],
   "events": [
     "handoff.received"
@@ -50,13 +53,22 @@
       "routing accuracy",
       "workload balance",
       "handoff completeness",
-      "specialist utilization"
+      "specialist utilization",
+      "parity drift",
+      "contract violations",
+      "doctor escalations",
+      "alignment census staleness",
+      "outcomes degradation"
     ],
     "riskSignals": [
       "misrouted tasks",
       "overloaded specialists",
       "dropped handoffs",
-      "stale queued work"
+      "stale queued work",
+      "unrouted systemic gaps",
+      "auto actions needing approval",
+      "stale alignment census",
+      "missing read-model signals"
     ],
     "artifactBias": [
       "notes",
@@ -73,7 +85,7 @@
     "engineer",
     "security",
     "qa",
-    "sre"
+    "operations"
   ],
   "team": "strategy-team",
   "teamId": "strategy-team",