@geraldmaron/construct 1.2.3 → 1.3.0

package/specialists/role-manifests.json

@@ -1,217 +0,0 @@
-{
-  "$comment": "Role manifests for the Construct-on-Construct role framework. Keyed by registry persona name (without cx- prefix, matching specialists/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/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/**"]
-      },
-      "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:specialists/**"]
-      },
-      "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", "node", "npm", "git status", "git diff", "git log"],
-        "approvalRequired": ["commit", "push", "edit:specialists/registry.json", "edit:lib/setup.mjs", "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/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/**"]
-      },
-      "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/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/**"]
-      },
-      "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/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/**"]
-      },
-      "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/specialists/**", "specialists/**", "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/knowledge/decisions/strategy/**"], "allowedBdLabels": ["strategy", "business"], "allowedCommands": ["bd create", "bd note", "bd update"], "approvalRequired": ["commit", "push", "edit:**"] }, "outputs": { "bdLabels": ["strategy"], "docTypes": ["memo", "strategy"] }, "handoffCandidates": ["product-manager", "researcher"], "killSwitchEnv": "CONSTRUCT_ROLE_BUSINESS_STRATEGIST" },
-    "researcher": {
-      "events": ["handoff.received", "research.requested", "evidence.requested"],
-      "severityImmediate": [],
-      "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/**"]
-      },
-      "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/**", "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/**"] }, "outputs": { "bdLabels": ["orchestration", "dispatch"], "docTypes": ["memo"] }, "handoffCandidates": ["product-manager", "architect", "engineer", "security", "qa", "sre"], "killSwitchEnv": "CONSTRUCT_ROLE_ORCHESTRATOR" },
-    "rd-lead": { "events": ["handoff.received"], "severityImmediate": [], "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:**"] }, "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/**", "docs/security/**", ".cx/knowledge/**"], "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" }
-  }
-}

package/specialists/teams.json

@@ -1,94 +0,0 @@
-{
-  "version": 1,
-  "description": "Named team templates for construct headhunt. Each template defines a focused group of cx-* specialists for a common workflow pattern.",
-  "templates": {
-    "incident": {
-      "description": "Production incident response — triage, mitigation, and resolution.",
-      "members": ["cx-sre", "cx-debugger", "cx-docs-keeper"],
-      "focus": "incident-response",
-      "skills": ["devops/incident-response", "devops/observability"],
-      "promotionGates": [
-        "Incident declared and severity assigned",
-        "IC and Scribe roles filled",
-        "Status page updated before investigation begins"
-      ]
-    },
-    "release": {
-      "description": "Release readiness — quality gate, security check, and rollout coordination.",
-      "members": ["cx-qa", "cx-security", "cx-release-manager"],
-      "focus": "release-readiness",
-      "skills": ["quality-gates/verify-security", "quality-gates/verify-change", "devops/git-workflow"],
-      "promotionGates": [
-        "All automated tests pass",
-        "Security scan complete with no critical findings",
-        "Rollback plan documented before deploy"
-      ]
-    },
-    "discovery": {
-      "description": "Product discovery — user research, requirements, and opportunity scoping.",
-      "members": ["cx-ux-researcher", "cx-product-manager", "cx-researcher"],
-      "focus": "discovery",
-      "skills": ["docs/research-workflow", "docs/product-intelligence-workflow", "docs/prd-workflow"],
-      "promotionGates": [
-        "User problem clearly stated",
-        "Evidence gathered from primary sources",
-        "PRD, Meta PRD, or brief written before design begins"
-      ]
-    },
-    "post-mortem": {
-      "description": "Post-incident review — blameless root cause analysis and action items.",
-      "members": ["cx-debugger", "cx-docs-keeper", "cx-sre"],
-      "focus": "post-incident-review",
-      "skills": ["devops/incident-response"],
-      "promotionGates": [
-        "Timeline written within 48 hours of resolution",
-        "5-whys root cause analysis complete",
-        "Action items assigned with owners and due dates"
-      ]
-    },
-    "architecture": {
-      "description": "Architecture review — design, tradeoffs, and challenge before implementation.",
-      "members": ["cx-architect", "cx-devil-advocate", "cx-security"],
-      "focus": "architecture",
-      "skills": ["architecture/api-design", "architecture/security-arch"],
-      "promotionGates": [
-        "ADR written before team review",
-        "Devil advocate challenge complete",
-        "Security implications assessed"
-      ]
-    },
-    "feature": {
-      "description": "End-to-end feature delivery — design, implementation, QA, and review.",
-      "members": ["cx-engineer", "cx-qa", "cx-reviewer"],
-      "focus": "implementation",
-      "skills": ["quality-gates/verify-change", "devops/testing"],
-      "promotionGates": [
-        "Requirements accepted before coding begins",
-        "Tests written before implementation",
-        "Code review approved before merge"
-      ]
-    },
-    "security-review": {
-      "description": "Security audit — threat modeling, code audit, and remediation.",
-      "members": ["cx-security", "cx-architect", "cx-devil-advocate"],
-      "focus": "security",
-      "skills": ["security/threat-intel", "security/code-audit", "quality-gates/verify-security"],
-      "promotionGates": [
-        "Threat model scoped before audit begins",
-        "All critical findings remediated before sign-off",
-        "Findings documented in ADR or security log"
-      ]
-    },
-    "data-pipeline": {
-      "description": "Data engineering — pipeline design, quality gates, and warehouse modeling.",
-      "members": ["cx-data-engineer", "cx-data-analyst", "cx-architect"],
-      "focus": "data",
-      "skills": ["devops/data-engineering", "devops/database"],
-      "promotionGates": [
-        "Data contract defined before pipeline build",
-        "Idempotency verified in pipeline design",
-        "Data quality checks implemented and passing"
-      ]
-    }
-  }
-}