I can't ask my old team lead why anymore, so I built a séance

Описание и применение

Когда ключевой член команды уходит, его знания о том, почему определённые строки кода существуют, теряются. Открытый инструмент Ouija Blame возвращает оригинальные слова автора, используя git log -L, Gemma 3‑4B и данные из PR‑ов, ревью и агентских сессий, чтобы объяснить, зачем нужна строка.

Задача

When a key team member leaves, their knowledge about why certain code exists is lost, and tools like git blame only show the last change, not the original rationale.

Результат

In a test set of 45 lines from various projects, Ouija Blame surfaced a written reason for 28/45 lines, outperforming git blame (19/45) and requiring less reading effort (67 words per line vs 268).

Рабочий процесс

• Paste a GitHub link to a line or open a haunted line from the gallery
• Ouija Blame uses git log -L to trace the line back to its first commit
• Collects commit messages, PR descriptions, review comments, linked issues, and Entire prompts
• Gemma 3‑4B identifies passages that explain why the line exists
• Code verifies each quoted word against the source
• Outputs a card with what the line does, why it exists, and what to check before changing it, with numbered citations
• Ghost speaks only in quoted words; if no reason is found, it says "I never wrote down why."

Доказательства

git blame did not help. It showed me the last person who touched the file, not the person who decided why it exists.

Источник

Ouija Blame walks the line back to the commit that first wrote it, gathers what its author and reviewers wrote (commits, the pull request, review comments, linked issues, and the prompts behind agent-written code), and the ghost answers only in their own words, each one linked.

Источник

The test: 45 real lines from Rails, Kubernetes, Home Assistant, Ansible and Istio that someone deleted as pointless, which broke something and were put back. Every method saw only history from before the deletion. The séance surfaced a written reason for 28/45 lines; the git blame message, 19/45 (+20 points, 95% CI +9 to +33).

Источник