$ cat project.md
runbook-assistant
A retrieval-first LLM helper that answers from your runbooks only — with citations and a kill switch.
# postmortem — what broke, what we changed
Retrieval returned stale runbooks after a rename. Fix: index on commit hook, not on a timer, and surface the source commit in every answer.
Point it at your runbook repo. It answers on-call questions with citations, refuses when it doesn’t know, and can be disabled in one env var.
The problem
A small, annoying task that was eating time and attention every week. We measured it before touching anything.
The approach
One focused change, reproducible, with a guardrail and an obvious way to turn it off. No magic, no vibes.
$ ./run --dry-run
[ ok ] plan looks sane
$ ./run --applyThe receipts
Before/after benchmarks, the failure modes we hit, and the tradeoffs we accepted. The repo has the full runbook.
Convinced? The repo is one command away.
git clone$ related lab notes