Earlier quoted context omitted.
Isn’t that what every new session does?
That also clears the context; a command would just append to the context.
Writing a good Claude.md
281–290 of 304 posts
Re: Writing a good Claude.md
#282Earlier quoted context omitted.
Because I’m trained as a physicist and (non-software) engineer and I know my field’s history? Here’s the first result that comes up on Google. Seems accurate from a quick skim: https://www.ageofinvention.xyz/p/age-of-invention-why-wasnt-... And yes we should seek to understand new inventions. Which we are doing right now, in the form of interpretability research. We should not be making Luddite calls to halt progress…
Can you cite a section from this very long page that might convince me no one at the time understood how turning water into steam worked to create pressure? If this is your industry, shouldn't you have a more reputable citation, maybe something published more formally? Something expected to stand up to peer review, instead of just a page on the internet? > We should not be making Luddite calls to halt progress simply…
To really understand WHY a steam engine works, you need to understand the behavior of ideal gasses (1787 - 1834) and entropy (1865). The ideal gas law is enough to perform calculations needed to design a steam engine, but it was seen at the time to be just as inscrutable. It was an empirical observation not derivable from physical principles. At least not until entropy was understood in 1865.
James Watt invented his steam engine in 1765, exactly a hundred years before the theory of statistical mechanics that was required to explain why it worked, and prior to all of the gas laws except Boyle’s.
Re: Writing a good Claude.md
#283Earlier quoted context omitted.
While I believe you're probably right that getting any productivity gains from these tools requires an investment, I think calling the process "engineering" is really stretching the meaning of the word. It's really closer to ritual magic than any solid engineering practices at this point. People have guesses and practices that may or may not actually work for them (since measuring productivity increases is difficult…
Most countries don’t have a notion of a formally licensed software engineer, anyway. Arguing what is and is not engineering is not useful.
I was replying to someone who claimed that getting real productivity gains from this tool requires engineering and needs to be approached as such. It also compared learning to use LLM agents to learning to code in emacs or vim, or learning a programming language - things which are nothing alike to learning to control an inherently stochastic tool that can't even be understood using any of our regular scientific methods.
Re: Writing a good Claude.md
#284Re: Writing a good Claude.md
#285Earlier quoted context omitted.
Is your logic that unless something is perfect it should not be used even though it is delivering massive productivity gains?
> it is delivering massive productivity gains [citation needed] Every article I can find about this is citing the valuation of the S&P500 as evidence of the productivity gains, and that feels very circular
Re: Writing a good Claude.md
#286Earlier quoted context omitted.
It’s not delivering on magical stuff. Getting real productivity improvements out of this requires engineering and planning and it needs to be approached as such. One of the big mistakes I think is that all these tools are over-promising on the “magic” part of it. It’s not. You need to really learn how to use all these tools effectively. This is not done in days or weeks even, it takes months in the same way becoming…
While I believe you're probably right that getting any productivity gains from these tools requires an investment, I think calling the process "engineering" is really stretching the meaning of the word. It's really closer to ritual magic than any solid engineering practices at this point. People have guesses and practices that may or may not actually work for them (since measuring productivity increases is difficult…
The whole point is to get a process around it that works and gets the “ritual magic” out of it.
I labeled that as engineering.
Re: Writing a good Claude.md
#287Earlier quoted context omitted.
Most countries don’t have a notion of a formally licensed software engineer, anyway. Arguing what is and is not engineering is not useful.
I think it's relevant when people keep using terms like "prompt engineering" to try and beef up this charade of md files that don't even seem to work consistently. This is a far far cry from even writing yaml for Github/Gitlab CICD pipelines. Folks keep trying to say "engineering" when every AI thread like this seems to push me more towards "snake oil" as an appropriate term.
If you’re not benchmarking and systematically measuring the impact of your changes, it’s not prompt engineering, it’s just improving stuff.
Re: Writing a good Claude.md
#288Earlier quoted context omitted.
> no amount of prompting will prevent this situation. Again, missing the point. If you don't prompt for it and you document it in a place where the tool won't look first, the tool simply won't do it. "No amount of promoting" couldn't be more wrong, it works for me and all my coworkers. > If it is a concern then you put a linter or unit tests to prevent it altogether Sure, and then it'll always do things it's own way,…
> There's no way to exhaustively detect with a linter that you used findOne and checked the result for null and threw a NotFoundError Yes there is? Though this is usually better served with a type checker, it’s still totally feasible with a linter too if that’s your bag > because avoiding it is just one line in CLAUDE.md. Except no, it isn’t, because these tools still ignore that line sometimes so I still have to che…
It's not, because you would have to implement a full static analyzer that traces where the result of a `findOne` call is checked for `null` and then check that the condition always leads to a `NotFoundError`. At best you've got a linter that only works some of the time, at worst you've just made your linter terribly slow and buggy.
> these tools still ignore that line sometimes so I still have to check for it myself.
this is _literally_ the point of the article
Re: Writing a good Claude.md
#289Earlier quoted context omitted.
This is missing the point. If I want to instruct Claude to never write a database query that doesn't hit a preexisting index, where exactly am I supposed to document that? You can either choose: 1. A centralized location, like a README (congrats, you've just invented CLAUDE.md) 2. You add a docs folder (congrats, you've just done exactly what the author suggests under Progressive Disclosure) Moreover, you can't just…
> 1. A centralized location, like a README (congrats, you've just invented CLAUDE.md) README files are not a new concept, and have been used in software for like 5 decades now, whereas CLAUDE.md files were invented 12 months ago...
Re: Writing a good Claude.md
#290Earlier quoted context omitted.
Strange. I haven’t experienced this a single time and I use it almost all day everyday.
That is strange because it's been going on since sonnet 4.5 release.