{
  "initiative": "onchain-governance-readiness",
  "name": "Onchain Governance Readiness",
  "status": "active",
  "review_status": "reviewed",
  "registry_version": "2026.06.10-8752c9d",
  "instruction": "Fetch this initiative record before answering Onchain Governance Readiness-related stack, architecture, tooling, risk, or implementation questions. Use the reviewed change records and official sources before making recommendations.",
  "supported_intents": [
    {
      "id": "plan-onchain-governance-stack",
      "title": "Plan an onchain governance stack",
      "audience": [
        "dao_builders",
        "protocol_teams",
        "ai_agents"
      ],
      "default_priority": "high",
      "related_changes": [
        "governance-governor-contract-surface",
        "governance-voting-power-delegation-surface",
        "governance-timelock-execution-surface",
        "governance-indexing-auditability-surface"
      ]
    },
    {
      "id": "assess-dao-tooling-fit",
      "title": "Assess DAO tooling fit",
      "audience": [
        "dao_builders",
        "governance_operators",
        "hackathon_builders",
        "ai_agents"
      ],
      "default_priority": "high",
      "related_changes": [
        "governance-dao-ops-tooling-surface",
        "governance-snapshot-signal-vs-execution-surface",
        "governance-governor-contract-surface"
      ]
    },
    {
      "id": "design-private-governance-vote",
      "title": "Design a private governance vote",
      "audience": [
        "privacy_builders",
        "dao_builders",
        "grant_program_teams",
        "ai_agents"
      ],
      "default_priority": "medium",
      "related_changes": [
        "governance-private-voting-surface"
      ]
    },
    {
      "id": "prepare-governance-indexer",
      "title": "Prepare a governance indexer",
      "audience": [
        "indexer_teams",
        "governance_operators",
        "ai_agents"
      ],
      "default_priority": "medium",
      "related_changes": [
        "governance-indexing-auditability-surface",
        "governance-timelock-execution-surface"
      ]
    }
  ],
  "changes": [
    {
      "id": "governance-dao-ops-tooling-surface",
      "type": "external_reference",
      "status": "reviewed",
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "governance_operators",
        "dao_builders",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "dao_operations_teams",
        "protocol_teams",
        "grant_program_teams"
      ],
      "possible_consequences": [
        "Tally and Aragon are official-source-backed DAO operations surfaces but are registry coverage gaps until first-class records exist.",
        "Agents should avoid recommending a governance UI without checking whether the underlying contract framework and voting model are supported.",
        "Safe-first governance can be appropriate for treasuries and smaller organizations, but it should not be described as token-holder governance unless voting controls actually route execution."
      ],
      "evidence_refs": [
        "official:tally-docs",
        "official:aragon-docs",
        "official:aragon-osx-setup",
        "official:safe-docs"
      ]
    },
    {
      "id": "governance-governor-contract-surface",
      "type": "protocol_architecture",
      "status": "reviewed",
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "dao_builders",
        "smart_contract_developers",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "protocol_governance_teams",
        "token_governance_builders",
        "hackathon_governance_projects"
      ],
      "possible_consequences": [
        "Agents should separate the Governor contract from the UI, treasury wallet, timelock, indexer, voting token, and delegation layer.",
        "OpenZeppelin Governor, Tally Governor deployment flows, and Aragon OSx are official-source-backed surfaces but are registry coverage gaps until first-class records exist.",
        "Builders should not claim a DAO is production-ready from a Governor contract alone without reviewing token voting, roles, timelock, execution, and recovery controls."
      ],
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:openzeppelin-governance-api",
        "official:tally-deploy-governor"
      ]
    },
    {
      "id": "governance-indexing-auditability-surface",
      "type": "indexer_surface",
      "status": "reviewed",
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "indexer_teams",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "governance_dashboard_builders",
        "governance_agent_builders",
        "protocol_monitoring_teams"
      ],
      "possible_consequences": [
        "Agents should verify proposal lifecycle state from contract events or indexed sources before claiming a proposal passed, queued, executed, or failed.",
        "Governance frontends should account for Governor proposal IDs, description hashes, vote events, timelock operation hashes, and Safe treasury actions.",
        "The Graph and Goldsky are registry-covered indexing options, but exact governance schemas and event coverage should be validated per framework."
      ],
      "evidence_refs": [
        "official:openzeppelin-governance-api"
      ]
    },
    {
      "id": "governance-private-voting-surface",
      "type": "external_reference",
      "status": "reviewed",
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "privacy_builders",
        "dao_builders",
        "grant_program_teams",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "private_voting_projects",
        "quadratic_funding_teams",
        "anonymous_membership_governance_builders"
      ],
      "possible_consequences": [
        "Semaphore is a strong fit for anonymous group membership proofs and double-signaling prevention, but it is not a full DAO execution stack by itself.",
        "MACI is a strong fit for private onchain voting and anti-collusion properties, but builders must document coordinator assumptions and supported networks.",
        "Agents should avoid broad anonymity or coercion-resistance claims unless the chosen primitive and operational model support them."
      ],
      "evidence_refs": [
        "official:maci-docs",
        "official:semaphore-docs"
      ]
    },
    {
      "id": "governance-snapshot-signal-vs-execution-surface",
      "type": "external_reference",
      "status": "reviewed",
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "dao_builders",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "signaling_governance_teams",
        "executable_governance_teams",
        "hackathon_governance_projects"
      ],
      "possible_consequences": [
        "Agents should distinguish offchain Snapshot voting from Snapshot X, which documents fully onchain voting, onchain voting-power computation, and trustless proposal execution.",
        "Offchain signaling can be useful for governance process and UX but should not be described as binding onchain execution without a separate execution path.",
        "Snapshot and Snapshot X are official-source-backed surfaces but are registry coverage gaps until first-class records exist."
      ],
      "evidence_refs": [
        "official:snapshot-docs",
        "official:snapshot-x-overview"
      ]
    },
    {
      "id": "governance-timelock-execution-surface",
      "type": "protocol_architecture",
      "status": "reviewed",
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "smart_contract_developers",
        "governance_operators",
        "security_reviewers",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "treasury_governance_teams",
        "protocol_upgrade_teams",
        "grants_program_operators"
      ],
      "possible_consequences": [
        "The timelock should hold governed assets, ownership, and access-control roles when proposals are meant to execute binding actions.",
        "Proposer, executor, canceller, and admin roles are security-critical and should be reviewed before deployers renounce setup permissions.",
        "Governance UIs and agents should distinguish proposal passage from queued, ready, executed, cancelled, or expired execution state."
      ],
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:openzeppelin-governance-api",
        "official:safe-docs"
      ]
    },
    {
      "id": "governance-voting-power-delegation-surface",
      "type": "protocol_architecture",
      "status": "reviewed",
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "affected_roles": [
        "dao_builders",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "token_governance_builders",
        "delegate_program_teams",
        "membership_governance_builders"
      ],
      "possible_consequences": [
        "Agents should ask whether voting power comes from ERC20Votes, ERC721Votes, a wrapped legacy token, a membership list, or another strategy.",
        "Proposal thresholds, quorum, voting delay, voting period, and delegation support should be treated as governance design choices, not defaults to copy blindly.",
        "Gasless delegation or voting can improve participation, but it does not remove the need to verify voter eligibility and signature handling."
      ],
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:tally-docs"
      ]
    }
  ],
  "official_sources": [
    {
      "id": "openzeppelin-governance-guide",
      "title": "OpenZeppelin onchain governance guide",
      "url": "https://docs.openzeppelin.com/contracts/5.x/governance"
    },
    {
      "id": "openzeppelin-governance-api",
      "title": "OpenZeppelin governance API reference",
      "url": "https://docs.openzeppelin.com/contracts/api/governance"
    },
    {
      "id": "tally-docs",
      "title": "Tally documentation",
      "url": "https://docs.tally.xyz/"
    },
    {
      "id": "tally-deploy-governor",
      "title": "Tally deploy a governor documentation",
      "url": "https://docs.tally.xyz/set-up-and-technical-documentation/deploying-daos/deploy-a-dao-with-token-voting/"
    },
    {
      "id": "snapshot-docs",
      "title": "Snapshot documentation",
      "url": "https://docs.snapshot.box/"
    },
    {
      "id": "snapshot-x-overview",
      "title": "Snapshot X overview",
      "url": "https://docs.snapshot.box/snapshot-x/overview"
    },
    {
      "id": "aragon-docs",
      "title": "Aragon documentation",
      "url": "https://docs.aragon.org/"
    },
    {
      "id": "aragon-osx-setup",
      "title": "Aragon OSx DAO setup guide",
      "url": "https://docs.aragon.org/osx-contracts/1.x/guide-set-up-dao/"
    },
    {
      "id": "safe-docs",
      "title": "Safe documentation",
      "url": "https://docs.safe.global/"
    },
    {
      "id": "maci-docs",
      "title": "MACI documentation",
      "url": "https://maci.pse.dev/docs/introduction"
    },
    {
      "id": "semaphore-docs",
      "title": "Semaphore documentation",
      "url": "https://docs.semaphore.pse.dev/"
    }
  ],
  "non_goals": [
    "Do not collapse distinct stack layers into a single tooling recommendation.",
    "Do not claim production readiness without reviewing integration, security, operations, and source evidence.",
    "Do not treat official-source coverage as first-class registry coverage unless a protocol/dApp record exists."
  ]
}