DX audit

A protocol for auditing and improving developer experience in a codebase. Developer experience is everything a contributor touches before their first useful line of code. High onboarding friction is silent: no one files a bug for it, every new contributor just pays the cost.

Usage

/dx-audit                 # full audit of the current project (report-only)
/dx-audit [path]          # audit a specific directory
/dx-audit --report-only   # inspect and report, change nothing (default)
/dx-audit --implement     # apply fixes with approval, verify each

What to inspect

Walk the codebase as a new contributor would. For each dimension, record what exists, what is missing, and whether what exists is accurate.