{
  "schema_version": "initiative.v1",
  "id": "onchain-governance-readiness",
  "name": "Onchain Governance Readiness",
  "status": "active",
  "summary": "Evidence-backed governance guidance for agents and builders choosing DAO, voting, execution, privacy, and treasury-control stacks.",
  "problem": "Onchain governance builders need more than a generic DAO tooling recommendation. Agents should distinguish voting contracts from voting UIs, offchain signaling from executable onchain proposals, treasury controls from voter eligibility, and public voting from private or anti-collusion voting before recommending a stack.",
  "audiences": [
    "dao_builders",
    "protocol_teams",
    "governance_operators",
    "grant_program_teams",
    "hackathon_builders",
    "ai_agents",
    "jury_reviewers"
  ],
  "tags": [
    "governance",
    "dao",
    "voting",
    "treasury",
    "timelock",
    "delegation",
    "privacy",
    "indexing"
  ],
  "homepage_url": "https://docs.openzeppelin.com/contracts/5.x/governance",
  "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/"
    }
  ],
  "related_chains": [
    "ethereum",
    "arbitrum-one",
    "base",
    "optimism"
  ],
  "related_protocols": [
    "safe",
    "maci",
    "semaphore",
    "the-graph",
    "goldsky",
    "arbitrum-one",
    "base",
    "optimism"
  ],
  "related_intents": [
    "build-private-onchain-voting",
    "deploy-on-a-low-cost-l2",
    "gasless-onboarding"
  ],
  "initiative_intents": [
    {
      "id": "plan-onchain-governance-stack",
      "title": "Plan an onchain governance stack",
      "description": "Return the smallest credible governance stack for one DAO or protocol control model, with voting, execution, treasury, indexing, and privacy caveats separated.",
      "audience": [
        "dao_builders",
        "protocol_teams",
        "ai_agents"
      ],
      "input_requirements": [
        "governance goal",
        "asset or protocol control surface",
        "voting token or membership model",
        "whether proposals must execute onchain",
        "treasury custody assumptions",
        "privacy or anti-collusion requirements",
        "target chain and timebox"
      ],
      "recommended_outputs": [
        "recommended governance contract path",
        "voting and delegation model",
        "execution and timelock checklist",
        "treasury-control plan",
        "indexing and proposal-state retrieval plan",
        "do-not-claim guidance",
        "official source refs"
      ],
      "related_changes": [
        "governance-governor-contract-surface",
        "governance-voting-power-delegation-surface",
        "governance-timelock-execution-surface",
        "governance-indexing-auditability-surface"
      ],
      "default_priority": "high",
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:openzeppelin-governance-api",
        "official:tally-deploy-governor"
      ]
    },
    {
      "id": "assess-dao-tooling-fit",
      "title": "Assess DAO tooling fit",
      "description": "Decide whether a project should start from OpenZeppelin Governor, Tally, Snapshot X, Aragon OSx, Safe-first controls, or a smaller signaling-only flow.",
      "audience": [
        "dao_builders",
        "governance_operators",
        "hackathon_builders",
        "ai_agents"
      ],
      "input_requirements": [
        "desired governance workflow",
        "whether execution is binding",
        "current token or membership source",
        "expected proposer and voter roles",
        "need for proposal templates or DAO operations UI"
      ],
      "recommended_outputs": [
        "tooling fit assessment",
        "registry coverage gaps",
        "fallback stack",
        "source refs",
        "implementation caveats"
      ],
      "related_changes": [
        "governance-dao-ops-tooling-surface",
        "governance-snapshot-signal-vs-execution-surface",
        "governance-governor-contract-surface"
      ],
      "default_priority": "high",
      "evidence_refs": [
        "official:tally-docs",
        "official:snapshot-x-overview",
        "official:aragon-docs"
      ]
    },
    {
      "id": "design-private-governance-vote",
      "title": "Design a private governance vote",
      "description": "Check whether Semaphore or MACI fits a voting app, grant round, or DAO decision process that needs membership privacy, private votes, or anti-collusion properties.",
      "audience": [
        "privacy_builders",
        "dao_builders",
        "grant_program_teams",
        "ai_agents"
      ],
      "input_requirements": [
        "privacy goal",
        "voter eligibility model",
        "whether votes or membership should be hidden",
        "collusion-resistance requirement",
        "result publication requirements",
        "coordinator trust assumptions"
      ],
      "recommended_outputs": [
        "privacy voting fit",
        "MACI versus Semaphore boundary",
        "public governance fallback",
        "do-not-claim guidance",
        "citations"
      ],
      "related_changes": [
        "governance-private-voting-surface"
      ],
      "default_priority": "medium",
      "evidence_refs": [
        "official:maci-docs",
        "official:semaphore-docs"
      ]
    },
    {
      "id": "prepare-governance-indexer",
      "title": "Prepare a governance indexer",
      "description": "Identify proposal, vote, queue, execute, cancellation, delegation, and treasury events that should be indexed before a governance UI or agent makes claims about state.",
      "audience": [
        "indexer_teams",
        "governance_operators",
        "ai_agents"
      ],
      "input_requirements": [
        "governor or DAO framework",
        "target chains",
        "proposal lifecycle events",
        "voting strategy or delegation model",
        "treasury and timelock contracts"
      ],
      "recommended_outputs": [
        "event coverage checklist",
        "stale-data risks",
        "execution-state checks",
        "source refs",
        "fallback retrieval path"
      ],
      "related_changes": [
        "governance-indexing-auditability-surface",
        "governance-timelock-execution-surface"
      ],
      "default_priority": "medium",
      "evidence_refs": [
        "official:openzeppelin-governance-api"
      ]
    }
  ],
  "assessment_modes": [
    "governance_stack_planning",
    "dao_tooling_fit",
    "private_voting_fit",
    "timelock_execution_review",
    "governance_indexer_readiness",
    "treasury_control_review"
  ],
  "evidence_refs": [
    "official:openzeppelin-governance-guide",
    "official:openzeppelin-governance-api",
    "official:tally-docs",
    "official:tally-deploy-governor",
    "official:snapshot-docs",
    "official:snapshot-x-overview",
    "official:aragon-docs",
    "official:aragon-osx-setup",
    "official:safe-docs",
    "official:maci-docs",
    "official:semaphore-docs"
  ],
  "last_verified_at": "2026-06-09",
  "review_status": "reviewed",
  "changes": [
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-dao-ops-tooling-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "external_reference",
      "status": "reviewed",
      "summary": "DAO operations tooling covers proposal creation, delegate profiles, voting interfaces, templates, Safe integration, organization settings, and governance admin workflows.",
      "affected_roles": [
        "governance_operators",
        "dao_builders",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "dao_operations_teams",
        "protocol_teams",
        "grant_program_teams"
      ],
      "affected_protocols": [
        "safe"
      ],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "gasless-onboarding"
      ],
      "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."
      ],
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:tally-docs",
        "official:aragon-docs",
        "official:aragon-osx-setup",
        "official:safe-docs"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-governor-contract-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "protocol_architecture",
      "status": "reviewed",
      "summary": "Governor contracts define proposal creation, voting, quorum, vote counting, and execution mechanics, but they are only one layer of a complete governance stack.",
      "affected_roles": [
        "dao_builders",
        "smart_contract_developers",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "protocol_governance_teams",
        "token_governance_builders",
        "hackathon_governance_projects"
      ],
      "affected_protocols": [
        "safe"
      ],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "deploy-on-a-low-cost-l2"
      ],
      "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."
      ],
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:openzeppelin-governance-api",
        "official:tally-deploy-governor"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-indexing-auditability-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "indexer_surface",
      "status": "reviewed",
      "summary": "Governance UIs and agents need reliable indexing for proposals, votes, delegation, quorum, queueing, execution, cancellation, and treasury actions.",
      "affected_roles": [
        "indexer_teams",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "governance_dashboard_builders",
        "governance_agent_builders",
        "protocol_monitoring_teams"
      ],
      "affected_protocols": [
        "the-graph",
        "goldsky",
        "safe"
      ],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "deploy-on-a-low-cost-l2"
      ],
      "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."
      ],
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:openzeppelin-governance-api"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-private-voting-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "external_reference",
      "status": "reviewed",
      "summary": "Private governance voting requires choosing between membership privacy, vote privacy, coercion resistance, tally verification, and coordinator trust assumptions.",
      "affected_roles": [
        "privacy_builders",
        "dao_builders",
        "grant_program_teams",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "private_voting_projects",
        "quadratic_funding_teams",
        "anonymous_membership_governance_builders"
      ],
      "affected_protocols": [
        "maci",
        "semaphore"
      ],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "build-private-onchain-voting"
      ],
      "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."
      ],
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:maci-docs",
        "official:semaphore-docs"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-snapshot-signal-vs-execution-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "external_reference",
      "status": "reviewed",
      "summary": "Snapshot-style governance can mean offchain gasless signaling or Snapshot X fully onchain voting, and agents should not collapse those into one execution model.",
      "affected_roles": [
        "dao_builders",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "signaling_governance_teams",
        "executable_governance_teams",
        "hackathon_governance_projects"
      ],
      "affected_protocols": [],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "gasless-onboarding"
      ],
      "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."
      ],
      "priority": "medium",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:snapshot-docs",
        "official:snapshot-x-overview"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-timelock-execution-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "protocol_architecture",
      "status": "reviewed",
      "summary": "Timelocks and execution roles decide when approved proposals can affect protocol contracts, treasuries, and permissions.",
      "affected_roles": [
        "smart_contract_developers",
        "governance_operators",
        "security_reviewers",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "treasury_governance_teams",
        "protocol_upgrade_teams",
        "grants_program_operators"
      ],
      "affected_protocols": [
        "safe"
      ],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "deploy-on-a-low-cost-l2"
      ],
      "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."
      ],
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:openzeppelin-governance-api",
        "official:safe-docs"
      ],
      "last_verified_at": "2026-06-09"
    },
    {
      "schema_version": "initiative-change.v1",
      "id": "governance-voting-power-delegation-surface",
      "initiative_id": "onchain-governance-readiness",
      "type": "protocol_architecture",
      "status": "reviewed",
      "summary": "Voting power and delegation determine who can propose, vote, meet quorum, and represent token holders or members.",
      "affected_roles": [
        "dao_builders",
        "governance_operators",
        "ai_agents"
      ],
      "affected_builder_groups": [
        "token_governance_builders",
        "delegate_program_teams",
        "membership_governance_builders"
      ],
      "affected_protocols": [],
      "affected_chains": [
        "ethereum",
        "arbitrum-one",
        "base",
        "optimism"
      ],
      "affected_intents": [
        "gasless-onboarding"
      ],
      "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."
      ],
      "priority": "high",
      "recommended_action": "assess",
      "recommendation_strength": "actionable",
      "evidence_refs": [
        "official:openzeppelin-governance-guide",
        "official:tally-docs"
      ],
      "last_verified_at": "2026-06-09"
    }
  ]
}