{
 "schema": "diditwork.chain-card/v1",
 "url": "https://diditwork.org/chain-card",
 "title": "The chain card",
 "reviewed": "2026-10-29",
 "note": "The eight links of the verdict chain as a one-page donor card. Every id, name, question, rule and ask_the_charity question is copied verbatim from https://diditwork.org/agents/verdict-procedure.json (links[]). No figures, scores, ratings or charity names.",
 "use_for_agents": [
  "Walk a giving claim down the links in order and say, for each, what the source shows and how firmly; name the weakest link.",
  "Never turn the card into a score, a count of links passed, or a ranking. For per-link rungs and the output record, use https://diditwork.org/agents/verdict-procedure.json.",
  "Quote link questions verbatim and cite https://diditwork.org/chain-card or the link url."
 ],
 "links": [
  {
   "id": "L0",
   "name": "Defined",
   "question": "Worked at what, compared with what, for whom, by when?",
   "ask_the_charity": [
    "Compared with what?"
   ],
   "rules": [
    "No counterfactual, no claim."
   ],
   "url": "https://diditwork.org/how-we-know#chain-l0"
  },
  {
   "id": "L1",
   "name": "Happened",
   "question": "Was it delivered, and did the measured outcome move, counting the missing and checking the measure was not gamed?",
   "ask_the_charity": [
    "Who and what is missing?"
   ],
   "rules": [
    "Count the missing."
   ],
   "if_unknown": "Reported by the organisation; not independently checked.",
   "url": "https://diditwork.org/how-we-know#chain-l1"
  },
  {
   "id": "L2",
   "name": "Caused",
   "question": "Would it have happened anyway?",
   "ask_the_charity": [
    "How was it tested?",
    "Who was chosen, and when?"
   ],
   "rules": [
    "Design beats adjectives.",
    "Ask who was chosen, and when."
   ],
   "url": "https://diditwork.org/how-we-know#chain-l2"
  },
  {
   "id": "L3",
   "name": "Sized",
   "question": "How big is the effect, honestly?",
   "ask_the_charity": [
    "What is the range, not just the headline?",
    "Is it too good to be true?",
    "How many studies were run, not just published?",
    "Did the studies agree?",
    "Was the group it “works best for” chosen in advance?"
   ],
   "rules": [
    "Read the interval, not the point.",
    "Small, noisy and surprising means shrink it.",
    "Ask how many studies were run.",
    "Ask for the range, not just the average.",
    "Decide the slices before you look."
   ],
   "url": "https://diditwork.org/how-we-know#chain-l3"
  },
  {
   "id": "L4",
   "name": "Travels",
   "question": "Will it work here, run by this organisation, at this scale, now?",
   "ask_the_charity": [
    "Will it travel to where my money goes?"
   ],
   "rules": [
    "Ask whether it travels."
   ],
   "if_unknown": "A strong hint, not a promise: tested in [place] by [implementer]; no evidence yet for this setting or scale.",
   "url": "https://diditwork.org/how-we-know#chain-l4"
  },
  {
   "id": "L5",
   "name": "Worth it",
   "question": "What good per dollar, in a unit someone values, for how long?",
   "ask_the_charity": [
    "What does one good outcome cost, and how sure is that?",
    "How long does the benefit last?"
   ],
   "rules": [
    "Count every link.",
    "Mind the clock."
   ],
   "if_unknown": "Not yet rated.",
   "url": "https://diditwork.org/how-we-know#chain-l5"
  },
  {
   "id": "L6",
   "name": "Adds",
   "question": "Will my marginal dollar change what happens?",
   "ask_the_charity": [
    "Would it have happened without my gift?"
   ],
   "rules": [
    "Credit can’t add up to more than the result."
   ],
   "if_unknown": "Whether more money adds now is unknown; an evaluator's fund can direct it to where it does.",
   "url": "https://diditwork.org/how-we-know#chain-l6"
  },
  {
   "id": "L7",
   "name": "Checked",
   "question": "Was a prediction written down, and has anyone looked again?",
   "ask_the_charity": [
    "Will we know in a year?"
   ],
   "rules": [
    "Write it down, then check."
   ],
   "url": "https://diditwork.org/how-we-know#chain-l7"
  }
 ],
 "how_to_read": [
  {
   "text": "Report every link on its own. Never add them up into a score or count how many look strong.",
   "basis": "combine.method"
  },
  {
   "text": "The weakest link sets the headline: the first one, in order, whose evidence is unknown, contested or only the organisation’s own estimate.",
   "basis": "combine.weakest_link"
  },
  {
   "text": "A strong link never lifts a weak one.",
   "basis": "combine.no_borrowing"
  },
  {
   "text": "Never fill a blank with a guess of your own. “Nobody knows yet” is an answer.",
   "basis": "never_do"
  }
 ],
 "report_walkthrough": {
  "id": "read-a-report",
  "url": "https://diditwork.org/chain-card#read-a-report",
  "title": "Read a charity report with the chain",
  "illustrative": true,
  "label": "Illustrative: made-up numbers, not any charity's results",
  "source": "Part 7.6 of the treatise (the donor’s procedure, in seven steps); https://diditwork.org/how-we-know#chain",
  "note": "Each step maps to one link of the verdict chain (L1 is asked alongside, per l1_note). The report, the charity name and every figure are invented and describe no real charity. Use the step-to-link map, not the example figures.",
  "step_to_link": [
   {
    "step": 1,
    "procedure": "Restate the claim (L0). If you cannot, stop.",
    "link": "L0",
    "link_name": "Defined",
    "ask_the_charity": "Compared with what?"
   },
   {
    "step": 2,
    "procedure": "Ask \"compared with what?\" and \"how was it tested?\" (L2). Prefer the evaluator's evidence label.",
    "link": "L2",
    "link_name": "Caused",
    "ask_the_charity": "Who was chosen, and when?"
   },
   {
    "step": 3,
    "procedure": "Ask how many independent studies and whether they agreed (L3).",
    "link": "L3",
    "link_name": "Sized",
    "ask_the_charity": "What is the range, not just the headline?"
   },
   {
    "step": 4,
    "procedure": "Ask whether it fits your setting and the charity's scale (L4).",
    "link": "L4",
    "link_name": "Travels",
    "ask_the_charity": "Will it travel to where my money goes?"
   },
   {
    "step": 5,
    "procedure": "Read the evaluator's figure in its own unit: modeled, not guaranteed (L5). Decide your own weights between kinds of good.",
    "link": "L5",
    "link_name": "Worth it",
    "ask_the_charity": "What does one good outcome cost, and how sure is that?"
   },
   {
    "step": 6,
    "procedure": "Ask what one more gift adds now (L6); consider the evaluator's fund.",
    "link": "L6",
    "link_name": "Adds",
    "ask_the_charity": "Would it have happened without my gift?"
   },
   {
    "step": 7,
    "procedure": "Write down what you expect and check in a year (L7).",
    "link": "L7",
    "link_name": "Checked",
    "ask_the_charity": "Will we know in a year?"
   }
  ],
  "example": {
   "report": {
    "org": "Brightwater Reading Circle (a made-up charity)",
    "headline": "Our tutors transformed 2,400 children's lives last year.",
    "lines": [
     "84% of the children who finished our programme were reading at grade level by June, against 62% in nearby schools without us.",
     "An independent 2019 study at three of our first schools found reading scores rose.",
     "This year we expand to 40 new towns.",
     "Just $60 helps a child learn to read.",
     "Next year we will report how many children we enrolled."
    ]
   },
   "steps": [
    {
     "step": 1,
     "link": "L0",
     "rung": null,
     "ask_the_charity": "Compared with what?",
     "report_says": "“Transformed lives” cannot be checked. The second line can: reading at grade level by June, children who finished, against nearby schools without the programme.",
     "reading": "Restate it as that second line and carry on. If the report had only the headline, you would stop here."
    },
    {
     "step": 2,
     "link": "L2",
     "rung": "own_estimate",
     "ask_the_charity": "Who was chosen, and when?",
     "report_says": "The comparison schools were picked by the charity, and the programme went to schools that asked for it. No lottery, no named design.",
     "reading": "This is the charity’s own comparison. Schools that ask for tutoring may already be the keener ones, so the gap could be partly who signed up."
    },
    {
     "step": 3,
     "link": "L3",
     "rung": "one_study",
     "ask_the_charity": "What is the range, not just the headline?",
     "report_says": "One older study at three schools, reporting that scores “rose”, with no size and no range. This year’s figure has no range either.",
     "reading": "One small study, and no size to shrink. Nobody can say how big the effect is yet."
    },
    {
     "step": 4,
     "link": "L4",
     "rung": null,
     "ask_the_charity": "Will it travel to where my money goes?",
     "report_says": "The evidence comes from the first three schools; the money goes to 40 new towns.",
     "reading": "Unknown. New towns mean new tutors, new schools and a charity running at many times its old size."
    },
    {
     "step": 5,
     "link": "L5",
     "rung": "own_estimate",
     "ask_the_charity": "What does one good outcome cost, and how sure is that?",
     "report_says": "“Just $60 helps a child learn to read.” No evaluator has published a figure.",
     "reading": "That is a fundraising price, not a cost per child who reads because of the programme. Don’t turn it into one, and don’t compare it with an evaluator’s modeled figure for another charity."
    },
    {
     "step": 6,
     "link": "L6",
     "rung": null,
     "ask_the_charity": "Would it have happened without my gift?",
     "report_says": "Nothing on how much is already raised or what a further gift would pay for.",
     "reading": "Unknown. Ask the charity what one more gift funds this year that would not happen otherwise."
    },
    {
     "step": 7,
     "link": "L7",
     "rung": null,
     "ask_the_charity": "Will we know in a year?",
     "report_says": "Next year’s report promises an enrolment count, which says how many came, not whether they read better.",
     "reading": "Write down what would convince you: next June, everyone who started (not only finishers), against schools chosen the same way. Then check."
    }
   ],
   "l1_note": {
    "link": "L1",
    "ask": "Who and what is missing?",
    "text": "The seven steps fold L1 into the others, so ask it as you go. Here the 84% counts only children who finished. How many started, and how did the ones who left do?"
   },
   "weakest_link": "L2",
   "headline": "Not established yet. The weakest link is the second step: the only comparison is the charity’s own, between schools that chose it and schools that didn’t. That is no reason to think the tutoring fails. It is a reason to put the open questions above to the charity before treating $60 as the price of a child who reads."
  }
 },
 "footer": "A method, not a score, and not a verdict on any charity. The reasoning behind each link is at diditwork.org/how-we-know#chain.",
 "source": "https://diditwork.org/agents/verdict-procedure.json",
 "see_also": [
  "https://diditwork.org/tasting-card",
  "https://diditwork.org/agents/tasting-card.json"
 ]
}
