All posts

A manifesto, not a Talmud

August 24, 2026

I have written before about the tech debt LLMs pile up in code, but the nastiest tech debt accumulates in "memory files", and we are the ones piling it on.

When the LLM screws something up, the first reflex is to add another "STOP FUCKING SWALLOWING ERRORS" to CLAUDE.md.

Over time it turns into an incoherent tantrum, and this is supposed to be the project's main document.

A memory file should be something like a manifesto, or a charter at worst. Do not turn it into a Talmud - LLMs were already trained on the actual Talmud.

I try to keep mine under 100 lines. Here is an example, if anyone is curious.

Read other posts