Skip to main content

Founding Phase · Private Beta. The Institute is in private beta. Any example content is labelled as such and is never presented as real.

Communication & Representation

Writing a Vote Rationale People Can Audit

The four traits of an auditable rationale, how to attribute evidence, how to state uncertainty without collapsing the decision, how to handle the strongest counterargument, and a drafting workshop that ends with a published, correctable document.

FoundationWorkshop5 h 46 min to 7 h 15 min of workv1.2.0 · effective Aug 9, 2026
Course catalogue

Lesson 1 of 526 min read

The four traits

Context, evidence, tradeoffs and decision - the four traits that make a rationale auditable, and why neither length nor a particular vote is one of them.

What you will be able to do

In plain language

An auditable rationale is a document that lets a stranger follow how you got from a governance action to your position, step by step, without needing to ask you anything. It is built from four ingredients: what the action actually does, what you checked to understand it, what your conclusion costs, and what you decided along with what would change your mind.

Leave any one of the four out and the document stops working as a record, even if it is well written, confident and long. None of the four ingredients is a particular vote. A yes, a no and an abstention can each carry all four traits, or none of them.

Why this matters for a DRep

A DRep who cannot explain their reasoning in a checkable way is, in practice, asking delegators to trust a conclusion rather than a process. If you skip context, a reader cannot tell whether you understood the action. If you skip evidence, nobody can tell your claims from your guesses.

If you skip tradeoffs, your document reads as advertising rather than judgement. If you skip the decision's change conditions, nobody, including you, can tell later whether new information should move you. Each gap quietly shifts the basis of delegation from reasoning to reputation.

A vote rationale has one job that no other governance document has: it lets someone who was not in your head reconstruct how you got from the action to your position. Not agree with it - reconstruct it. That is a lower bar than persuasion and a much higher bar than sincerity, and most published rationales miss it not because their authors reasoned badly but because the document records a conclusion without recording the path.

  • Name the four traits and what each does for a reader.
  • Tell an auditable rationale apart from a merely persuasive one.
  • Find and cut padding without losing substance.
  • Apply the traits equally to a yes, a no and an abstention.

Watch out

This course teaches a drafting standard. It never recommends how to vote on any action, and a rationale that meets every standard here can reach a conclusion you disagree with. That is not a defect in the rationale.

Definitions

Rationale
The published explanation of how a representative reached their position on a specific governance action. In practice it is an off-chain document published at a stable location and referenced from the vote through an anchor, following the general governance-metadata framework in CIP-100.
Auditable
A reader with no prior knowledge and no access to you can follow your reasoning, check your factual claims against named material, and identify where they would diverge.
Context
What the action actually asks for, stated in your own words before any judgement about it.
Evidence
What you checked, where it came from, and what it said - kept distinct from what you concluded from it.
Tradeoff
A cost that your own conclusion imposes, stated as something you accept rather than something you deny.
Decision
Your position, together with the conditions under which you would revise it.
Padding
Any sentence carrying none of the four traits - restatement, throat-clearing, exhortation or reputation management.

The four traits

The obvious answer

A long, detailed rationale that walks through the proposal, quotes community sentiment and lands on a clear yes or no looks like careful, responsible work. Most readers, and most authors, would call it thorough.

What you might be missing

Length and detail are not the same as the four traits. A document can restate the proposal at great length, quote several people, and still contain no fact tied to a source a reader could open, no cost the author's own conclusion imposes, and no condition under which the author would change position. The missing piece is that thoroughness is being judged by volume rather than by whether each sentence carries context, evidence, a tradeoff or a decision.

A reader auditing such a document by counting labelled sentences, not words, often finds it nearly empty of the four traits despite its length, because restating a proposal accurately is not evidence, and quoting supporters is not a tradeoff.

Trait one is context. Before any judgement, say what the action does: the type of action, the amount or parameter at stake, who is asking, and what happens if it passes. Write it in your own words rather than pasting the proposal summary, because the act of restating is what exposes whether you understood it.

A reader who disagrees with your position can still check this section against the action itself, and a context section that misdescribes the action makes everything after it unreadable, and it is also the cheapest defect to fix.

Trait two is evidence. Name what you actually looked at: the metadata anchor, the budget annex, the repository, the parameter values at the epoch you read them, the person you asked. For each, say what it said, and keep that separate from what you took it to mean.

