Reading up on Joel Spolsky

The article lists common software‑blogging anti‑patterns—meandering intros, assumed knowledge, overlinking, sequel bait, excessive formality, and poor mobile/readability—and offers fixes for developers.

Joel Spolsky's original twelve‑question Joel Test remains valid, but nine additional agent‑focused questions form the Shelley Test for modern software teams.

Coding agents lower the cost of rewriting codebases, but codebases encode tacit knowledge and coevolve with people, preserving value that specs alone cannot capture.