Skip to main content

Applications for the autumn mentorship cohort are open until 30 September. Apply now

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.

FoundationWorkshop136 minv1.0.0 · effective Aug 9, 2026
Course catalogue

Learning outcomes

  • Write a rationale carrying the four traits — context, evidence, tradeoffs and decision — without padding or unsupported claims
  • Attribute evidence to primary material and separate what a source says from what you infer from it
  • State unverified facts, confidence limits and expert reliance honestly while still resolving to a decision
  • Steelman the strongest counterargument and name concrete conditions that would change your mind
  • Draft, self-review against a process rubric, revise and export a rationale that can be corrected in public
136 minutes · 5 lessonsVersion 1.0.0 · effective 8/9/2026
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

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.

Definitions

Rationale
The published explanation of how a representative reached their position on a specific governance action. Under CIP-136 it is an off-chain document anchored to the vote.
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

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 - the most common single failure in published rationales, and the easiest 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.

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-136 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.

Takeaways

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

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

Sources

  • DRep Institute vote rationale template

    Cardano DRep Institute

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

  • DRep Institute Standards of Practice

    Cardano DRep Institute

    The Institute process standards referenced by the classification lab.

Practical exercise

Rationale draft, rubric review and export

Produce one complete rationale for a single governance action - the fictional composite used in the workshop, or a real action you have already voted on. Work in three passes and keep all three. Pass one, draft: write the document with the six sections - context, what I verified, what I could not verify, tradeoffs, the strongest counterargument, and the decision with its change conditions. Do not edit while drafting. Pass two, self-review: score your draft against the process rubric line by line, marking each item met, partly met or unmet, and write one sentence for every item that is not fully met explaining what is missing. Pass three, revise and export: fix the weakest section, add the date and version line, and export the result as Markdown. Two rules apply throughout. Length is not a virtue - cut any sentence that carries no context, evidence, tradeoff or decision. And the rubric measures process only: a rationale can score full marks and reach a conclusion many readers disagree with, which is not a defect in the rationale.

Deliverable: Three artefacts: the unedited first draft, the completed rubric with a note against every item not fully met, and the revised Markdown export carrying a date and version line.

  1. 1.What exactly is being asked for, in your own words, without the proposer's framing?
  2. 2.Which claims did you verify against a primary source, and which source was it?
  3. 3.Which claims could you not verify, and what would it take to verify them?
  4. 4.What is the strongest argument against your current reading of the evidence?
  5. 5.What would you publish so someone who disagrees with you can audit your reasoning?
Autosaves on this device0 / 20,000

Signed out: this draft stays on this device. Sign in to save it to your account and have it count towards completion.

Final assessment

Final assessment

Answer every question to complete this course. Your attempts are private to you.

8 questions · pass mark 70%Private result · unlimited attempts · never published

Sign in to submit an attempt. Assessments are graded on the server, so they cannot be taken anonymously.

  1. 1. Beyond naming the document and the location within it, what does a followable attribution require?

    One correct answer.

  2. 2. A rationale is found to contain a misread figure after the vote. What does the course require?

    One correct answer.

  3. 3. Which set names the four traits of an auditable rationale?

    One correct answer.

  4. 4. What does a high score on the eleven-point process rubric establish?

    One correct answer.

  5. 5. Which statement about confidence and expert reliance matches the course?

    One correct answer.

  6. 6. Which change condition meets the observable, specific and realistic tests?

    One correct answer.

  7. 7. You could not confirm a custody agreement the proposal references. What does this course say to do?

    One correct answer.

  8. 8. A rationale says: “The suspiciously vague audit line of 140,000 ADA is clearly padding.” What is the drafting fault?

    One correct answer.

Reference sheet

Rationale template and process rubric

The Markdown skeleton to draft into, plus the rubric to self-review against before publishing.

Definitions

