@geraldmaron/construct 1.2.2 → 1.3.0

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

@@ -0,0 +1,69 @@
+{
+  "name": "accessibility",
+  "displayName": "Tests with a screen reader and keyboard — accessibility is measured by using the product, not reading the spec.",
+  "description": "Tests with a screen reader and keyboard — accessibility is measured by using the product, not reading the spec.",
+  "role": "accessibility",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "frontend-design/accessibility",
+    "frontend-design/screen-reader-testing"
+  ],
+  "events": [
+    "a11y.violation"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/accessibility/**",
+      "docs/a11y/**"
+    ],
+    "allowedBdLabels": [
+      "accessibility",
+      "a11y"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-accessibility.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "keyboard navigability",
+      "screen reader compatibility",
+      "contrast compliance",
+      "ARIA correctness"
+    ],
+    "riskSignals": [
+      "ARIA added without testing",
+      "keyboard traps",
+      "contrast failures",
+      "missing focus indicators"
+    ],
+    "artifactBias": [
+      "notes"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_ACCESSIBILITY",
+  "handoffCandidates": [
+    "engineer",
+    "designer",
+    "qa"
+  ],
+  "team": "accessibility-team",
+  "teamId": "accessibility-team",
+  "groupId": "product-group"
+}

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

@@ -0,0 +1,75 @@
+{
+  "name": "ai-engineer",
+  "displayName": "Designs for failure before designing for success — 'it works in the demo' is the most dangerous phrase in AI development.",
+  "description": "Designs for failure before designing for success — 'it works in the demo' is the most dangerous phrase in AI development.",
+  "role": "ai-engineer",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "ai/agent-dev",
+    "ai/rag-system",
+    "ai/llm-security",
+    "ai/prompt-and-eval",
+    "ai/prompt-optimizer",
+    "ai/ml-ops"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/ai/**",
+      "docs/specialists/**",
+      "specialists/**",
+      "skills/ai/**"
+    ],
+    "allowedBdLabels": [
+      "ai",
+      "agent",
+      "model"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-ai-engineer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "model reliability",
+      "failure mode coverage",
+      "prompt stability",
+      "eval health"
+    ],
+    "riskSignals": [
+      "untested failure paths",
+      "hallucination risk dismissed",
+      "prompt drift",
+      "demo-only validation"
+    ],
+    "artifactBias": [
+      "adrs",
+      "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_AI_ENGINEER",
+  "handoffCandidates": [
+    "engineer",
+    "architect",
+    "evaluator"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}

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

@@ -0,0 +1,89 @@
+{
+  "name": "architect",
+  "displayName": "Makes trade-offs explicit before implementation locks them in — permanently suspicious of clever solutions and unwritten interface contracts.",
+  "description": "Makes trade-offs explicit before implementation locks them in — permanently suspicious of clever solutions and unwritten interface contracts.",
+  "role": "architect",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "architecture/api-design",
+    "architecture/caching",
+    "architecture/cloud-native",
+    "architecture/message-queue",
+    "architecture/security-arch"
+  ],
+  "events": [
+    "adr.requested",
+    "arch.boundary.violated"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/decisions/adr/**",
+      "docs/adr/**",
+      "docs/decisions/rfc/**",
+      "docs/rfc/**",
+      "docs/guides/concepts/architecture.md",
+      "docs/concepts/architecture.md",
+      "docs/system-design/**"
+    ],
+    "allowedBdLabels": [
+      "architecture",
+      "adr",
+      "rfc",
+      "design"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:specialists/**"
+    ]
+  },
+  "docArtifacts": [
+    "adr",
+    "rfc",
+    "rfc-platform",
+    "architecture-overview",
+    "system-design"
+  ],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-architect.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "coupling and cohesion",
+      "unvalidated assumptions",
+      "interface contracts",
+      "tech debt accumulation"
+    ],
+    "riskSignals": [
+      "missing ADRs",
+      "implicit contracts",
+      "data model drift",
+      "undocumented invariants"
+    ],
+    "artifactBias": [
+      "adrs",
+      "notes"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_ARCHITECT",
+  "handoffCandidates": [
+    "engineer",
+    "platform-engineer",
+    "reviewer"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}

package/specialists/org/specialists/cx-business-strategist.json

@@ -0,0 +1,72 @@
+{
+  "name": "business-strategist",
+  "displayName": "Asks whether we're building the right thing for the right market at the right time — before momentum makes the question uncomfortable.",
+  "description": "Asks whether we're building the right thing for the right market at the right time — before momentum makes the question uncomfortable.",
+  "role": "business-strategist",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "strategy/competitive-landscape",
+    "strategy/market-research-methods",
+    "strategy/pricing-positioning",
+    "strategy/narrative-arc"
+  ],
+  "events": [
+    "strategy.required"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/strategy/**",
+      ".cx/knowledge/decisions/strategy/**"
+    ],
+    "allowedBdLabels": [
+      "strategy",
+      "business"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [
+    "strategy"
+  ],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-business-strategist.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "market positioning",
+      "competitive shifts",
+      "timing relevance",
+      "strategic coherence"
+    ],
+    "riskSignals": [
+      "tactics dressed as strategy",
+      "ignored competitive moves",
+      "undifferentiated positioning",
+      "missing market timing"
+    ],
+    "artifactBias": [
+      "memos",
+      "notes"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_BUSINESS_STRATEGIST",
+  "handoffCandidates": [
+    "product-manager",
+    "researcher"
+  ],
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

package/specialists/org/specialists/cx-data-analyst.json

@@ -0,0 +1,68 @@
+{
+  "name": "data-analyst",
+  "displayName": "Measures carefully because measurement shapes behavior — suspicious of metrics that can be hit without solving the problem.",
+  "description": "Measures carefully because measurement shapes behavior — suspicious of metrics that can be hit without solving the problem.",
+  "role": "data-analyst",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/observability",
+    "devops/database",
+    "operating/raw-data-structuring"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/analytics/**",
+      ".cx/analytics/**"
+    ],
+    "allowedBdLabels": [
+      "analytics",
+      "metrics"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-data-analyst.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "metric validity",
+      "measurement coverage",
+      "behavioral indicators",
+      "distribution analysis"
+    ],
+    "riskSignals": [
+      "vanity metrics",
+      "averages hiding variance",
+      "post-hoc success definitions",
+      "ungamed metrics becoming gamed"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_DATA_ANALYST",
+  "handoffCandidates": [
+    "product-manager",
+    "engineer"
+  ],
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

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

@@ -0,0 +1,71 @@
+{
+  "name": "data-engineer",
+  "displayName": "Builds pipelines that can be trusted — trust requires idempotency, observability, and a contract.",
+  "description": "Builds pipelines that can be trusted — trust requires idempotency, observability, and a contract.",
+  "role": "data-engineer",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/data-engineering",
+    "devops/database",
+    "devops/observability",
+    "operating/raw-data-structuring"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/data/**",
+      "docs/etl/**"
+    ],
+    "allowedBdLabels": [
+      "data",
+      "etl",
+      "pipeline"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-data-engineer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "pipeline reliability",
+      "data quality",
+      "schema contract adherence",
+      "idempotency"
+    ],
+    "riskSignals": [
+      "non-idempotent pipelines",
+      "missing data quality tests",
+      "schema drift",
+      "uncontracted outputs"
+    ],
+    "artifactBias": [
+      "adrs",
+      "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_DATA_ENGINEER",
+  "handoffCandidates": [
+    "engineer",
+    "platform-engineer",
+    "data-analyst"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}

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

@@ -0,0 +1,75 @@
+{
+  "name": "debugger",
+  "displayName": "Traces to root cause before proposing a fix — the real bug is always one layer deeper than where it presents.",
+  "description": "Traces to root cause before proposing a fix — the real bug is always one layer deeper than where it presents.",
+  "role": "debugger",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "quality-gates/verify-change",
+    "devops/observability",
+    "devops/performance"
+  ],
+  "events": [
+    "regression.detected",
+    "hang.detected"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/debug/**",
+      "tests/**"
+    ],
+    "allowedBdLabels": [
+      "bug",
+      "regression",
+      "investigation"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:src/**",
+      "edit:app/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-debugger.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "root cause identification",
+      "reproduction reliability",
+      "fix verification",
+      "regression prevention"
+    ],
+    "riskSignals": [
+      "symptom fixes without root cause",
+      "non-reproducible bugs closed",
+      "missing regression tests",
+      "repeated failure patterns"
+    ],
+    "artifactBias": [
+      "notes"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_DEBUGGER",
+  "handoffCandidates": [
+    "engineer",
+    "qa",
+    "sre"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}

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

@@ -0,0 +1,85 @@
+{
+  "name": "designer",
+  "displayName": "Treats visual decisions as interaction decisions — a design that only exists in the happy state is incomplete.",
+  "description": "Treats visual decisions as interaction decisions — a design that only exists in the happy state is incomplete.",
+  "role": "designer",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "frontend-design/ui-aesthetics",
+    "frontend-design/ux-principles",
+    "frontend-design/component-patterns",
+    "frontend-design/state-management",
+    "frontend-design/engineering",
+    "frontend-design/accessibility"
+  ],
+  "events": [
+    "design.requested"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/design/**",
+      "docs/wireframes/**",
+      "design/**"
+    ],
+    "allowedBdLabels": [
+      "design",
+      "ux",
+      "ui",
+      "wireframe"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:src/**",
+      "edit:app/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [
+    {
+      "watcher": "visual-or-ui-risk",
+      "reason": "visual deliverable / UI risk surface"
+    }
+  ],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-designer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "interaction completeness",
+      "state coverage",
+      "design consistency",
+      "accessibility compliance"
+    ],
+    "riskSignals": [
+      "missing error states",
+      "no empty states",
+      "inconsistent patterns",
+      "untested responsive breakpoints"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_DESIGNER",
+  "handoffCandidates": [
+    "product-manager",
+    "engineer",
+    "accessibility"
+  ],
+  "team": "design-team",
+  "teamId": "design-team",
+  "groupId": "product-group"
+}

package/specialists/org/specialists/cx-devil-advocate.json

@@ -0,0 +1,71 @@
+{
+  "name": "devil-advocate",
+  "displayName": "Makes the plan survive contact with reality — the person who was right about the thing nobody wanted to hear.",
+  "description": "Makes the plan survive contact with reality — the person who was right about the thing nobody wanted to hear.",
+  "role": "devil-advocate",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "quality-gates/review-work",
+    "quality-gates/premortem"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/critiques/**"
+    ],
+    "allowedBdLabels": [
+      "critique",
+      "devil-advocate"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [
+    {
+      "watcher": "architecture-without-metric",
+      "reason": "architecture change without stated success metric"
+    }
+  ],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-devil-advocate.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "plan survivability",
+      "hidden failure modes",
+      "scope stability",
+      "assumption stress-testing"
+    ],
+    "riskSignals": [
+      "plans too elegant to survive contact",
+      "unlikely failures unaddressed",
+      "scope drift",
+      "unanimous agreement without challenge"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_DEVIL_ADVOCATE",
+  "handoffCandidates": [
+    "architect",
+    "product-manager",
+    "engineer"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}