{
  "schema": "https://vibegov.io/schemas/role-catalog.v1.json",
  "name": "vibegov-role-catalog",
  "version": "2026.5.6-local",
  "source": "https://vibegov.io/roles",
  "roles": [
    {
      "id": "developer",
      "name": "Developer",
      "summary": "Developer agent role pack for GitHub-source-of-truth issue execution, coding, testing, git hygiene, and release closure.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/developer/BOOTSTRAP.md",
      "manifest": "/roles/developer/developer.manifest.json",
      "roleContract": "/roles/developer/ROLE.md",
      "humanManifest": "/roles/developer/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/developer/overlays/existing-repo-init.md",
        "/roles/developer/overlays/fresh-bootstrap.md",
        "/roles/developer/overlays/recovery-update.md",
        "/roles/developer/overlays/github-source-of-truth.md",
        "/roles/developer/overlays/git-closure.md"
      ]
    },
    {
      "id": "planner",
      "name": "Planner",
      "summary": "Planner agent role pack for GitHub-source-of-truth intake, issue quality, prioritisation, backlog hygiene, and Developer handoff.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/planner/BOOTSTRAP.md",
      "manifest": "/roles/planner/planner.manifest.json",
      "roleContract": "/roles/planner/ROLE.md",
      "humanManifest": "/roles/planner/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/planner/overlays/existing-repo-init.md",
        "/roles/planner/overlays/fresh-bootstrap.md",
        "/roles/planner/overlays/recovery-update.md",
        "/roles/planner/overlays/github-source-of-truth.md",
        "/roles/planner/overlays/developer-handoff.md"
      ]
    },
    {
      "id": "researcher",
      "name": "Researcher",
      "summary": "Researcher agent role pack for evidence gathering, source evaluation, cited synthesis, research artifacts, and Planner/Developer handoff.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/researcher/BOOTSTRAP.md",
      "manifest": "/roles/researcher/researcher.manifest.json",
      "roleContract": "/roles/researcher/ROLE.md",
      "humanManifest": "/roles/researcher/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/researcher/overlays/existing-repo-init.md",
        "/roles/researcher/overlays/fresh-bootstrap.md",
        "/roles/researcher/overlays/recovery-update.md",
        "/roles/researcher/overlays/evidence-and-citations.md",
        "/roles/researcher/overlays/planner-developer-handoff.md"
      ]
    },
    {
      "id": "explorer",
      "name": "Explorer",
      "summary": "Explorer agent role pack for product/repo/UI/API exploration, evidence capture, finding triage, spec gaps, and GitHub issue follow-up.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/explorer/BOOTSTRAP.md",
      "manifest": "/roles/explorer/explorer.manifest.json",
      "roleContract": "/roles/explorer/ROLE.md",
      "humanManifest": "/roles/explorer/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/explorer/overlays/existing-repo-init.md",
        "/roles/explorer/overlays/fresh-bootstrap.md",
        "/roles/explorer/overlays/recovery-update.md",
        "/roles/explorer/overlays/ui-route-exploration.md",
        "/roles/explorer/overlays/api-contract-exploration.md",
        "/roles/explorer/overlays/github-findings.md"
      ]
    },
    {
      "id": "designer",
      "name": "Designer",
      "summary": "Designer / UX role pack for UI intent, Design Language System stewardship, flows, component patterns, accessibility-by-design, and design acceptance criteria.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/designer/BOOTSTRAP.md",
      "manifest": "/roles/designer/designer.manifest.json",
      "roleContract": "/roles/designer/ROLE.md",
      "humanManifest": "/roles/designer/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/designer/overlays/design-language-system.md",
        "/roles/designer/overlays/ui-flow-contracts.md",
        "/roles/designer/overlays/component-patterns.md",
        "/roles/designer/overlays/accessibility-by-design.md",
        "/roles/designer/overlays/design-review.md"
      ]
    },
    {
      "id": "verifier",
      "name": "Verifier",
      "summary": "Verifier / QA agent role pack for independent validation, regression, acceptance evidence, and release confidence.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/verifier/BOOTSTRAP.md",
      "manifest": "/roles/verifier/verifier.manifest.json",
      "roleContract": "/roles/verifier/ROLE.md",
      "humanManifest": "/roles/verifier/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/verifier/overlays/validation-plan.md",
        "/roles/verifier/overlays/regression-evidence.md",
        "/roles/verifier/overlays/acceptance-gates.md",
        "/roles/verifier/overlays/bug-reporting.md",
        "/roles/verifier/overlays/release-signoff.md"
      ]
    },
    {
      "id": "maintainer",
      "name": "Maintainer",
      "summary": "Maintainer / Release Manager role pack for repo hygiene, branch closure, changelogs, versioning, releases, and deploy readiness.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/maintainer/BOOTSTRAP.md",
      "manifest": "/roles/maintainer/maintainer.manifest.json",
      "roleContract": "/roles/maintainer/ROLE.md",
      "humanManifest": "/roles/maintainer/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/maintainer/overlays/branch-hygiene.md",
        "/roles/maintainer/overlays/release-readiness.md",
        "/roles/maintainer/overlays/changelog-versioning.md",
        "/roles/maintainer/overlays/dependency-maintenance.md",
        "/roles/maintainer/overlays/stale-work-cleanup.md"
      ]
    },
    {
      "id": "operator",
      "name": "Operator",
      "summary": "Operator / Chief-of-Staff role pack for recurring sweeps, task/state orchestration, reminders, and operational follow-through.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/operator/BOOTSTRAP.md",
      "manifest": "/roles/operator/operator.manifest.json",
      "roleContract": "/roles/operator/ROLE.md",
      "humanManifest": "/roles/operator/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/operator/overlays/daily-sweep.md",
        "/roles/operator/overlays/task-ledger.md",
        "/roles/operator/overlays/heartbeat-cron.md",
        "/roles/operator/overlays/escalation-routing.md",
        "/roles/operator/overlays/status-reporting.md"
      ]
    },
    {
      "id": "architect",
      "name": "Architect",
      "summary": "Architect role pack for system design, ADRs, boundaries, migrations, technical direction, and implementation handoff constraints.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/architect/BOOTSTRAP.md",
      "manifest": "/roles/architect/architect.manifest.json",
      "roleContract": "/roles/architect/ROLE.md",
      "humanManifest": "/roles/architect/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/architect/overlays/adr-authoring.md",
        "/roles/architect/overlays/system-boundaries.md",
        "/roles/architect/overlays/migration-planning.md",
        "/roles/architect/overlays/technical-risk.md",
        "/roles/architect/overlays/implementation-handoff.md"
      ]
    },
    {
      "id": "security",
      "name": "Security",
      "summary": "Security / Compliance Reviewer role pack for threat modelling, secrets, auth, privacy, license, dependency, and exposure review.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/security/BOOTSTRAP.md",
      "manifest": "/roles/security/security.manifest.json",
      "roleContract": "/roles/security/ROLE.md",
      "humanManifest": "/roles/security/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/security/overlays/threat-model.md",
        "/roles/security/overlays/secrets-auth.md",
        "/roles/security/overlays/privacy-logging.md",
        "/roles/security/overlays/dependency-license.md",
        "/roles/security/overlays/exposure-review.md"
      ]
    },
    {
      "id": "documenter",
      "name": "Documenter",
      "summary": "Documenter / Comms role pack for READMEs, install guides, changelogs, user docs, release summaries, and public-facing explanations.",
      "version": "2026.5.6-local",
      "entrypoint": "/roles/documenter/BOOTSTRAP.md",
      "manifest": "/roles/documenter/documenter.manifest.json",
      "roleContract": "/roles/documenter/ROLE.md",
      "humanManifest": "/roles/documenter/MANIFEST.md",
      "common": [
        "/roles/_common/BOOTSTRAP-CHECKLIST.md",
        "/roles/_common/source-of-truth-policy.md",
        "/roles/_common/authority-and-escalation.md",
        "/roles/_common/heartbeat-orchestration.md",
        "/roles/_common/INSTALL-CHECKLIST.md",
        "/roles/_common/squad-operating-model.md"
      ],
      "overlays": [
        "/roles/documenter/overlays/readme-install.md",
        "/roles/documenter/overlays/release-notes.md",
        "/roles/documenter/overlays/api-docs.md",
        "/roles/documenter/overlays/user-guides.md",
        "/roles/documenter/overlays/public-comms.md"
      ]
    }
  ],
  "common": [
    "/roles/_common/BOOTSTRAP-CHECKLIST.md",
    "/roles/_common/source-of-truth-policy.md",
    "/roles/_common/authority-and-escalation.md",
    "/roles/_common/heartbeat-orchestration.md",
    "/roles/_common/INSTALL-CHECKLIST.md",
    "/roles/_common/squad-operating-model.md"
  ],
  "bootstrapPromptTemplate": "Bootstrap yourself as the {{role}} agent for {{project_path}}. Fresh-read https://vibegov.io/roles/index.json and https://vibegov.io/roles/{{role}}/BOOTSTRAP.md, then follow the manifest exactly. Inspect the project before writing, select fresh-bootstrap, existing-repo-init, or recovery-update, merge role files safely, apply relevant overlays, validate the install, and return a bootstrap report.",
  "roleTaxonomy": {
    "controlPlane": [
      "architect",
      "designer",
      "security",
      "operator"
    ],
    "flowIntake": [
      "planner"
    ],
    "discovery": [
      "researcher",
      "explorer"
    ],
    "delivery": [
      "developer"
    ],
    "confidence": [
      "verifier",
      "automation"
    ],
    "releaseStewardship": [
      "maintainer"
    ],
    "communication": [
      "documenter"
    ]
  },
  "operatingPrinciples": [
    "Planner owns flow and issue quality",
    "Architect owns shape and technical direction",
    "Designer owns UI/UX intent and the Design Language System",
    "Developer owns delivery of Ready work",
    "Automation owns objective proof",
    "develop is the integration truth",
    "main is the release truth",
    "Ready means clear, scoped, risk-classified, and releasable",
    "Done means integrated, green, and closure criteria met",
    "Branches are temporary implementation workspaces, not product states",
    "Toggles are configuration and product controls, not unfinished-code hiding places",
    "Agents may propose broadly but act only within their authority"
  ],
  "routingLabels": [
    "project:needs-analysis",
    "project:needs-research",
    "project:needs-exploration",
    "project:needs-design",
    "project:needs-architecture",
    "project:needs-security",
    "project:needs-docs",
    "project:ready-for-dev",
    "project:blocked",
    "project:cross-repo",
    "project:parking-lot",
    "risk:low",
    "risk:medium",
    "risk:high",
    "type:bug",
    "type:feature",
    "type:refactor",
    "type:docs",
    "type:test",
    "type:security",
    "type:research",
    "type:exploration",
    "type:chore",
    "type:release",
    "area:frontend",
    "area:backend",
    "area:api",
    "area:infra",
    "area:auth",
    "area:docs",
    "area:tests",
    "area:deps",
    "area:ui",
    "area:data",
    "area:ci",
    "ops:stale",
    "ops:needs-owner",
    "ops:needs-follow-up",
    "ops:blocked-check",
    "ops:ready-queue-low",
    "ops:handoff-needed",
    "ops:waiting-review"
  ],
  "sourceOfTruth": {
    "operationalState": "Project board or repo-declared equivalent",
    "workContract": "Issue",
    "requirementsAndAcceptance": "OpenSpec, spec, or issue brief",
    "technicalDirection": "ADRs / architecture notes",
    "designIntent": "Design brief, DLS contract, component/flow spec",
    "integrationState": "develop or configured integration branch",
    "releaseState": "main or configured release branch",
    "objectiveQualityProof": "CI / automation pipeline",
    "followUpAndUnresolvedWork": "Linked issues"
  },
  "boardColumns": [
    "No status",
    "Backlog",
    "Ready",
    "In Progress - In Dev",
    "In Review - In Test",
    "Done",
    "Blocked",
    "Parking Lot"
  ],
  "definitions": {
    "ready": "Issue is clear, scoped, risk-classified, required inputs are complete or explicitly not applicable, and it can land as a releasable increment.",
    "done": "Change is integrated into the configured integration branch, objective gates are green, acceptance criteria are met, docs/tests/config are updated where required, and follow-ups are linked."
  }
}