tl;dr: Small, scattered, files instead of one large one. Usually when someone describes their new "language", or other text-based data format, they give exampl

tl;dr: Small, scattered, files instead of one large one. Usually when someone describes their new "language", or other text-based data format, they give examples of it in the announcement post. Maybe this isn't the announcement post? Regardless, it's the first one I see and my first impression is a big wall of words. (Aside: Perhaps we should reserve the term "-driven-development" for more paradigm-shifty stuff? Just a thought.) > Context is not just a technical limitation of current architectures. It is a fundamental property of how any intelligent system - biological or synthetic - reasons about complex problems. Yes! Now, please be respectful of my context window. Don't make one long document that demands I read the whole thing before I can even know if it's relevant to me. I want entry points to hook me back into the body of the text when I start skimming for the useful bits. But the Contents headings on the left are just useless AI summaries. Give me at least a hint of the bottom line up-front. Only buried deep in in the middle of the post, with no heading to call it out, I find "SpecDD is, at its core, a system for ...". Sadly I have learned too little about "SpecDD" to form an opinion about it. But as a reader, I feel actively disrespected by the author.