{
  "schema": "vedokrok.public-item.v1",
  "release_id": "VEDOKROK-SEL-5d86e1b23401e578",
  "url": "/knowledge/edit-for-attention-and-action",
  "id": "MHC-D-BRALI-0086",
  "version": "0.1.0",
  "title": "Edit for attention and action",
  "summary": "A message can be polite, accurate and still make the reader hunt for the point. Use attention as a relevance check, not a trick: show why this matters, explain the consequence honestly, and make the next action obvious.",
  "kind": "checklist",
  "body": "A message can be polite, accurate and still make the reader hunt for the point. Use attention as a relevance check, not a trick: show why this matters, explain the consequence honestly, and make the next action obvious.",
  "limits": [
    "This is an editing checklist, not a guarantee of persuasion or response rate. Do not manufacture urgency or hide material information."
  ],
  "topics": [
    "communication"
  ],
  "intents": [],
  "source_ids": [
    "FP-BRALI-SRC-a45f9634a4c439bf698a",
    "FP-BRALI-SRC-10e35a95435c7e228fa7"
  ],
  "evidence": [
    {
      "claim": "First-party source of this practical exercise.",
      "source_id": "FP-BRALI-SRC-a45f9634a4c439bf698a",
      "role": "contextualizes",
      "note": "Provenance for selected structured fields. The exercise is editorial practice; this link supplies no efficacy finding.",
      "locator": "data/life-os-content/aida-message-optimizer.json"
    },
    {
      "claim": "First-party source of this practical exercise.",
      "source_id": "FP-BRALI-SRC-10e35a95435c7e228fa7",
      "role": "contextualizes",
      "note": "Provenance for selected structured fields. The exercise is editorial practice; this link supplies no efficacy finding.",
      "locator": "data/life-os-content/presentation-polish-score.json"
    }
  ],
  "use_when": [
    "A message asks someone to notice, understand or do something."
  ],
  "avoid_when": [
    "This is an editing checklist, not a guarantee of persuasion or response rate. Do not manufacture urgency or hide material information."
  ],
  "checklist": [
    "Name the audience and the one next action you want to make easy.",
    "Make the opening relevant to that reader instead of merely dramatic.",
    "Remove details that do not help understanding or the decision.",
    "State the concrete value, consequence or reason without exaggeration.",
    "End with one clear action the reader can accept, decline or ignore."
  ],
  "check": "The reader can tell why the message matters and what, if anything, they are being asked to do.",
  "question": "Would this still be a good message if the reader says no?",
  "published_at": "2026-11-12T18:37:40Z",
  "review": {
    "kind": "agent",
    "label": "Agent editorial and scoped source review",
    "reviewed_at": "2026-11-12T18:37:40Z"
  },
  "knowledge_origin": {
    "release_id": "MHC-RPUB-20261112-20287590",
    "corpus_commit": "20287590ddd3999b7492df232822b6a0f7d114b1",
    "manifest_sha256": "2a987660d12de0ce2bde77a421424f7762af1ff77872ef41093fecc33db74a95",
    "projection_sha256": "2807da39bbe6a3dee2db32a76675ac5185f5a33e8b0a5cdd0c22a4731f3378a0",
    "published_at": "2026-11-12T18:37:40Z"
  },
  "editorial_overlay": null,
  "editorial": null,
  "notices": [],
  "sources": [
    {
      "id": "FP-BRALI-SRC-a45f9634a4c439bf698a",
      "title": "Use AIDA as a Message Clarity Checklist",
      "url": "https://github.com/Brali-LifeOS/brali-lifeos.github.io/blob/63acf81e48f428c0e769ffa9d26d9421fd575e6a/data/life-os-content/aida-message-optimizer.json"
    },
    {
      "id": "FP-BRALI-SRC-10e35a95435c7e228fa7",
      "title": "Chefs Know That Presentation Is Key",
      "url": "https://github.com/Brali-LifeOS/brali-lifeos.github.io/blob/63acf81e48f428c0e769ffa9d26d9421fd575e6a/data/life-os-content/presentation-polish-score.json"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0092",
      "type": "useful_with",
      "url": "/knowledge/lead-with-the-point-then-support-it"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0093",
      "type": "useful_with",
      "url": "/knowledge/translate-a-feature-into-user-impact"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0094",
      "type": "useful_with",
      "url": "/knowledge/structure-a-proposal-from-problem-to-next-step"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0096",
      "type": "useful_with",
      "url": "/knowledge/follow-up-with-context-and-a-next-step"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0101",
      "type": "useful_with",
      "url": "/knowledge/make-each-visual-do-one-job"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0135",
      "type": "useful_with",
      "url": "/knowledge/write-an-update-with-a-clear-request"
    },
    {
      "from": "MHC-D-BRALI-0086",
      "to": "MHC-D-BRALI-0187",
      "type": "useful_with",
      "url": "/knowledge/name-the-idea-after-you-can-explain-it"
    }
  ],
  "collections": [
    {
      "id": "RC-MHC-COMMUNICATE-FOR-ACTION",
      "title": "Turn a message into something people can act on",
      "url": "/collections/turn-a-message-into-something-people-can-act-on"
    }
  ],
  "topic_hubs": [
    {
      "id": "communication",
      "title": "Communication and feedback",
      "url": "/topics/communication-and-feedback"
    }
  ],
  "solution_packs": []
}
