Skip to main content
Audit knowledge docs for staleness, detect drift from journal evidence, and generate proposed updates for human review.

Usage

How It Works

  1. Scans knowledge/*.md for all active docs
  2. Reads last N days of journal entries
  3. Extracts topics from both docs and journals
  4. Computes drift score per doc:
    • Age penalty (>7 days starts drifting)
    • Journal activity penalty (lots of activity + stale doc = drift)
    • Stale topic penalty (topics in doc not mentioned in journals)
  5. Generates knowledge/PENDING.md with:
    • TLDR of what needs attention
    • Uncovered topics (journals mention, no doc covers)
    • Per-doc proposed updates with evidence
    • Open questions for human review

Output

The PENDING.md Workflow

PENDING.md acts as a PR for your knowledge base:

Example PENDING.md

Options