frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Anatomy of the .claude/ Folder

https://blog.dailydoseofds.com/p/anatomy-of-the-claude-folder
104•freedomben•1h ago

Comments

bagrow•1h ago
Here's a question that I hope is not too off-topic.

Do people find the nano-banana cartoon infographics to be helpful, or distracting? Personally, I'm starting to tire seeing all the little cartoon people and the faux-hand-drawn images.

Wouldn't Tufte call this chartjunk?

ramon156•1h ago
LinkedIn loves these, even if they're broken.

But they had already lost me at all the links, and the fact there's not a red wire through the entire article.

The first thing my eyes skimmed was:

> CLAUDE.md: Claude’s instruction manual

> This is the most important file in the entire system. When you start a Claude Code session, the first thing it reads is CLAUDE.md. It loads it straight into the system prompt and keeps it in mind for the entire conversation.

No it's not. Claude does not read this until it is relevant. And if it does, it's not SOT. So no, it's argumentatively not the most important file.

SV_BubbleTime•19m ago
Maybe. But I kind of view LinkedIn as a social network for people who only by the grace of a couple better decisions are talking about real business and not multilevel marketing schemes… but otherwise use the same themes and terminologies.

Like mostly people who have confused luck and success, or business acumen for religion.

So I wouldn’t use LinkedIn as a positive data point of what’s hot.

push0ret•1h ago
I haven't come around any AI generated imagery in documents / slides that adds any value. It's more the opposite, they stand out like a sore thumb and often even reduce usability since text cannot be copied. Oh and don't get me started on leadership adding random AI generated images to their emails just to show that they use AI.
GaggiX•1h ago
It may be survivorship bias, you only notice the AI ones that are bad.
spunker540•25m ago
Yeah there are almost certainly times when it is gen ai and you just didn’t notice.
linux2647•56m ago
> Oh and don't get me started on leadership adding random AI generated images to their emails just to show that they use AI

Feels like generated AI art like this is modern clipart

simonw•1h ago
My eye has started skipping past them, even though they're often quite useful if you engage with them.

I think the problem is that they're uninformative slop often enough that I've subconsciously determined they aren't worth risking attention time on.

browningstreet•1h ago
I think it's fine. As someone who blogged a lot, the instant visual differentiation among articles offered by the art within is actually valuable.
eitally•57m ago
I am a victim of AI-documentation-slop at work, and the result is that I've become far more "Tuftian" in my preferences than ever before. In the past, I was a fan of beautiful design and sometimes liked nice colors and ornaments. Now, though, I've a fan of sparse design and relevant data (not information -- lots of information is useless slop). I want content that's useful and actionable, and the majority of the documents many of my peers create using Claude, Gemini or ChatGPT are fluffy broadsheets of irrelevant filler, rarely containing insights and calls-to-action.

So yes, it's chartjunk.

fny•57m ago
This is equivalent to "do people find PowerPoint to be helpful or distracting." Sometimes yes, mostly no.

In this case, I'd say helpful because I didn't have to read the article at all to understand what was being communicated.

heliumtera•51m ago
No. It adds nothing so nothing is preferred
freedomben•35m ago
Most of the time I find them distracting, and sometimes a huge negative on the article. In this particular article though, they're well done and relevant, and I think they add quite a bit. It's a highly personal opinion kind of thing though for sure.
SV_BubbleTime•23m ago
The first one is actually quite good.

Some of the others, I don’t feel like added value, but I agree that these are some of the best of a practice that I agreed does not add a ton of value typically

elcapitan•32m ago
When I see AI images, I skip them, and most likely, the entire article. They're a better warning sign than the ones hidden in the text.
SV_BubbleTime•22m ago
Yeah, I’ve been considering this. They’re going to start removing em dashes, which currently is a surefire way to detect AI text.

Let’s say lose those and using emojis as bullet points. It’s going to be a lot harder to detect.

btucker•15m ago
It's not necessarily an AI-generated infographics issue, it's that these aren't good infographics. The graphic part is adding minimal value.
TheRoque•1h ago
So that's what "software engineering" has become nowadays ? Some cargo cult basically. Seriously all of this gives red flag. No statements here are provable. It's just like langhchain that was praised and then everyone realized it's absolute dog water. Just like MCP too. The job in 2026 is really sad.
graypegg•45m ago
I think I'm finding a pretty good niche for myself honestly. IMO, Software engineering is more so splitting into different professions based on the work is produces.

