Company Brain / Librarian / Skills
Log The Gap
- name
- log-the-gap
- description
- Use after answering any question — especially when the brain could not answer it, answered only from a stale or contradictory source, or has now been asked the same thing more than once.
Why
This log is the brain's backlog. Every question that could not be answered is a page someone owes, and the count of repeat asks is what decides which page gets written first.
Steps
- Search Questions with search_rows for the same question asked differently. People do not phrase things the same way twice.
- If it exists: increment ask_count, set last_asked_at, and update outcome if this time was different — a question that used to be a gap and is now answered should say so.
- If it does not: insert a row with the question, area, outcome, citations if any, ask_count of 1, and status open.
Outcomes
- answered — cited a current page.
- answered_stale — the only source was past review_due.
- gap — nothing in the brain covered it.
- contradiction — sources disagreed.
Record what actually happened. An answered_stale logged as answered hides exactly the signal this table exists to surface.
Do not
- Do not create a second row for a question already logged. A duplicate splits the count and buries the signal.
- Do not log an unrelated follow-up as a new question when it is the same one rephrased.
- Do not write pages. You cannot, and Archivist is who does.
- Do not log trivial lookups. This is a record of what the brain was asked to know, not a chat transcript.