@geraldmaron/construct 1.0.0 → 1.0.2

package/agents/role-manifests.json

@@ -0,0 +1,217 @@
+{
+  "$comment": "Role manifests for the Construct-on-Construct role framework. Keyed by registry persona name (without cx- prefix, matching agents/registry.json). Empty entries reserve the slot for future onboarding without code change.",
+  "version": 1,
+  "personas": {
+    "sre": {
+      "events": ["push_gate.fail", "service.down", "mcp.unhealthy.persistent", "edit_loop.stuck"],
+      "severityImmediate": ["service.down"],
+      "fence": {
+        "allowedPaths": ["docs/runbooks/**", "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:agents/**"]
+      },
+      "outputs": {
+        "bdLabels": ["incident", "sre"],
+        "docTypes": ["runbook", "incident-report", "postmortem"]
+      },
+      "handoffCandidates": ["engineer", "platform-engineer", "debugger"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_SRE"
+    },
+    "qa": {
+      "events": ["test.fail", "test.flake", "coverage.drop"],
+      "severityImmediate": [],
+      "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/**"]
+      },
+      "outputs": {
+        "bdLabels": ["bug", "qa"],
+        "docTypes": ["test-plan", "qa-strategy"]
+      },
+      "handoffCandidates": ["engineer", "debugger", "test-automation"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_QA"
+    },
+    "security": {
+      "events": ["dep.cve", "secrets.detected", "config.protection.violation"],
+      "severityImmediate": ["dep.cve", "secrets.detected"],
+      "fence": {
+        "allowedPaths": ["docs/security/**", "docs/threat-models/**"],
+        "allowedBdLabels": ["security", "vulnerability", "audit"],
+        "allowedCommands": ["bd create", "bd note", "bd update", "bd label"],
+        "approvalRequired": ["commit", "push", "edit:**"]
+      },
+      "outputs": {
+        "bdLabels": ["security", "vulnerability"],
+        "docTypes": ["security-review", "threat-model"]
+      },
+      "handoffCandidates": ["engineer", "platform-engineer", "reviewer"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_SECURITY"
+    },
+    "docs-keeper": {
+      "events": ["pr.merged.no-docs", "changelog.missing", "readme.stale"],
+      "severityImmediate": [],
+      "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:agents/**"]
+      },
+      "outputs": {
+        "bdLabels": ["docs", "doc-drift"],
+        "docTypes": ["memo", "changelog"]
+      },
+      "handoffCandidates": ["engineer"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_DOCS_KEEPER"
+    },
+    "engineer": {
+      "events": ["handoff.received", "incident.handoff", "bug.assigned", "feature.assigned"],
+      "severityImmediate": [],
+      "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"],
+        "approvalRequired": ["commit", "push", "edit:agents/registry.json", "edit:install.sh", "edit:claude/settings.template.json"]
+      },
+      "outputs": {
+        "bdLabels": ["engineering", "fix"],
+        "docTypes": ["memo"]
+      },
+      "handoffCandidates": ["qa", "reviewer", "security", "sre"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_ENGINEER"
+    },
+    "architect": {
+      "events": ["handoff.received", "adr.requested", "arch.boundary.violated"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["docs/adr/**", "docs/rfc/**", "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:agents/**"]
+      },
+      "outputs": { "bdLabels": ["architecture", "adr"], "docTypes": ["adr", "rfc", "rfc-platform", "architecture-overview", "system-design"] },
+      "handoffCandidates": ["engineer", "platform-engineer", "reviewer"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_ARCHITECT"
+    },
+    "debugger": {
+      "events": ["handoff.received", "regression.detected", "hang.detected"],
+      "severityImmediate": [],
+      "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/**"]
+      },
+      "outputs": { "bdLabels": ["bug", "regression"], "docTypes": ["memo"] },
+      "handoffCandidates": ["engineer", "qa", "sre"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_DEBUGGER"
+    },
+    "release-manager": {
+      "events": ["handoff.received", "release.candidate", "version.bump.needed"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["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/**"]
+      },
+      "outputs": { "bdLabels": ["release"], "docTypes": ["memo", "changelog"] },
+      "handoffCandidates": ["qa", "engineer", "reviewer", "docs-keeper"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_RELEASE_MANAGER"
+    },
+    "product-manager": {
+      "events": ["handoff.received", "backlog.stale", "prd.requested"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["docs/prd/**", "docs/meta-prd/**", "docs/prfaq/**", "docs/one-pager/**", ".cx/product-intel/**"],
+        "allowedBdLabels": ["product", "prd", "backlog", "feature"],
+        "allowedCommands": ["bd create", "bd note", "bd update", "bd label", "bd priority"],
+        "approvalRequired": ["commit", "push", "edit:lib/**", "edit:bin/**"]
+      },
+      "outputs": { "bdLabels": ["product", "prd"], "docTypes": ["prd", "meta-prd", "prfaq", "one-pager", "backlog-proposal"] },
+      "handoffCandidates": ["architect", "engineer", "designer", "researcher"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_PRODUCT_MANAGER"
+    },
+    "designer": {
+      "events": ["handoff.received", "design.requested"],
+      "severityImmediate": [],
+      "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/**"]
+      },
+      "outputs": { "bdLabels": ["design"], "docTypes": ["memo"] },
+      "handoffCandidates": ["product-manager", "engineer", "accessibility"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_DESIGNER"
+    },
+    "accessibility": {
+      "events": ["handoff.received", "a11y.violation"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["docs/accessibility/**", "docs/a11y/**"],
+        "allowedBdLabels": ["accessibility", "a11y"],
+        "allowedCommands": ["bd create", "bd note", "bd update", "bd label"],
+        "approvalRequired": ["commit", "push", "edit:**"]
+      },
+      "outputs": { "bdLabels": ["accessibility", "a11y"], "docTypes": ["memo"] },
+      "handoffCandidates": ["engineer", "designer", "qa"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_ACCESSIBILITY"
+    },
+    "reviewer": {
+      "events": ["handoff.received", "pr.opened", "pr.ready-for-review"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["docs/reviews/**"],
+        "allowedBdLabels": ["review", "code-review", "second-look"],
+        "allowedCommands": ["bd create", "bd note", "bd update", "bd label"],
+        "approvalRequired": ["commit", "push", "edit:**"]
+      },
+      "outputs": { "bdLabels": ["review"], "docTypes": ["memo"] },
+      "handoffCandidates": ["engineer", "architect", "security"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_REVIEWER"
+    },
+    "platform-engineer": {
+      "events": ["handoff.received", "infra.change.requested", "service.scale.event"],
+      "severityImmediate": [],
+      "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/**"]
+      },
+      "outputs": { "bdLabels": ["platform"], "docTypes": ["memo", "runbook"] },
+      "handoffCandidates": ["sre", "engineer", "reviewer"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_PLATFORM_ENGINEER"
+    },
+    "data-analyst": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/analytics/**", ".cx/analytics/**"], "allowedBdLabels": ["analytics", "metrics"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:lib/**", "edit:bin/**"] }, "outputs": { "bdLabels": ["analytics"], "docTypes": ["memo"] }, "handoffCandidates": ["product-manager", "engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_DATA_ANALYST" },
+    "data-engineer": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/data/**", "docs/etl/**"], "allowedBdLabels": ["data", "etl", "pipeline"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:lib/**", "edit:bin/**"] }, "outputs": { "bdLabels": ["data"], "docTypes": ["memo"] }, "handoffCandidates": ["engineer", "platform-engineer", "data-analyst"], "killSwitchEnv": "CONSTRUCT_ROLE_DATA_ENGINEER" },
+    "evaluator": { "events": ["handoff.received", "eval.regression"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/evals/**", ".cx/evals/**", "tests/evals/**"], "allowedBdLabels": ["eval", "regression-eval"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["eval"], "docTypes": ["memo"] }, "handoffCandidates": ["engineer", "ai-engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_EVALUATOR" },
+    "trace-reviewer": { "events": ["handoff.received", "trace.anomaly"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/traces/**", ".cx/traces/**"], "allowedBdLabels": ["trace", "observability"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["trace"], "docTypes": ["memo"] }, "handoffCandidates": ["sre", "ai-engineer", "engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_TRACE_REVIEWER" },
+    "test-automation": { "events": ["handoff.received"], "severityImmediate": [], "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/**"] }, "outputs": { "bdLabels": ["test-automation"], "docTypes": ["memo"] }, "handoffCandidates": ["qa", "engineer", "platform-engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_TEST_AUTOMATION" },
+    "ai-engineer": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/ai/**", "docs/agents/**", "agents/**", "skills/ai/**"], "allowedBdLabels": ["ai", "agent", "model"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:lib/**", "edit:bin/**"] }, "outputs": { "bdLabels": ["ai"], "docTypes": ["memo"] }, "handoffCandidates": ["engineer", "architect", "evaluator"], "killSwitchEnv": "CONSTRUCT_ROLE_AI_ENGINEER" },
+    "business-strategist": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/strategy/**", ".cx/strategy/**"], "allowedBdLabels": ["strategy", "business"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["strategy"], "docTypes": ["memo"] }, "handoffCandidates": ["product-manager", "researcher"], "killSwitchEnv": "CONSTRUCT_ROLE_BUSINESS_STRATEGIST" },
+    "researcher": {
+      "events": ["handoff.received", "research.requested", "evidence.requested"],
+      "severityImmediate": [],
+      "fence": {
+        "allowedPaths": ["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/**"]
+      },
+      "outputs": { "bdLabels": ["research"], "docTypes": ["research-brief", "evidence-brief", "signal-brief", "product-intelligence-report"] },
+      "handoffCandidates": ["product-manager", "architect", "engineer"],
+      "killSwitchEnv": "CONSTRUCT_ROLE_RESEARCHER"
+    },
+    "ux-researcher": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/ux-research/**", ".cx/ux-research/**"], "allowedBdLabels": ["ux-research", "user-research"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["ux-research"], "docTypes": ["memo"] }, "handoffCandidates": ["product-manager", "designer", "researcher"], "killSwitchEnv": "CONSTRUCT_ROLE_UX_RESEARCHER" },
+    "explorer": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/explorations/**", ".cx/explorations/**"], "allowedBdLabels": ["exploration", "spike"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["exploration"], "docTypes": ["memo"] }, "handoffCandidates": ["engineer", "architect", "researcher"], "killSwitchEnv": "CONSTRUCT_ROLE_EXPLORER" },
+    "operations": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/ops/**", "docs/operations/**"], "allowedBdLabels": ["ops", "operations"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["ops"], "docTypes": ["memo", "runbook"] }, "handoffCandidates": ["sre", "platform-engineer", "release-manager"], "killSwitchEnv": "CONSTRUCT_ROLE_OPERATIONS" },
+    "orchestrator": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/orchestration/**", "docs/workflows/**"], "allowedBdLabels": ["orchestration", "workflow"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["orchestration"], "docTypes": ["memo"] }, "handoffCandidates": ["product-manager", "architect", "engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_ORCHESTRATOR" },
+    "rd-lead": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/research/**", "docs/experiments/**", ".cx/experiments/**"], "allowedBdLabels": ["rd", "research", "experiment"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["rd"], "docTypes": ["memo", "research-brief"] }, "handoffCandidates": ["researcher", "architect", "ai-engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_RD_LEAD" },
+    "legal-compliance": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/legal/**", "docs/compliance/**"], "allowedBdLabels": ["legal", "compliance", "privacy"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["legal", "compliance"], "docTypes": ["memo"] }, "handoffCandidates": ["security", "product-manager"], "killSwitchEnv": "CONSTRUCT_ROLE_LEGAL_COMPLIANCE" },
+    "devil-advocate": { "events": ["handoff.received"], "severityImmediate": [], "fence": { "allowedPaths": ["docs/critiques/**"], "allowedBdLabels": ["critique", "devil-advocate"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["critique"], "docTypes": ["memo"] }, "handoffCandidates": ["architect", "product-manager", "engineer"], "killSwitchEnv": "CONSTRUCT_ROLE_DEVIL_ADVOCATE" }
+  }
+}