{
  "schema": "org-topic@v1",
  "contract": "https://mnstry.org/contracts/org/org-topic.v1.schema.json",
  "id": "org:courses:honest-claims",
  "topic": "Honest claims",
  "framing": "An honest claim is a harder document to write than either an evasion or a data dump, and it is the only one of the three that survives a second year. These articles walk what it contains, from the difference between a promise and a passing arrangement to the direction a system's failures fall. The order runs outward: what you say, whether anything backs it, where it stops, how it is presented, and what happens on the worst day.",
  "readingOrder": [
    {
      "id": "org:writing:guarantees-not-shapes",
      "title": "Guarantees, not shapes",
      "transition": "Start with the sentence you are about to publish, and the question that decides whether it is a promise or a piece of machinery you will regret describing.",
      "url": "https://mnstry.org/writing/guarantees-not-shapes/",
      "json": "https://mnstry.org/writing/guarantees-not-shapes.json"
    },
    {
      "id": "org:writing:candor-about-enforcement",
      "title": "Candor about enforcement",
      "transition": "Publishing the right sentence is only half of it, because a rule nothing enforces can be written in exactly the same confident voice as a rule that is.",
      "junction": {
        "brick": "org:writing:consent-that-fails-ci",
        "transition": "Or cross to the safety wall, where a promise stops being checked by people at all and moves into the one gate that never has a bad day.",
        "targetCourse": "org:courses:safety"
      },
      "url": "https://mnstry.org/writing/candor-about-enforcement/",
      "json": "https://mnstry.org/writing/candor-about-enforcement.json"
    },
    {
      "id": "org:writing:what-your-claim-excludes",
      "title": "What your claim excludes",
      "transition": "Once you are honest about what holds, the next question is where it stops, and whether that boundary gets drawn by you or found by somebody else.",
      "url": "https://mnstry.org/writing/what-your-claim-excludes/",
      "json": "https://mnstry.org/writing/what-your-claim-excludes.json"
    },
    {
      "id": "org:writing:the-exclusions-are-the-taste",
      "title": "The exclusions are the taste",
      "transition": "Exclusions turn out to do more than keep a claim honest: what a maker refuses is the only legible statement of what it believes.",
      "url": "https://mnstry.org/writing/the-exclusions-are-the-taste/",
      "json": "https://mnstry.org/writing/the-exclusions-are-the-taste.json"
    },
    {
      "id": "org:writing:limits-are-content",
      "title": "Limits are content",
      "transition": "A boundary you have written down and set in six-point grey has been disclosed and not communicated, which turns the whole problem into a design problem.",
      "url": "https://mnstry.org/writing/limits-are-content/",
      "json": "https://mnstry.org/writing/limits-are-content.json"
    },
    {
      "id": "org:writing:which-way-failure-falls",
      "title": "Which way failure falls",
      "transition": "End with the claim that cannot be softened later or added afterward, because it was decided the day the system was built.",
      "url": "https://mnstry.org/writing/which-way-failure-falls/",
      "json": "https://mnstry.org/writing/which-way-failure-falls.json"
    }
  ],
  "completion": "You have walked Honest claims end to end: the promise against the shape, the check against the request, the boundary you draw before someone else does, the limit given a place to live, and the direction your failures fall. None of it required publishing the machinery, which is the discovery that makes it affordable. Candor and confidentiality were never opposed.",
  "practice": "Take one promise your product, your resume, or your profile currently makes, and write four lines about it. Whether it is a guarantee or just how things happen to be arranged right now. Whether anything actually checks it, or whether it is only requested. What it excludes, in the same plain words as the promise itself. And which way it fails when it fails. Then fix the wording rather than the reader, because every one of those four lines was already true before you wrote it down.",
  "graph": "https://mnstry.org/kg.json"
}