Back to Projects
ai
2026

Fathohm — Comprehension-Debt System of Record

Fathohm makes an invisible problem visible: the gap between what a codebase does and what any human on the team actually understands. As AI agents write a growing share of production code, teams accumulate comprehension debt — modules nobody reviewed deeply and nobody can explain. Fathohm analyzes code authorship and human review depth via a read-only GitHub App, classifies agent-authored vs human-authored commits (heuristics first — co-author trailers, committer signatures — with batched LLM classification only for the ambiguous residue), and computes a deterministic, fully explainable comprehension score per module. The hero view is the Map: a treemap of the repository colored by score, built to stay fast on 10k+ file repos. Everything derives from an append-only event spine, so improving the scorer retroactively re-values all history. Source code is read transiently and never persisted — stored data is metadata, events, scores, and summaries only.

fathohm

Fathohm — Comprehension-Debt System of Record

Technologies

Frontend

Next.js 15
TypeScript
Tailwind CSS
Treemap visualization

Backend

Node.js workers
GitHub GraphQL API
Webhook ingestion

Database

Supabase (Postgres + RLS)

Tools

Zod
Docker
Vercel
Hetzner
Challenges
  • Quantifying 'human understanding' of code — a fuzzy concept — as a deterministic, defensible metric teams will trust
  • Classifying agent-authored vs human-authored commits reliably without an LLM in the hot path of every score
  • Rendering a comprehension treemap that stays fast on repos with 10k+ files
  • Backfilling 50k-commit histories from the GitHub GraphQL API without losing progress on restarts
Solutions
  • Scoring is pure TypeScript, table-driven tested, and every score row carries its factor breakdown — the UI can always decompose a number into visible causes
  • Heuristics first (co-author trailers, committer signatures like claude_code/copilot/cursor); batched LLM classification only for the ambiguous residue, behind a swappable Classifier interface
  • Directory-level aggregation beyond 2k nodes plus virtualization keeps the Map responsive at scale
  • Resumable backfill with cursor checkpoints in Postgres — a long ingest survives worker restarts
  • Append-only code_events spine: scores are derived and re-computable, so scorer improvements re-value all history
Key Outcomes & Impact

Read-only by design: the GitHub App requests read scopes only and never persists raw source

Deterministic, explainable scores — no black boxes; detection methodology is public

User corrections to authorship labels are stored as first-class events, becoming a proprietary training dataset

Other Projects

JobJam.io — AI Job Search & Application Platform
JobJam.io — AI Job Search & Application Platform

AI-powered job search platform: discover roles, evaluate fit, tailor applications, and close skill gaps. One-time pricing, no subscriptions.

View Project
Caveat — Agent-Aware Access Control
Caveat — Agent-Aware Access Control

Stop giving your AI agents your full GitHub token. Scoped, revocable, observable permissions for AI agents — the missing IAM layer for the agent era.

View Project