Jérôme Gamez 🐘Mar 13
Alda Vigdís
So AGENTS.md is just the human-readable documentation the AI dudebros have been refusing to include in README.md until now, because they claim that the code is "self documenting" and everyone else must be stupid if they can't figure things out.
Mar 12 at 5:28pmWeb
Show threadAlda VigdísMar 12
So next time I run into those fuckbags at work, I'll just pose as a chatbot to get them to document their code, eh?
Show threadLars StitzMar 12
@alda Here, it's even worse than that - the morons suggested dead seriously to *have an LLM generate documentation* which then could be checked into the repo.
Show threadMichael MooreMar 12
@stitzl @alda I currently have team members that insist that having an LLM write the documentation is the only way. "It takes too long to write it, otherwise..." It's fucking pathetic how much work people are outsourcing now. Yet, I'm the crazy one when I say anything about using these shitty tools?
Show threadMichael MooreMar 12
@stitzl @alda Oh, and they want to use Co-pilot or ChatGPT to refine our stories before we work on them. Apparently, it's the only way to really know ensure we have everything covered or called out in the tickets.🤯
Show threadLars StitzMar 12

@mrmoore I mean, if a person wants to use a LLM, they can do it - but at their own risk. They're free to ask it what they, specifically and individually, want to know about the codebase, or a function, at any level of detail already. They can drill down as far as they like, add context to their questions, and maybe get even some useful reply.

But don't force their slop on me, don't force me to maintain their slop, and probably don't feed the slop back to the LLM - that cannot end well. @alda

Show threadDaniele Verducci 🧉Mar 12
@stitzl @alda heard the same extact thing at work. The worst part is, I didn't hear it from an executive, but from a developer...
Show threadAzuaronMar 12

@alda Joke's on you, they're using the AI to generate the AGENTS.md, and it's full of errors.

(I'm not joking, unfortunately.)

Show threadI am Jack's Found 404Mar 12

@alda

🎵 Secret Agent... Docs!🎵
🎵 Secret Agent... Docs!🎵
🎵 They're giving you a chatbot 🎵
🎵 And taking away your credibility🎵

Show threadI am Jack's Found 404Mar 13

@alda

And taking away your brain!

Took a minute but the rhyme was right there all along! 🤣 

Show threadBen PfaffMar 12
@alda My guess is that they're not writing the agents file by hand though.
Show threadR.I.PienaarMar 12

@alda @Anarcat do you know who usually writes AGENTS.md?

Not humans. LLMs after reading the self documenting code.

If you like those files maybe complain less about LLM generated docs? Could have a lot more equally good docs

Show threadanarcatMar 12
@ripienaar @alda i'm not complaining about docs, i'm complaining about bros not bothering to write friggin docs
Show threadR.I.PienaarMar 12
@Anarcat @alda so you would be happy with high quality AI generated docs? Like the AGENTS.md files just in doc form?
Show threadanarcatMar 12
@ripienaar @alda i am not currently happy with AI anything, but i am not understanding why you are sealioning a stranger right now either
Show threadDmitry TantsurMar 13
@Anarcat @ripienaar @alda pointing out simple logical flows is not sealioning for God's sake.. learn the meaning of words you use
Show threadAlda VigdísMar 13
@creepy_owlet @Anarcat @ripienaar and what is a "logical flow" if I may ask?
Show threadAlda VigdísMar 12
@ripienaar @Anarcat
Show threadanarcatMar 12
@alda except the seal is a bot
Show threadAgyei GyasiMar 12
@alda 🫸sELf-DoCUmenTINg🫷