This sort of "prompt and pray" flow really works for people, as in they can make products and money, however, I do think the people that succeed today also would've reached for no-code tools 5 years ago and seen similar success. It's just faster and more comprehensive now. I think the general theme of the products remains the same though; not un-important or worthless, but it tends to be software that has effects that say INSIDE the realm of software. I feel like there's always been a market for that, as it IS important, it's just not WORTH the time and money to the right people to "engineer" those tools. A lot of SaaS products filled that niche for many years.

While it's not a way I want to work, I am also becoming comfortable with respecting that as a different profession for producing a certain brand of software that does have value, and that I wasn't making before. The intersection of that is opportunity I'm missing out on; no fault to anyone taking it!

The software engineer that writes the air traffic avoidance system for a plane better take their job seriously, understand every change they make, and be able to maintain software indefinitely. People might not care a ton about how their sales tracking software is engineered, but they really care about the engineering of the airplane software.

baal80spam•42m ago
> prompt and pray

This is a brilliant reimagining of the old and trusted PnP acronym.

sarchertech•30m ago
I think this is mostly right. The primary difference is that with no code you had to change platforms, but the Prompt and Pray method can be brought to bear on any software easily even the air traffic avoidance system.

It shouldn’t be, but it’s going to take some catastrophic events to convince people that we have to work to make sure we understand the systems we’re building and keep everything from devolving into vibe coded slop.

graypegg•13m ago
> the Prompt and Pray method can be brought to bear on any software easily even the air traffic avoidance system.

I guess that's why I see it as a separate profession, as in we have to actually profess a standard for how a professional in our field acts and believes. I think it's OK for it to bifurcate into two different fields, but Software Engineering would need to specifically reject prompt-and-pray on a principled and rational basis.

Sadly yes, that might require real cost to life in order to find out the "why" side of that rational basis. If you meet anyone that went to an engineering school in Québec, ask them about the ceremony they did and the ring they received. [0] It's not like that ceremony fixes anything, but it's a solemn declaration of responsibility which to me at least, sets a contract with society that says "we won't make things that harm you".

[0] https://ironring.ca/home-en/

    > [The] history of the 1907 failure of the Quebec City bridge, which was the inspiration for the Calling of an Engineer ceremony.
sunir•25m ago
When was it not a cargo cult?
manudaro•1h ago
The .claude folder structure reminds me of how Terraform organizes state files. Smart move putting conversation history in Json rether than some propiertary format, makes it trivial to grep through old conversations or build custom analysis tools.
unshavedyak•33m ago
Claude itself will grep through old conversations so it’s handy that Claude understands too
galoisscobi•1h ago
> Most people either write too much or too little. Here’s what works.

> Two folders, not one

Why post AI slop here?

rvz•41m ago
"Thinking" is about to get even harder to do for most grifters with newsletters to sell.
jwilliams•1h ago
> Simply put: whatever you write in CLAUDE.md, Claude will follow.

No.

CLAUDE.md is just prompt text. Compaction rewrites prompt text.

If it matters, enforce it in other ways.

taormina•54m ago
Exactly!
BoredPositron•1h ago
Alchemy.
exitb•55m ago
I’m seeing this more and more, where people build this artificial wall you supposedly need to climb to try agentic coding. That’s not the right way to start at all. You should start with a fresh .claude, empty AGENTS.md, zero skills and MCP and learn to operate the thing first.
heliumtera•52m ago
Operate == me send https post and pray for the best
dietr1ch•42m ago
That's the goal, keep spending tokens and claim you are super productive because of it
jameshart•50m ago
Yes, but as soon as you start checking in and sharing access to a project with other developers these things become shared.

Working out how to work on code on your own with agentic support is one thing. Working out how to work on it as a team where each developer is employing agentic tools is a whole different ballgame.

georgeburdell•26m ago
In my own group, agentic coding made sharing and collaboration go out the window because Claude will happily duplicate a bunch of code in a custom framework
freedomben•27m ago
I totally agree with you that this not the right way to start. But, in my experience, the more you use the tool the more of a "feel" you get for it, and knowing how all these different pieces work and line up can be quite useful (though certainly not mandatory). It's been immensely frustrating to me how difficult it is to find all this info with all the low-quality junk that is out there on the internet.
embedding-shape•25m ago
> all the low-quality junk that is out there on the internet.

Isn't this article just another one in that same drawer?

> What actually belongs in CLAUDE.md - Write: - Import conventions, naming patterns, error handling styles

Then just a few lines below:

> Don’t write: - Anything that belongs in a linter or formatter config

The article overall seems filled with internal inconsistencies, so I'm not sure this article is adding much beyond "This is what an LLM generated after I put the article title with some edits".

