{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20261011-9e4b62c5",
  "url": "/knowledge/write-a-bug-report-someone-can-use",
  "id": "MHC-D-BRALI-0015",
  "version": "0.1.0",
  "kind": "template",
  "title": "Write a bug report someone can use",
  "summary": "A symptom is an observation. Its cause is still a hypothesis.",
  "body": "Give the investigator a path from the conditions to what you actually saw. Separate expected behaviour, observed behaviour and your suspected explanation. If the failure happened once, say so; do not invent reliable reproduction. The acceptance check describes the behaviour a fix must restore.",
  "use_when": [
    "You need another person to investigate a reproducible work-system problem."
  ],
  "limits": [
    "Remove credentials and unnecessary personal or customer data from screenshots, logs and examples."
  ],
  "example": "A browser shows an old address after saving. You record the version and one failed attempt; caching remains a suspicion.",
  "check": "Can another person distinguish what happened, what should happen and what still needs testing?",
  "template": "Context and version: ___.\nSmallest reproduction steps: ___.\nExpected result: ___.\nObserved result and evidence: ___.\nSuspected cause, if any: ___.\nAcceptance check for the fix: ___.",
  "topics": [],
  "intents": [],
  "published_at": "2026-10-11T19:10:00Z",
  "review": {
    "kind": "agent",
    "label": "Agent editorial and scoped evidence review",
    "reviewed_at": "2026-10-11T19:01:14Z"
  },
  "source_ids": [
    "FP-BRALI-0015"
  ],
  "evidence": [
    {
      "claim": "This report template keeps expected behaviour, observed behaviour and suspected cause in separate fields.",
      "source_id": "FP-BRALI-0015",
      "role": "contextualizes",
      "locator": "Selected template fields",
      "note": "Editorial design and source provenance only. No causal benefit, percentage improvement or validated intervention is claimed. Access: full_structured_record; 2026-10-11. Registered first-party project text; template provenance, not an efficacy study."
    }
  ],
  "editorial_overlay": null,
  "editorial": null,
  "notices": [],
  "sources": [
    {
      "id": "FP-BRALI-0015",
      "title": "Write a bug report someone can use — Brali source record",
      "url": "https://github.com/Brali-LifeOS/brali-lifeos.github.io/blob/63acf81e48f428c0e769ffa9d26d9421fd575e6a/data/life-os-content/qa-clear-feedback-templates.json"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-BRALI-0015",
      "to": "MHC-D-BRALI-0182",
      "type": "use_before",
      "url": "/knowledge/separate-severity-from-priority"
    }
  ],
  "collections": [
    {
      "id": "RC-FIRST-PARTY-WORK-RECORDS",
      "title": "Write work records another person can use",
      "url": "/collections/write-work-records-another-person-can-use"
    }
  ],
  "topic_hubs": [],
  "solution_packs": []
}