Notes on Legible Code, for both humans and AI

Short set of notes about how code should be written so it is habitable by humans and legible to AI. It is drawn from practitioners, but based on what I've come to want in my projects. It is written as a guide for humans to read, and as a skill for AI coding agents to use.