Rationale
The published explanation of how a representative reached their position on a specific governance action. Under CIP-136 it is an off-chain document anchored to the vote.
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.
Primary material
The thing itself: the on-chain action, its metadata anchor under CIP-100, the budget annex, the repository, the parameter values at a stated epoch.
Secondary material
Someone else''s description of primary material: a summary thread, a community explainer, a journalist''s account, another representative''s rationale.
Anchor
The link and hash binding an off-chain governance document to an on-chain action, so a reader can confirm the document you read is the document referenced.
Inference
A conclusion you draw from material. Always yours, never the source''s, however obvious it seems.
Attribution
Document, location within it, and the date or epoch you read it - the minimum for a claim to be followable.
Living source
Material that changes without notice: documentation sites, dashboards, current parameter values, proposal pages that can be edited.
Unverified fact
A claim material to your decision that you attempted to confirm from primary material and could not.
Unknown
A question you did not investigate. Distinct from an unverified fact, and worth saying so.
Confidence limit
A statement of how strongly a specific claim is supported and what would strengthen it.
Reliance
Depending on another party''s judgement for a claim you cannot evaluate yourself.
Decision-blocking uncertainty
A gap large enough that no position is defensible until it is resolved.
Hedging
Uniform qualification applied to everything, which conveys no information about which claims are weak.
Steelman
The strongest honest version of the case against your position, stated as its proponents would state it.
Strawman
A weakened version of the opposing case, easy to defeat and misleading to the reader.
Acceptance test
Would a thoughtful holder of the opposing view read your steelman and agree it is their argument?
Change condition
An externally observable event or document that would move you to a different position.
Correction
An appended, dated note recording that something in the published rationale was wrong and what the correct position is.
Version history
The ordered record of the original document and every subsequent amendment, all still readable.

Checklist / method

  • Trait 1 - Context: what the action asks for, in your own words, before any judgement.
  • Trait 2 - Evidence: what you checked, where it came from, and what it actually said.
  • Trait 3 - Tradeoffs: what is given up under your conclusion, stated as a cost you accept.
  • Trait 4 - Decision: the position, and the conditions under which you would revise it.
  • Length is not a trait. Cut any sentence carrying no context, evidence, tradeoff or decision.
  • No trait is a vote. Yes, no and abstain can each be written well or badly.
  • Markdown skeleton: ## Context / ## What I verified / ## What I could not verify / ## Tradeoffs / ## Strongest counterargument / ## Decision and change conditions / ## Disclosures / _Version and date_.
  • Cite primary material - the action, its metadata anchor, the budget annex - not a summary of it.
  • Separate the quote from the inference: 'the annex lists X' then 'I read that as Y'.
  • Attribution must be followable: name the document, the section, and the date you read it.
  • Say what you could not verify, and leave the question open rather than closing it with a guess.
  • Confidence is about the evidence, not about your feelings. Say what would raise it.
  • Disclose expert reliance: who, on what question, and what you did with the answer.
  • Steelman the counterargument in its strongest form, as its holder would state it.
  • Change conditions must be observable by someone else, not 'if I became convinced'.
  • Corrections are appended and dated. Never silently edit a published rationale.
  • Carry a version and date line so a reader can tell which text they are reading.
  • Rubric - Context: could a stranger say what the action does after reading this section alone?
  • Rubric - Evidence: is every factual claim traceable to a named source a reader could open?
  • Rubric - Inference: is each inference visibly separated from the material it rests on?
  • Rubric - Unverified: does the document name at least one thing you could not confirm?
  • Rubric - Tradeoffs: is at least one real cost of your own conclusion stated plainly?
  • Rubric - Counterargument: would someone who disagrees recognise their case in your wording?
  • Rubric - Change conditions: are they concrete, observable and checkable by a third party?
  • Rubric - Disclosure: are relevant interests present, or an explicit nil return?
  • Rubric - Correction: is there a version and date, and a stated route for corrections?
  • Rubric - Restraint: is there any sentence that persuades without adding evidence? Cut it.
  • The rubric scores process, never the conclusion. A well-scored rationale can still be wrong.
  • This is drafting guidance, not legal advice, and never a recommendation on how to vote.

Final template

  1. 1.What was asked - a plain restatement of the request.
  2. 2.What I verified - claim, source, and what the source actually says.
  3. 3.What I could not verify - the open list, with the question still outstanding.
  4. 4.Strongest counter-argument - stated in its best form.
  5. 5.Disclosures - relationships, holdings or history relevant to this action.
  6. 6.How I would publish this - the rationale a reader could audit.