Grounding incident note¶
Template for PB-RAG-06-04. Copy it into the incident ticket. No user data, keys or client names: use trace ids and ${PLACEHOLDERS}.
Summary¶
| Field | Value |
|---|---|
| Incident id | ${INCIDENT_ID} |
| Reported by | User / reviewer / monitor |
| Reported at (UTC) | ${REPORTED_AT} |
| Trace ids | ${TRACE_IDS} |
| Severity | ${SEVERITY} |
| Status | Open / Contained / Fixed / Closed |
What the user saw¶
One or two sentences. Quote the claim and the citation shown. Do not paste personal data.
Containment¶
- Action taken (step 1): safe mode on / topic disabled / none needed.
- Time contained (UTC): ${CONTAINED_AT}
- Users affected (estimate and how it was measured): ${AFFECTED}
Diagnosis¶
| Check | Result |
|---|---|
| Verifier output (step 5) | Paste the [fault] detail lines |
| Fault class | generation / renderer / stale_index / none found |
| Cited chunk in retrieved context? | Yes / No |
| Quote found in cited chunk? | Yes / No |
| Rendered link and page match the chunk? | Yes / No |
| Chunk unchanged in the index? | Yes / Changed / Deleted |
| Replay with previous prompt or model (step 8) | Fault gone / Fault remains / Not run |
| Changes in the 7 days before (step 4) | Prompt / model / index / renderer / none |
Root cause¶
One paragraph: what failed, and why the existing checks did not catch it.
Fix¶
- Fix applied, with the PR or release id: ${FIX_REF}
- Rollback used (section 8 of the runbook): Yes / No
- Golden set case added (step 11): ${GOLDEN_CASE_ID}
- Groundedness gate re-run (PB-RAG-06-03): Pass / Fail
Communication¶
- Client informed: Yes / No / Not required by contract
- Date and channel: ${COMMS_DATE}
Follow-up actions¶
| Action | Owner role | Due |
|---|---|---|
| ... | ... | ... |