RE: https://cosocial.ca/@mhoye/116148772813747144
I think of this every time I see AGENTS.md or CLAUDE.md. WHAT YOU ARE WRITING IS DOCUMENTATION. Why are you suddenly interested in writing clear documentation for the robots when this information would have been helpful for every human contributor who came across your project??
I think a lot of people feel out of their depth with documentation.
With code, you have a solid minimum of enforced structure. Even if it's one 8000-lines file and your variable names are foo and bar.
Having docs that feel more like configuration files likely help with both the blank editor panic and the question how to structure this "properly".
@wakame @tragivictoria @cassidy The old 'system analysis' methodologies have no shortage of document templates to raid. Some are battle-proven in massive projects like airline booking systems. Even if the development model has been superseded, steal that paperwork.
One of the disappointments of ITIL is that it started as a useful collection of such forms, and now is a less-than-useful specification for the outcomes of management processes, none of which it details.
Cassidy James 
Victoria🏳️⚧️
Not a Spring Onion
Glen T, heated, not stirred