'The annex lists 140,000 ADA for audit work with no named auditor' is evidence. 'The audit line looks like padding' is inference. Both belong in the rationale; conflating them is what makes a claim uncheckable, because the reader cannot tell which part to verify and which part to argue with.

Trait three is tradeoffs. State what is given up if your conclusion prevails. A rationale in which the author's position has no costs is not a rationale, it is an advertisement, and readers discount it accordingly.

If you vote no on a treasury withdrawal, the tradeoff is that the work does not happen on this timeline and the team may not return; say so. If you vote yes, the tradeoff is the funds are committed under uncertainty you have already documented. Naming the cost is not a weakness in the argument - it is the part that shows you weighed something.

Trait four is decision. State the position plainly, and attach the conditions under which you would revise it. Change conditions must be observable by someone other than you: 'if the team publishes signed milestone acceptance from the prior grant' is a condition; 'if I became convinced the team is credible' is a mood.

Concrete conditions are also what make a later change of position legible rather than opportunistic - you told everyone in advance what would move you.

What is not a trait

Length is not a trait. There is no threshold word count below which a rationale is careless or above which it is thorough, and treating length as a proxy pushes writers toward the exact padding that makes documents harder to audit. A three-hundred-word rationale that carries context, evidence, tradeoffs and a decision with change conditions is complete. A three-thousand-word one that restates the proposal at length and never names a cost is not.

A particular vote is not a trait either. Yes, no and abstain are all writable to this standard, and abstention in particular is often written badly - 'I abstained due to insufficient information' names neither what information was missing nor what would have been sufficient, which are precisely the auditable parts. Nothing in this course, and nothing in the Institute's standards, treats one direction as more responsible than another.

Confidence is not a trait. A rationale expressed with certainty is not thereby stronger; the uncertainty lesson deals with this at length. Nor is tone: a measured register is easier to read, but politeness carries no evidential weight, and neither does the invocation of principles the author does not then apply to the facts in front of them.

Strong and weak examples

Fictional composite for training - the weak version

'GA-2026-0142 - Northwind Tooling Collective. I have followed this team's work for a long time and have always been impressed by their commitment to the ecosystem. Governance requires us to support builders who show up, and I believe strongly in supporting infrastructure that benefits everyone.

Having considered the proposal carefully and weighed the arguments on both sides, I have decided to vote yes. I encourage other DReps to consider the importance of tooling for the long-term health of Cardano.' All parties, identifiers and figures in this course are a fictional composite for training and refer to no real person or organisation.

Label that sentence by sentence and almost everything is X. There is no context: a reader cannot tell what the action asks for, how much is requested or over what period. There is no evidence: 'I have followed this team's work' names no document a reader could open.

There is no tradeoff: nothing is given up. There is a decision, but with no change conditions - nothing could ever make this author revise, as far as the reader can tell. The final sentence is exhortation, which is worse than padding because it edges toward telling others how to vote.

Fictional composite for training - the strong version

'GA-2026-0142 - Northwind Tooling Collective. Treasury withdrawal, 480,000 ADA over three tranches across nine months, for open-source indexer tooling. What I verified: the metadata anchor resolves and matches the on-chain action hash (read 6 August 2026).

The budget annex allocates 140,000 ADA to a security audit with no auditor named and no engagement letter attached. The team's prior grant closed in March 2026; the milestone acceptance record for its final milestone is published and signed. What I could not verify: whether the audit line reflects a quoted engagement or an estimate.

I asked the proposers on 4 August and had no reply before the deadline. Tradeoff of my position: voting no means the tooling is not funded on this timeline, and this team may not resubmit. I regard that as a real cost, not a hypothetical one.

Decision: no. I would change to yes on a resubmission that either names the audit provider with a quoted figure, or moves the audit spend into a later tranche conditional on acceptance of the first.'

The strong version is shorter than many published rationales and carries all four traits. Note what it does not do: it does not claim the team is untrustworthy, does not assert that the audit line is padding, and does not tell anyone else how to vote. It records a checkable path from an unresolved evidence gap to a position with an exit.

Counterexample: the thorough-looking rationale

A representative publishes two thousand words on the same action. It opens with four paragraphs of constitutional principle, summarises the proposal accurately at length, quotes three community members, and closes with a yes. It reads as diligent, and a reader could reasonably describe it as thorough.

