Live data from Hacker News

Writing a good Claude.md

humanlayer.dev

301–304 of 304 posts

Re: Writing a good Claude.md

#301

Earlier quoted context omitted.

What kind of citation or evidence would you expect? How would you measure productivity gains? From my personal life and activities however it is very clear. I have simply been able to do so many things I would have never been able to do without AI.

> How would you measure productivity gains? I'm not entirely sure - certainly anecdotes abound (as do anecdotes to the contrary). I am however sure that when someone claims that a technology is world-changing, and that it has already led to significant productivity gains... the onus is on them to provide evidence for such claims

Should I not share my experiences then about something that can't be scientifically proven? I am not actually looking to prove anything, but I am sharing my experience. I don't even win anything from people believing me, but I guess I have this weird urge to "set something straight" if in my experience something is the case. I have done tons of DIY stuff that I wouldn't have been able to without AI. Tons of side projects. In my corpo work I have been able to do more with less hours and mental effort spent, although in corpo work AI has given me less gains since most of the time I have been blocked by other factors and everyone else.

It is too fast evolving to be able to be legitimately scientifically understood. It is non sense to expect that.

Re: Writing a good Claude.md

#302

Earlier quoted context omitted.

READMEs are written for people, CLAUDE.mds are written for coding assistants. I don’t write “CRITICAL (PRIORITY 0):” in READMEs. The benefit of CLAUDE.md files is that they’re pulled in automatically, eg if Claude wants to read “tests/foo_test.py” it will automatically pull in “tests/CLAUDE.md” (if it exists).

I often can't tell the difference between my Readme and Claude files to the point that I cannibalise the Claude file for the Readme. It's the difference between instructions for a user and instructions for a developer, but in coding projects that's not much different.

> It's the difference between instructions for a user and instructions for a developer

Sounds like a job for a CONTRIBUTING.md :)

Re: Writing a good Claude.md

#303

Earlier quoted context omitted.

> How would you measure productivity gains? I'm not entirely sure - certainly anecdotes abound (as do anecdotes to the contrary). I am however sure that when someone claims that a technology is world-changing, and that it has already led to significant productivity gains... the onus is on them to provide evidence for such claims

Should I not share my experiences then about something that can't be scientifically proven? I am not actually looking to prove anything, but I am sharing my experience. I don't even win anything from people believing me, but I guess I have this weird urge to "set something straight" if in my experience something is the case. I have done tons of DIY stuff that I wouldn't have been able to without AI. Tons of side proj…

> Should I not share my experiences then about something that can't be scientifically proven?

By all means share anecdotes, but maybe phrase them as anecdotes. "improving my own productivity massively" is an anecdote, whereas "delivering massive productivity gains" reads as a sweeping generalisation

Re: Writing a good Claude.md

#304

Earlier quoted context omitted.

Should I not share my experiences then about something that can't be scientifically proven? I am not actually looking to prove anything, but I am sharing my experience. I don't even win anything from people believing me, but I guess I have this weird urge to "set something straight" if in my experience something is the case. I have done tons of DIY stuff that I wouldn't have been able to without AI. Tons of side proj…

> Should I not share my experiences then about something that can't be scientifically proven? By all means share anecdotes, but maybe phrase them as anecdotes. "improving my own productivity massively" is an anecdote, whereas "delivering massive productivity gains" reads as a sweeping generalisation

I see it delivering that for others too though. To me it is so obvious that I don't understand how anyone can think otherwise...
Post reply on HN