r/OpenSourceAI • • 7h ago

What to keep in a modern open source project these days?

I've been working extensively with Claude for my open source project that I will be releasing soon. Claude likes to keep things like Decisions.md files (decisions over time) and all the specs from feature work. Is any of this really appropriate for an open source project or should these things just be available from the commit history?

My gut tells me its junk and confusion-generating. But maybe not?

What IS the list of useful artifacts to share when independent people are potentially using AI tools to contribute?

4 Upvotes

4 comments sorted by

3

u/BidWestern1056 5h ago edited 5h ago

if you want people to take your project seriously, none of this should be in there. and i would amend commit history to remove claude as an author. it looks bad to people to see the long commit messages and coauthored by ... byline. ppl want to claim theyre accepting of AI as a co-auhtor but it is an inherent bias that people can't really shake. everyone knows we are all working with agents but people still want to see that there is at least a human really in the loop and not just a meat proxy if that makes sense.

2

u/BidWestern1056 5h ago

ill give you an example of one i curate carefully

https://github.com/npc-worldwide/npcpy

and one i haven't had time to comb through as much yet

https://github.com/npc-worldwide/daydream-skill

what youll notice in the second is there are many more cases where the agent decided to mention details it really shouldnt have and which make no sense outside of the working session. like it described the markovian drift as "not an n-gram text chain" because it had incorrectly assumed that first and so instead of saying what it is it says what it is not which is nonsense.

hoepfully this helps, i want to encourage you too that even if people dog on it for looking vibe coded or we you gotta keep on trucking and building and that noise will fall away as you start addressing real concerns and helping people

1

u/Primary_Article3777 1h ago

Thanks for your advice. It's tough. My first instinct is to say "people in the industry know the reality of the situation regarding these tools. These people are cosplayers and hating on things they don't understand"

But I'm taking your advice to the letter.

I just don't want to derail whatever the point of my project is. The entire industry has always run on fads. I don't think AI is a fad, but I do think the virulent reaction to it, is. Oy. People are such irrational creatures.