Fishkins•17m ago
I agree with most of this, with one important exception: you should have some form of sandboxing in place before running any local AI agent. The easiest way to do that is with .claude/settings.json[0].

This is important no matter how experienced you are, but arguable the most important when you don't know what you're doing.

0: or if you don't want to learn about that, you can use Claude Code Web

post-it•7m ago
The default sandboxing works fine for me. It asks before running any command, and I can whitelist directories for reading and non-compound commands.
Synthetic7346•50m ago
I wish all model providers would converge on a standard set of files, so I could switch easily from Claude to Codex to Cursor to Opencode depending on the situation
embedding-shape•46m ago
Issue is that both harness and specific model matters a lot in what type of instruction works best, if you were to use Anthrophic's models together with the best way to do prompting with Codex and GPT models, you'd get a lot worse results compared to if you use GPT models with Codex, prompted in the way GPTs react best to them.

I don't think people realize exactly how important the specific prompts are, with the same prompt you'd get wildly different results for different models, and when you're iterating on a prompt (say for some processing), you'd do different changes depending on what model is being used.

freedomben•33m ago
Having experimented with soft-linking AGENTS.md into CLAUDE.md and GEMINI.md, this lines up well with my experience. I now just let each time maintain it's own files and don't try to combine them. If it's something like my custom "## Agent Instructions" then I just copy-pasta and it's not been hard, and since that section is mostly identical I just treat AGENTS.md as the canonical and copy/paste any changes over to the others.
dbmikus•14m ago
Are there any good guides on how to write prompt files tailored to different agents?

Would also be interested in examples of a CLAUDE.md file that works well in Claude, but works poorly with Codex.

heliumtera•38m ago
And why would they ever let switch?
phyzix5761•40m ago
Is there a completely free coding assistant agent that doesn't require you to give a credit card to use it?

I recently tried IntelliJ for Kotlin development and it wanted me to give a credit card for a 30 day trial. I just want something that scans my repo and I tell it the changes I want and it does it. If possible, it would also run the existing tests to make sure its changes don't break anything.

sunir•26m ago
Qwen code has a free tier

Opencoder is bring your own model.

You get what you pay for so good luck.

bhaak•24m ago
Gemini Code Assist has a free tier.

You log in with your Goggle account.

bityard•13m ago
There are lots! Too many to cover in a single HN comment, and this space is evolving rapidly so I encourage you to look around.

While the coding assistants are pretty much universally free, you still need to connect them to a model. The model tokens generally cost something once you've gone past a certain quota.

I'm not sure if this is still true, but if you have a Google account, Gemini Code Assist had a quite generous "free tier" that I used for a while and found it do be pretty decent.

63stack•37m ago
The article starts off really weak:

>Claude Code users typically treat the .claude folder like a black box. They know it exists. They’ve seen it appear in their project root. But they’ve never opened it, let alone understood what every file inside it does.

I know we are living in a post-engineering world now, but you can't tell me that people don't look at PRs anymore, or their own diffs, at least until/if they decide to .gitignore .claude.

sunir•36m ago
You’re assuming most people using Claude code are senior engineers.
politelemon•35m ago
And that we're living in a post engineering world.
groby_b•26m ago
100% AI slop. All the way to "The Key Insight".
rdevilla•14m ago
The fuck? What's next, configuring maven and pom.xml? At least XML is unambiguous, well specified, and doesn't randomly refuse to compile 2% of the time..
forgotusername6•13m ago
If these different agents could agree on a standard location that would be great. The specs are almost the same for .github and Claude but Claude won't even look at the .github location.
submeta•6m ago
Tangential: The image with the heading "Anatomy of the .claude/ folder" is nicely made, anyone knows what tool is used for it?
saadn92•4m ago
The claim that "whatever you write in CLAUDE.md, Claude will follow" is doing a lot of heavy lifting. In practice CLAUDE.md is a suggestion, not a contract. Complex tasks and compaction will dilute the use of CLAUDE.md, especially once the context window runs out.

Anatomy of the .claude/ Folder

https://blog.dailydoseofds.com/p/anatomy-of-the-claude-folder
106•freedomben•1h ago•57 comments

Installing a Let's Encrypt TLS Certificate on a Brother Printer with Certbot

https://owltec.ca/Other/Installing+a+Let%27s+Encrypt+TLS+certificate+on+a+Brother+printer+automat...
61•8organicbits•2h ago•16 comments

The 'paperwork flood': How I drowned a bureaucrat before dinner

https://sightlessscribbles.com/posts/the-paperwork-flood/
371•robin_reala•3h ago•272 comments

Desk for people who work at home with a cat

