{
  "schema": "https://vibegov.io/schemas/agent-role-manifest.v1.json",
  "role": "researcher",
  "version": "2026.5.6-local",
  "entrypoint": "BOOTSTRAP.md",
  "summary": "Researcher agent role pack for evidence gathering, source evaluation, cited synthesis, research artifacts, and Planner/Developer handoff.",
  "install": {
    "defaultMode": "merge",
    "neverBlindOverwrite": [
      "MEMORY.md",
      "USER.md",
      "TOOLS.md",
      "AGENTS.md"
    ],
    "requiresBootstrapReport": true
  },
  "files": [
    {
      "path": "BOOTSTRAP.md",
      "purpose": "self-bootstrap entrypoint",
      "merge": "replace-from-role-pack-ok"
    },
    {
      "path": "ROLE.md",
      "purpose": "role contract",
      "merge": "replace-from-role-pack-ok"
    },
    {
      "path": "MANIFEST.md",
      "purpose": "human manifest/checklist",
      "merge": "replace-from-role-pack-ok"
    },
    {
      "path": "files/AGENTS.md",
      "dest": "AGENTS.md",
      "purpose": "operational rules",
      "merge": "preserve-local-rules"
    },
    {
      "path": "files/SOUL.md",
      "dest": "SOUL.md",
      "purpose": "role persona",
      "merge": "create-if-missing-or-append-role"
    },
    {
      "path": "files/TOOLS.md",
      "dest": "TOOLS.md",
      "purpose": "local tooling and source notes",
      "merge": "preserve-local-facts"
    },
    {
      "path": "files/IDENTITY.md",
      "dest": "IDENTITY.md",
      "purpose": "role identity",
      "merge": "create-if-missing"
    },
    {
      "path": "files/USER.md",
      "dest": "USER.md",
      "purpose": "stakeholder/project context",
      "merge": "preserve-local-facts"
    },
    {
      "path": "files/HEARTBEAT.md",
      "dest": "HEARTBEAT.md",
      "purpose": "proactive research duties",
      "merge": "merge-checklists"
    },
    {
      "path": "files/MEMORY.md",
      "dest": "MEMORY.md",
      "purpose": "initial durable memory",
      "merge": "preserve-local-facts"
    }
  ],
  "overlays": [
    {
      "path": "overlays/existing-repo-init.md",
      "mode": "existing-repo-init"
    },
    {
      "path": "overlays/fresh-bootstrap.md",
      "mode": "fresh-bootstrap"
    },
    {
      "path": "overlays/recovery-update.md",
      "mode": "recovery-update"
    },
    {
      "path": "overlays/evidence-and-citations.md",
      "mode": "all"
    },
    {
      "path": "overlays/planner-developer-handoff.md",
      "mode": "all"
    }
  ],
  "requiredReportFields": [
    "role",
    "initMode",
    "repo",
    "githubSourceOfTruth",
    "researchQuestion",
    "evidenceConventions",
    "sourcesChecked",
    "confidence",
    "handoff",
    "blockers"
  ],
  "common": [
    "../_common/BOOTSTRAP-CHECKLIST.md",
    "../_common/source-of-truth-policy.md",
    "../_common/authority-and-escalation.md",
    "../_common/heartbeat-orchestration.md",
    "../_common/INSTALL-CHECKLIST.md",
    "../_common/squad-operating-model.md"
  ]
}