Onchain Governance Readiness
Evidence-backed governance guidance for agents and builders choosing DAO, voting, execution, privacy, and treasury-control stacks.
Choose the stack before you ship.
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.
Composewith separates stack layers, registry coverage gaps, implementation caveats, and official source evidence so agents can recommend a credible path without overclaiming maturity.
Tracked surfaces and consequences.
Each record maps a stack surface to affected roles, likely builder consequences, recommended action, and official evidence refs.
governance dao ops tooling surface actionable
DAO operations tooling covers proposal creation, delegate profiles, voting interfaces, templates, Safe integration, organization settings, and governance admin workflows.
Action: assess · Priority: medium · Status: reviewed
- 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.
governance governor contract surface actionable
Governor contracts define proposal creation, voting, quorum, vote counting, and execution mechanics, but they are only one layer of a complete governance stack.
Action: assess · Priority: high · Status: reviewed
- 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.
governance indexing auditability surface actionable
Governance UIs and agents need reliable indexing for proposals, votes, delegation, quorum, queueing, execution, cancellation, and treasury actions.
Action: assess · Priority: medium · Status: reviewed
- 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.
governance private voting surface actionable
Private governance voting requires choosing between membership privacy, vote privacy, coercion resistance, tally verification, and coordinator trust assumptions.
Action: assess · Priority: high · Status: reviewed
- 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.
governance snapshot signal vs execution surface actionable
Snapshot-style governance can mean offchain gasless signaling or Snapshot X fully onchain voting, and agents should not collapse those into one execution model.
Action: assess · Priority: medium · Status: reviewed
- 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.
governance timelock execution surface actionable
Timelocks and execution roles decide when approved proposals can affect protocol contracts, treasuries, and permissions.
Action: assess · Priority: high · Status: reviewed
- 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.
governance voting power delegation surface actionable
Voting power and delegation determine who can propose, vote, meet quorum, and represent token holders or members.
Action: assess · Priority: high · Status: reviewed
- 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.
Onchain Governance Readiness intents.
Agents should pick one of these initiative intents before answering or charging for a paid assessment call.
Plan an onchain governance stack
Return the smallest credible governance stack for one DAO or protocol control model, with voting, execution, treasury, indexing, and privacy caveats separated.
Inputs: 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
Assess DAO tooling fit
Decide whether a project should start from OpenZeppelin Governor, Tally, Snapshot X, Aragon OSx, Safe-first controls, or a smaller signaling-only flow.
Inputs: 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
Design a private governance vote
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.
Inputs: privacy goal, voter eligibility model, whether votes or membership should be hidden, collusion-resistance requirement, result publication requirements, coordinator trust assumptions
Prepare a governance indexer
Identify proposal, vote, queue, execute, cancellation, delegation, and treasury events that should be indexed before a governance UI or agent makes claims about state.
Inputs: governor or DAO framework, target chains, proposal lifecycle events, voting strategy or delegation model, treasury and timelock contracts
Structured initiative guidance.
{
"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."
]
}Official sources first.
Composewith summarizes and structures official inputs. It does not replace project documentation, protocol specifications, security reviews, or implementation guides.
Formats: Markdown · JSON · Agent JSON · Changes JSON