https://soranews24.com/2026/03/27/japan-now-has-a-special-desk-for-people-who-work-at-home-with-a...
47•zdw•54m ago•12 comments

A Faster Alternative to Jq

https://micahkepe.com/blog/jsongrep/
287•pistolario•9h ago•174 comments

SimpleX Chat

https://simplex.chat/
9•Cider9986•51m ago•4 comments

How and why to take a logarithm of an image [video]

https://www.youtube.com/watch?v=ldxFjLJ3rVY
109•jgwil2•4d ago•40 comments

Hold on to Your Hardware

https://xn--gckvb8fzb.com/hold-on-to-your-hardware/
398•LucidLynx•6h ago•333 comments

Schedule tasks on the web

https://code.claude.com/docs/en/web-scheduled-tasks
237•iBelieve•11h ago•200 comments

Apple discontinues the Mac Pro

https://9to5mac.com/2026/03/26/apple-discontinues-the-mac-pro/
558•bentocorp•19h ago•514 comments

People inside Microsoft are fighting to drop mandatory Microsoft Account

https://www.windowscentral.com/microsoft/windows-11/people-inside-microsoft-are-fighting-to-drop-...
83•breve•2h ago•52 comments

EMachines never obsolete PCs: More than a meme

https://dfarq.homeip.net/emachines-never-obsolete-pcs-more-than-a-meme/
17•zdw•3d ago•5 comments

Why so many control rooms were seafoam green (2025)

https://bethmathews.substack.com/p/why-so-many-control-rooms-were-seafoam
943•Amorymeltzer•2d ago•195 comments

Gzip decompression in 250 lines of Rust

https://iev.ee/blog/gzip-decompression-in-250-lines-of-rust/
41•vismit2000•3d ago•18 comments

The European AllSky7 fireball network

https://www.allsky7.net/#archive
101•marklit•9h ago•7 comments

The Last Gasps of the Rent Seeking Class

https://geohot.github.io//blog/jekyll/update/2026/02/26/the-last-gasps-of-the-rent-seeking-class....
11•surprisetalk•1h ago•2 comments

Sand from Different Beaches in the World

https://magnifiedsand.com/
6•RAAx707•3d ago•0 comments

Local Bernstein theory, and lower bounds for Lebesgue constants

https://terrytao.wordpress.com/2026/03/23/local-bernstein-theory-and-lower-bounds-for-lebesgue-co...
36•jjgreen•3d ago•7 comments

Show HN: I put an AI agent on a $7/month VPS with IRC as its transport layer

https://georgelarson.me/writing/2026-03-23-nullclaw-doorman/
300•j0rg3•17h ago•88 comments

$500 GPU outperforms Claude Sonnet on coding benchmarks

https://github.com/itigges22/ATLAS
423•yogthos•22h ago•230 comments

Apple says no one using Lockdown Mode has been hacked with spyware

https://techcrunch.com/2026/03/27/apple-says-no-one-using-lockdown-mode-has-been-hacked-with-spyw...
5•jbegley•14m ago•0 comments

Hong Kong Police Can Now Demand Phone Passwords Under New Security Rules

https://www.gadgetreview.com/hong-kong-police-can-now-demand-phone-passwords-under-new-security-r...
94•vidyesh•2h ago•87 comments

We rewrote JSONata with AI in a day, saved $500k/year

https://www.reco.ai/blog/we-rewrote-jsonata-with-ai
238•cjlm•17h ago•217 comments

DOOM Over DNS

https://github.com/resumex/doom-over-dns
330•Venn1•4d ago•87 comments

Rank the 50 best Apple products

https://www.theverge.com/cs/tech/900477/apple-50-anniversary-rank-products
29•dqieu•1h ago•24 comments

QRV Operating System: QNX on RISC-V

https://r-tty.blogspot.com/2026/03/qrv-operating-system-first-publication.html
41•chrsw•4d ago•7 comments

Running Tesla Model 3's computer on my desk using parts from crashed cars

https://bugs.xdavidhu.me/tesla/2026/03/23/running-tesla-model-3s-computer-on-my-desk-using-parts-...
926•driesdep•1d ago•320 comments

My minute-by-minute response to the LiteLLM malware attack

https://futuresearch.ai/blog/litellm-attack-transcript/
413•Fibonar•1d ago•152 comments

Whistler: Live eBPF Programming from the Common Lisp REPL

https://atgreen.github.io/repl-yell/posts/whistler/
123•varjag•3d ago•14 comments

HyperAgents: Self-referential self-improving agents

https://github.com/facebookresearch/hyperagents
222•andyg_blog•2d ago•78 comments