Building an AI tool to review API design taught us something fundamental about how AI approaches quality: it confidently optimizes for the least important parts. Instead of flagging the quality issues that actually hurt developers, like confusing workflows, hidden rules, or inconsistent mental models, it focused on the safe, measurable stuff: naming patterns, formatting mistakes, even typos. Developer experience issues just didn’t get caught, even though in our case, we speci
