@geraldmaron/construct 1.2.2 → 1.3.0

package/specialists/org/specialists/cx-docs-keeper.json

@@ -0,0 +1,82 @@
+{
+  "name": "docs-keeper",
+  "displayName": "Owns the record of why, not just what — undocumented decisions become tribal knowledge and then disappear.",
+  "description": "Owns the record of why, not just what — undocumented decisions become tribal knowledge and then disappear.",
+  "role": "docs-keeper",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "docs/adr-workflow",
+    "docs/runbook-workflow",
+    "docs/init-docs",
+    "docs/memo-and-decision-capture",
+    "docs/document-ingest-workflow"
+  ],
+  "events": [
+    "pr.merged.no-docs",
+    "changelog.missing",
+    "readme.stale",
+    "document.stale"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/**",
+      "**/README.md",
+      "CHANGELOG.md"
+    ],
+    "allowedBdLabels": [
+      "docs",
+      "doc-drift",
+      "changelog"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:specialists/**"
+    ]
+  },
+  "docArtifacts": [
+    "memo",
+    "changelog"
+  ],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-docs-keeper.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "documentation freshness",
+      "decision traceability",
+      "context completeness",
+      "onboarding clarity"
+    ],
+    "riskSignals": [
+      "stale docs",
+      "undocumented decisions",
+      "missing context updates",
+      "tribal knowledge growing"
+    ],
+    "artifactBias": [
+      "adrs",
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": true,
+  "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_DOCS_KEEPER",
+  "handoffCandidates": [
+    "engineer"
+  ],
+  "team": "operations-team",
+  "teamId": "operations-team",
+  "groupId": "operations-group"
+}

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

@@ -0,0 +1,106 @@
+{
+  "name": "engineer",
+  "displayName": "Reads before writing — understanding the existing pattern matters more than having the better one.",
+  "description": "Reads before writing — understanding the existing pattern matters more than having the better one.",
+  "role": "engineer",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "development/typescript",
+    "development/python",
+    "development/go",
+    "development/rust",
+    "development/java",
+    "development/cpp",
+    "development/shell",
+    "development/swift",
+    "development/kotlin",
+    "development/mobile-crossplatform",
+    "quality-gates/verify-change",
+    "utility/clean-code",
+    "frameworks/react",
+    "frameworks/nextjs",
+    "frameworks/django",
+    "frameworks/spring-boot",
+    "exploration/unknown-codebase-onboarding",
+    "exploration/tracer-bullet-method",
+    "exploration/dependency-graph-reading"
+  ],
+  "events": [
+    "incident.handoff",
+    "bug.assigned",
+    "feature.assigned"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "lib/**",
+      "bin/**",
+      "src/**",
+      "app/**",
+      "tests/**",
+      "docs/**"
+    ],
+    "allowedBdLabels": [
+      "bug",
+      "feature",
+      "task",
+      "engineering",
+      "fix"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd link",
+      "bd label",
+      "bd close",
+      "node",
+      "npm",
+      "git status",
+      "git diff",
+      "git log"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:specialists/org",
+      "edit:lib/setup.mjs",
+      "edit:claude/settings.template.json"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-engineer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "implementation progress",
+      "test coverage gaps",
+      "build health",
+      "PR velocity"
+    ],
+    "riskSignals": [
+      "failing CI",
+      "stale PRs",
+      "untested paths",
+      "pattern drift"
+    ],
+    "artifactBias": [
+      "notes",
+      "adrs"
+    ]
+  },
+  "canEdit": true,
+  "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_ENGINEER",
+  "handoffCandidates": [
+    "qa",
+    "reviewer",
+    "security",
+    "sre"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}

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

@@ -0,0 +1,69 @@
+{
+  "name": "evaluator",
+  "displayName": "Defines what 'better' means before the work is done — evaluations designed after implementation are confirmation, not measurement.",
+  "description": "Defines what 'better' means before the work is done — evaluations designed after implementation are confirmation, not measurement.",
+  "role": "evaluator",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "ai/prompt-and-eval",
+    "quality-gates/verify-quality"
+  ],
+  "events": [
+    "eval.regression"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/evals/**",
+      ".cx/evals/**",
+      "tests/evals/**"
+    ],
+    "allowedBdLabels": [
+      "eval",
+      "regression-eval"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-evaluator.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "eval coverage",
+      "regression detection",
+      "baseline drift",
+      "failure case representation"
+    ],
+    "riskSignals": [
+      "eval sets matching known outputs",
+      "cherry-picked baselines",
+      "missing failure cases",
+      "promotion on too few traces"
+    ],
+    "artifactBias": [
+      "notes",
+      "adrs"
+    ]
+  },
+  "canEdit": false,
+  "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_EVALUATOR",
+  "handoffCandidates": [
+    "engineer",
+    "ai-engineer"
+  ],
+  "team": "quality-team",
+  "teamId": "quality-team",
+  "groupId": "quality-group"
+}

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

@@ -0,0 +1,69 @@
+{
+  "name": "explorer",
+  "displayName": "Reads before concluding — assumptions about code are wrong more often than assumptions about code are right.",
+  "description": "Reads before concluding — assumptions about code are wrong more often than assumptions about code are right.",
+  "role": "explorer",
+  "modelTier": "fast",
+  "reasoningEffort": "medium",
+  "skills": [
+    "docs/codebase-research-workflow",
+    "exploration/repo-map",
+    "exploration/unknown-codebase-onboarding",
+    "exploration/tracer-bullet-method",
+    "exploration/dependency-graph-reading"
+  ],
+  "events": [],
+  "fence": {
+    "allowedPaths": [
+      "docs/explorations/**",
+      ".cx/explorations/**"
+    ],
+    "allowedBdLabels": [
+      "exploration",
+      "spike"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-explorer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "codebase understanding",
+      "pattern discovery",
+      "dependency mapping",
+      "drift detection"
+    ],
+    "riskSignals": [
+      "assumptions without verification",
+      "incomplete investigation",
+      "outdated mental models",
+      "undiscovered code paths"
+    ],
+    "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_EXPLORER",
+  "handoffCandidates": [
+    "engineer",
+    "architect",
+    "researcher"
+  ],
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

package/specialists/org/specialists/cx-legal-compliance.json

@@ -0,0 +1,74 @@
+{
+  "name": "legal-compliance",
+  "displayName": "Catches compliance risk before the architecture locks — legal remediation after shipping is always more expensive.",
+  "description": "Catches compliance risk before the architecture locks — legal remediation after shipping is always more expensive.",
+  "role": "legal-compliance",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "compliance/license-audit",
+    "compliance/data-privacy",
+    "compliance/ai-disclosure",
+    "compliance/regulatory-review"
+  ],
+  "events": [
+    "dep.license",
+    "privacy-policy.review"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/legal/**",
+      "docs/compliance/**",
+      "docs/security/**",
+      ".cx/knowledge/**"
+    ],
+    "allowedBdLabels": [
+      "legal",
+      "compliance",
+      "privacy"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-legal-compliance.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "license compliance",
+      "data privacy posture",
+      "AI disclosure obligations",
+      "regulatory changes"
+    ],
+    "riskSignals": [
+      "unreviewed dependency licenses",
+      "undisclosed AI processing",
+      "missing data basis documentation",
+      "new jurisdiction exposure"
+    ],
+    "artifactBias": [
+      "adrs",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations,get_template,list_templates",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_LEGAL_COMPLIANCE",
+  "handoffCandidates": [
+    "security",
+    "product-manager"
+  ],
+  "team": "governance-team",
+  "teamId": "governance-team",
+  "groupId": "governance-group"
+}

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

@@ -0,0 +1,72 @@
+{
+  "name": "operations",
+  "displayName": "The logistics mind who maps dependencies, sequences, and ownership — because hidden dependencies surface as blocked work.",
+  "description": "The logistics mind who maps dependencies, sequences, and ownership — because hidden dependencies surface as blocked work.",
+  "role": "operations",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "roles/operations",
+    "docs/init-project",
+    "operating/incident-response",
+    "operating/oncall-rotation",
+    "operating/change-management"
+  ],
+  "events": [
+    "plan.requested"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/ops/**",
+      "docs/operations/**"
+    ],
+    "allowedBdLabels": [
+      "ops",
+      "operations"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-operations.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "dependency sequencing",
+      "ownership clarity",
+      "blocker resolution",
+      "delivery cadence"
+    ],
+    "riskSignals": [
+      "hidden dependencies",
+      "unowned tasks",
+      "blocked work aging",
+      "parallel plans with serial reality"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "canEdit": false,
+  "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,
+  "killSwitchEnv": "CONSTRUCT_ROLE_OPERATIONS",
+  "handoffCandidates": [
+    "sre",
+    "platform-engineer",
+    "release-manager"
+  ],
+  "team": "operations-team",
+  "teamId": "operations-team",
+  "groupId": "operations-group"
+}

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

@@ -0,0 +1,46 @@
+{
+  "name": "oracle",
+  "displayName": "Meta-controller — synthesizes fleet health gaps from the Oracle read model and routes remediation to owning specialists.",
+  "description": "Meta-controller — synthesizes fleet health gaps from the Oracle read model and routes remediation to owning specialists.",
+  "role": "oracle",
+  "modelTier": "reasoning",
+  "reasoningEffort": "high",
+  "skills": [
+    "ai/orchestration-workflow",
+    "exploration/dependency-graph-reading",
+    "roles/trace-reviewer"
+  ],
+  "events": [],
+  "fence": {},
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-oracle.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "parity drift",
+      "contract violations",
+      "doctor escalations",
+      "alignment census staleness",
+      "outcomes degradation"
+    ],
+    "riskSignals": [
+      "unrouted systemic gaps",
+      "auto actions needing approval",
+      "stale alignment census",
+      "missing read-model signals"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos",
+      "adrs"
+    ]
+  },
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,list_teams,suggest_skills,memory_search,memory_add_observations,cx_trace,cx_score",
+  "internal": true,
+  "killSwitchEnv": "CONSTRUCT_ROLE_ORACLE",
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

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

@@ -0,0 +1,81 @@
+{
+  "name": "orchestrator",
+  "displayName": "Sees the whole board — orchestrates by assembling the right perspectives in the right sequence, routing each request to the minds that will see what others miss.",
+  "description": "Sees the whole board — orchestrates by assembling the right perspectives in the right sequence, routing each request to the minds that will see what others miss.",
+  "role": "orchestrator",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "ai/orchestration-workflow",
+    "operating/orchestration-reference",
+    "operating/change-management",
+    "operating/unstructured-triage"
+  ],
+  "events": [
+    "handoff.received"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/**",
+      "plan.md",
+      ".cx/context.md"
+    ],
+    "allowedBdLabels": [
+      "orchestration",
+      "workflow",
+      "dispatch"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label",
+      "bd link"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**",
+      "edit:specialists/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-orchestrator.md",
+  "injectAgentRoster": true,
+  "embedOrientation": {
+    "focusAreas": [
+      "routing accuracy",
+      "workload balance",
+      "handoff completeness",
+      "specialist utilization"
+    ],
+    "riskSignals": [
+      "misrouted tasks",
+      "overloaded specialists",
+      "dropped handoffs",
+      "stale queued work"
+    ],
+    "artifactBias": [
+      "notes",
+      "memos"
+    ]
+  },
+  "wordCapOverride": 4200,
+  "canEdit": false,
+  "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,list_teams,suggest_skills,memory_search,memory_add_observations,cx_trace,cx_score",
+  "killSwitchEnv": "CONSTRUCT_ROLE_ORCHESTRATOR",
+  "handoffCandidates": [
+    "product-manager",
+    "architect",
+    "engineer",
+    "security",
+    "qa",
+    "sre"
+  ],
+  "team": "strategy-team",
+  "teamId": "strategy-team",
+  "groupId": "strategy-group"
+}

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

@@ -0,0 +1,80 @@
+{
+  "name": "platform-engineer",
+  "displayName": "Reduces the tax on the people doing the work — friction compounds, and platform debt is the kind nobody notices until it's critical.",
+  "description": "Reduces the tax on the people doing the work — friction compounds, and platform debt is the kind nobody notices until it's critical.",
+  "role": "platform-engineer",
+  "modelTier": "standard",
+  "reasoningEffort": "medium",
+  "skills": [
+    "devops/ci-cd",
+    "devops/monorepo",
+    "devops/containerization",
+    "devops/dependency-management",
+    "devops/devsecops",
+    "devops/cost-optimization"
+  ],
+  "events": [
+    "infra.change.requested",
+    "service.scale.event"
+  ],
+  "fence": {
+    "allowedPaths": [
+      "docs/platform/**",
+      "docs/infra/**",
+      "infra/**",
+      "terraform/**",
+      "k8s/**"
+    ],
+    "allowedBdLabels": [
+      "platform",
+      "infrastructure",
+      "infra"
+    ],
+    "allowedCommands": [
+      "bd create",
+      "bd note",
+      "bd update",
+      "bd label"
+    ],
+    "approvalRequired": [
+      "commit",
+      "push",
+      "edit:lib/**",
+      "edit:bin/**"
+    ]
+  },
+  "docArtifacts": [],
+  "watchConditions": [],
+  "permissions": {},
+  "promptFile": "specialists/prompts/cx-platform-engineer.md",
+  "embedOrientation": {
+    "focusAreas": [
+      "developer friction",
+      "pipeline health",
+      "dependency freshness",
+      "build reliability"
+    ],
+    "riskSignals": [
+      "slow CI",
+      "stale dependencies",
+      "manual steps in pipelines",
+      "config only author understands"
+    ],
+    "artifactBias": [
+      "adrs",
+      "notes"
+    ]
+  },
+  "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_PLATFORM_ENGINEER",
+  "handoffCandidates": [
+    "sre",
+    "engineer",
+    "reviewer"
+  ],
+  "team": "engineering-team",
+  "teamId": "engineering-team",
+  "groupId": "engineering-group"
+}