This is a set of notes on what makes a codebase legible and habitable to me. It is written for both humans and AI.
This began as a collection of prompts I'd pass most frequently to coding agents for improving code quality. Undirected, agents tend toward code that looks great on the surface, but is structurally weak. These prompts help steer them closer to a shape I like.
What is Legible Code? Read the introduction
You can install this as a coding agent skill and use it to review code and to generate ideas to improve your architecture.
Please see Install Legible Code Skill
You should also read through the sources to get to the original authors of many of the ideas presented here.
MIT. See LICENSE.txt.