It is nonetheless unauditable: no factual claim is tied to a document the reader could open, the summary is the proposers' framing rather than the author's restatement, nothing is given up under the conclusion, and no condition is named that would have produced a different vote. Volume created an appearance of rigour without any of its substance - which is why the trait audit counts labelled sentences rather than words.

Common mistakes

  • Pasting the proposal summary instead of restating the action in your own words.
  • Mixing evidence and inference in a single sentence so neither can be checked.
  • Omitting tradeoffs, which makes the position read as advertising.
  • Stating a decision with no change conditions, or conditions only you can observe.
  • Treating length as diligence and padding to reach it.
  • Writing an abstention without naming the missing information.
  • Adding exhortation - telling other representatives what to do.
  • Leading with principles that are never applied to the specific facts.
  • Naming a source without a section, date or anything a reader could locate.
  • Rewriting the rationale after the fact so it matches the outcome.

What this establishes

You can name the four traits and what each does for a reader; audit a rationale sentence by sentence and identify absent traits and padding; distinguish evidence from inference in your own writing; state a tradeoff your own conclusion imposes; and write change conditions a third party could observe. You can apply all of this equally to a yes, a no or an abstention.

Questions to sit with

  • Which sentence in a rationale you have written or read carries the least evidential weight, and could it be cut without losing anything?
  • What claim in a rationale you have seen would need a specific document reference to be checkable, and is that reference present?
  • If a rationale you wrote has no stated tradeoff, what would the honest cost of your own conclusion actually be?
  • What would you look for to tell whether a long rationale is thorough or merely padded?
  • Is there a decision in a rationale you have read with no observable change condition attached to it?

What remains unknown

The traits say nothing about whether a conclusion is correct, and a document meeting all four can be wrong on the merits. This lesson makes no claim about how common these traits are in published rationales - no survey or coded sample underlies it. It does not tell you how much evidence is enough, which is a judgement that varies by action, and it does not address the metadata mechanics of anchoring a document to a vote, which the next lessons and CIP-100 cover. All examples are a fictional composite for training.

Takeaways

Context, evidence, tradeoffs, decision - a reader needs all four to reconstruct your reasoning.

Auditable means checkable, not agreeable.

Length is not a trait; label sentences, not word counts.

Change conditions must be observable by someone who is not you.

Applied activity

Trait audit on an existing rationale

Take a rationale - one of your own, or the fictional composite in this lesson - and mark it up sentence by sentence. Label every sentence C for context, E for evidence, T for tradeoff, D for decision, or X for none of these. Then count. First, is any trait entirely absent? Second, what fraction of sentences are X? Third, for each X sentence, decide whether it can be rewritten to carry a trait or should simply be cut. Finally, write one sentence describing what a reader could not check about your reasoning even after reading the whole document. Do not change the conclusion at any point in this exercise - the audit is about the document, not the vote.

Deliverable: A marked-up rationale with per-sentence labels, a count of X sentences, a note on any absent trait, and one sentence naming what a reader still cannot check. · about 30 minutes

Teach it back

Explain the four traits of an auditable vote rationale in your own words to a delegator who has never heard of one.

Write it for a delegator who has never heard of it.

  • Names all four traits, context, evidence, tradeoffs, decision, and says plainly what each one lets a reader check.
  • Explains that auditable means checkable, not persuasive or agreeable, using a concrete contrast.
  • Makes clear that neither length nor a particular vote counts as one of the four traits.
  • Uses a short, invented example rather than abstract description alone.

Sign in to write your explanation and see the model answer afterwards.

Key takeaways

The short version of this lesson. Read these first when you come back to revise.

  1. Context, evidence, tradeoffs, decision - four traits, all four required.
  2. Auditability is about whether a stranger can check your reasoning, not about whether they agree.
  3. Length is not a trait. Any sentence carrying none of the four is padding.
  4. No trait is a vote: yes, no and abstain can each be written well or badly.

Sources

  • DRep Standards Institute vote rationale template

    DRep Standards Institute

    The Institute's rationale template, published in the resource library.

  • CIP-100 - Governance metadata(opens in a new tab)

    Cardano Improvement Proposals

    Structure of off-chain governance metadata documents, anchors, authors and witnesses.

  • DRep Standards Institute Standards of Practice

    DRep Standards Institute

    The Institute process standards referenced by the classification lab.