@geraldmaron/construct 1.2.2 → 1.3.0

package/specialists/org/specialists/cx-product-manager.json

@@ -0,0 +1,102 @@
+{
+  "name": "product-manager",
+  "displayName": "Translates user reality into technical deliverables — skeptical of any requirement that can't be traced to observed user behavior.",
+  "description": "Translates user reality into technical deliverables — skeptical of any requirement that can't be traced to observed user behavior.",
+  "role": "product-manager",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "docs/product-intelligence-workflow",
+    "docs/evidence-ingest-workflow",
+    "docs/product-signal-workflow",
+    "docs/customer-profile-workflow",
+    "docs/prd-workflow",
+    "docs/prfaq-workflow",
+    "docs/backlog-proposal-workflow",
+    "docs/product-intelligence-review",
+    "docs/strategy-workflow"
+  ],
+  "events": [
+    "backlog.stale",
+    "prd.requested"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/specs/prd/**",
+      "docs/prd/**",
+      "docs/meta-prd/**",
+      "docs/prfaq/**",
+      "docs/one-pager/**",
+      ".cx/knowledge/**"
+    ],
+    "allowedBdLabels": [
+      "product",
+      "prd",
+      "backlog",
+      "feature"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label",
+      "bd priority"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [
+    "prd",
+    "meta-prd",
+    "prfaq",
+    "one-pager",
+    "backlog-proposal",
+    "prd-platform",
+    "prd-business",
+    "customer-profile"
+  ],
+  "watchConditions": [
+    {
+      "watcher": "high-ambiguity-deep-work",
+      "reason": "clarify acceptance criteria (high ambiguity)"
+    }
+  ],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-product-manager.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "requirements coverage",
+      "delivery risk",
+      "user-facing gaps",
+      "scope clarity"
+    ],
+    "riskSignals": [
+      "untraced requirements",
+      "scope creep",
+      "blocked dependencies",
+      "missing acceptance criteria"
+    ],
+    "artifactBias": [
+      "prds",
+      "intake",
+      "memos"
+    ]
+  },
+  "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_PRODUCT_MANAGER",
+  "handoffCandidates": [
+    "architect",
+    "engineer",
+    "designer",
+    "researcher"
+  ],
+  "team": "product-management-team",
+  "teamId": "product-management-team",
+  "groupId": "product-group"
+}

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

@@ -0,0 +1,79 @@
+{
+  "name": "qa",
+  "displayName": "Asks whether the tests test what matters — coverage numbers are hypotheses about quality, not proof of it.",
+  "description": "Asks whether the tests test what matters — coverage numbers are hypotheses about quality, not proof of it.",
+  "role": "qa",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/testing",
+    "quality-gates/verify-change",
+    "quality-gates/verify-module"
+  ],
+  "events": [
+    "test.fail",
+    "test.flake",
+    "coverage.drop"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/qa/**",
+      "docs/test-plans/**"
+    ],
+    "allowedBdLabels": [
+      "bug",
+      "qa",
+      "test",
+      "flake"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:tests/**",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [
+    "test-plan",
+    "qa-strategy"
+  ],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-qa.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "test effectiveness",
+      "behavioral coverage",
+      "regression risk",
+      "acceptance criteria traceability"
+    ],
+    "riskSignals": [
+      "tests that never fail",
+      "coverage without behavioral assertions",
+      "untested acceptance criteria",
+      "flaky tests ignored"
+    ],
+    "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,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_QA",
+  "handoffCandidates": [
+    "engineer",
+    "debugger",
+    "test-automation"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}

package/specialists/org/specialists/cx-rd-lead.json

@@ -0,0 +1,73 @@
+{
+  "name": "rd-lead",
+  "displayName": "Slows the team down at the right moment — before architecture locks in assumptions that were never validated.",
+  "description": "Slows the team down at the right moment — before architecture locks in assumptions that were never validated.",
+  "role": "rd-lead",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "ai/agent-dev",
+    "ai/prompt-and-eval",
+    "docs/research-workflow"
+  ],
+  "events": [
+    "research.gate.required"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/notes/research/**",
+      "docs/research/**",
+      "docs/experiments/**",
+      ".cx/experiments/**"
+    ],
+    "allowedBdLabels": [
+      "rd",
+      "research",
+      "experiment"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-rd-lead.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "hypothesis validation",
+      "experiment progress",
+      "assumption tracking",
+      "learning velocity"
+    ],
+    "riskSignals": [
+      "untested assumptions",
+      "premature hardening",
+      "stalled experiments",
+      "unfalsifiable claims"
+    ],
+    "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_RD_LEAD",
+  "handoffCandidates": [
+    "researcher",
+    "architect",
+    "ai-engineer"
+  ],
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

package/specialists/org/specialists/cx-release-manager.json

@@ -0,0 +1,77 @@
+{
+  "name": "release-manager",
+  "displayName": "Guards the gap between 'verified' and 'safe to ship' — rollback procedures that were never tested don't exist.",
+  "description": "Guards the gap between 'verified' and 'safe to ship' — rollback procedures that were never tested don't exist.",
+  "role": "release-manager",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/git-workflow",
+    "quality-gates/verify-change",
+    "docs/memo-and-decision-capture"
+  ],
+  "events": [
+    "release.candidate",
+    "version.bump.needed"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/operations/releases/**",
+      "docs/releases/**",
+      "CHANGELOG.md"
+    ],
+    "allowedBdLabels": [
+      "release",
+      "version",
+      "shipping"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:package.json",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-release-manager.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "release readiness",
+      "rollback viability",
+      "changelog completeness",
+      "migration safety"
+    ],
+    "riskSignals": [
+      "untested rollback",
+      "irreversible migrations",
+      "missing changelog entries",
+      "canary without rollback trigger"
+    ],
+    "artifactBias": [
+      "notes",
+      "adrs"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_RELEASE_MANAGER",
+  "handoffCandidates": [
+    "qa",
+    "engineer",
+    "reviewer",
+    "docs-keeper"
+  ],
+  "team": "operations-team",
+  "teamId": "operations-team",
+  "groupId": "operations-group"
+}

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

@@ -0,0 +1,82 @@
+{
+  "name": "researcher",
+  "displayName": "Never trusts recall alone — sources every claim with a primary reference and a date.",
+  "description": "Never trusts recall alone — sources every claim with a primary reference and a date.",
+  "role": "researcher",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "docs/research-workflow",
+    "devops/dependency-management",
+    "docs/transcript-synthesis"
+  ],
+  "events": [
+    "research.requested",
+    "evidence.requested"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/notes/research/**",
+      "docs/research/**",
+      ".cx/research/**",
+      "docs/evidence-briefs/**",
+      "docs/signal-briefs/**"
+    ],
+    "allowedBdLabels": [
+      "research",
+      "evidence",
+      "investigation"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [
+    "research-brief",
+    "evidence-brief",
+    "signal-brief",
+    "product-intelligence-report"
+  ],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-researcher.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "source freshness",
+      "citation coverage",
+      "dependency versions",
+      "conflicting evidence"
+    ],
+    "riskSignals": [
+      "undated sources",
+      "unverified claims",
+      "outdated dependencies",
+      "single-source conclusions"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_RESEARCHER",
+  "handoffCandidates": [
+    "product-manager",
+    "architect",
+    "engineer"
+  ],
+  "team": "research-team",
+  "teamId": "research-team",
+  "groupId": "product-group"
+}

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

@@ -0,0 +1,71 @@
+{
+  "name": "reviewer",
+  "displayName": "Finds bugs by looking at the conditions the author didn't test for — happy path review is not review.",
+  "description": "Finds bugs by looking at the conditions the author didn't test for — happy path review is not review.",
+  "role": "reviewer",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "quality-gates/verify-quality",
+    "quality-gates/review-work",
+    "quality-gates/verify-module"
+  ],
+  "events": [
+    "pr.opened",
+    "pr.ready-for-review"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/reviews/**"
+    ],
+    "allowedBdLabels": [
+      "review",
+      "code-review",
+      "second-look"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-reviewer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "edge case coverage",
+      "error handling completeness",
+      "test fidelity",
+      "code quality trends"
+    ],
+    "riskSignals": [
+      "happy-path-only reviews",
+      "excessive mocking",
+      "missing error handlers",
+      "review without reproduction"
+    ],
+    "artifactBias": [
+      "notes"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,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_REVIEWER",
+  "handoffCandidates": [
+    "engineer",
+    "architect",
+    "security"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}

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

@@ -0,0 +1,91 @@
+{
+  "name": "security",
+  "displayName": "Thinks like an attacker — sees the attack surface the developer didn't know existed.",
+  "description": "Thinks like an attacker — sees the attack surface the developer didn't know existed.",
+  "role": "security",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "security/red-team",
+    "security/blue-team",
+    "security/pentest",
+    "security/code-audit",
+    "security/vuln-research",
+    "security/threat-intel",
+    "quality-gates/verify-security",
+    "architecture/security-arch"
+  ],
+  "events": [
+    "dep.cve",
+    "secrets.detected",
+    "config.protection.violation"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/security/**",
+      "docs/threat-models/**"
+    ],
+    "allowedBdLabels": [
+      "security",
+      "vulnerability",
+      "audit"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [
+    "security-review",
+    "threat-model"
+  ],
+  "watchConditions": [
+    {
+      "watcher": "auth-payments-non-narrow",
+      "reason": "pre-dispatch threat model (auth/payments/PII + non-narrow blast radius)"
+    }
+  ],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-security.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "attack surface changes",
+      "dependency vulnerabilities",
+      "auth boundary integrity",
+      "secret exposure"
+    ],
+    "riskSignals": [
+      "new unauthed endpoints",
+      "unaudited dependencies",
+      "implicit trust boundaries",
+      "hardcoded credentials"
+    ],
+    "artifactBias": [
+      "adrs",
+      "notes"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score,get_template,list_templates",
+  "internal": true,
+  "severityImmediate": [
+    "dep.cve",
+    "secrets.detected"
+  ],
+  "killSwitchEnv": "CONSTRUCT_ROLE_SECURITY",
+  "handoffCandidates": [
+    "engineer",
+    "platform-engineer",
+    "reviewer"
+  ],
+  "team": "governance-team",
+  "teamId": "governance-team",
+  "groupId": "governance-group"
+}

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

@@ -0,0 +1,94 @@
+{
+  "name": "sre",
+  "displayName": "Plans for failure before it happens — reliability problems are designed in, not out.",
+  "description": "Plans for failure before it happens — reliability problems are designed in, not out.",
+  "role": "sre",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/observability",
+    "devops/ci-cd",
+    "devops/performance",
+    "devops/incident-response"
+  ],
+  "events": [
+    "push_gate.fail",
+    "service.down",
+    "mcp.unhealthy.persistent",
+    "edit_loop.stuck"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/operations/runbooks/**",
+      "docs/runbooks/**",
+      "docs/operations/incidents/**",
+      "docs/incidents/**",
+      "docs/postmortems/**"
+    ],
+    "allowedBdLabels": [
+      "incident",
+      "sre",
+      "reliability"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd link",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:specialists/**"
+    ]
+  },
+  "docArtifacts": [
+    "runbook",
+    "incident-report",
+    "postmortem"
+  ],
+  "watchConditions": [
+    {
+      "watcher": "wide-blast-radius",
+      "reason": "wide blast radius — operational readiness review"
+    }
+  ],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-sre.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "reliability posture",
+      "observability coverage",
+      "incident readiness",
+      "SLO adherence"
+    ],
+    "riskSignals": [
+      "missing alerts",
+      "untested rollbacks",
+      "observability gaps",
+      "SLOs defined post-incident"
+    ],
+    "artifactBias": [
+      "adrs",
+      "notes"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
+  "internal": true,
+  "severityImmediate": [
+    "service.down"
+  ],
+  "killSwitchEnv": "CONSTRUCT_ROLE_SRE",
+  "handoffCandidates": [
+    "engineer",
+    "platform-engineer",
+    "debugger"
+  ],
+  "team": "operations-team",
+  "teamId": "operations-team",
+  "groupId": "operations-group"
+}