Intent debt is a useful framing. A few comments explaining "why" instead of "what" would have saved hours of guessing.