logoalt Hacker News

Wowfunhappytoday at 2:43 PM2 repliesview on HN

I think it makes sense to include in source control, just as it’s pretty typical to include documentation (such as a readme file) in source control. CLAUDE.md is really just project documentation.


Replies

data-ottawatoday at 3:14 PM

I’ve always struggled with what should be in Claude.md that doesn’t belong in readme.md or a similar supporting file.

I tend to include a well documented justfile, so between the readme and that common commands are covered. If there’s a style guide it should be its own file, or summarized in the readme.

If Claude is making errors I tend to just update my global Claude file, but I haven’t updated it in 6 months — only to disable Claude signatures on generated commit messages.

comboytoday at 2:59 PM

methinks if you really want to have it versioned it should be AGENTS.md in VCS and your globally gitignored CLAUDE.md just @AGENTS.md

otherwise it's like leaving vim dotfiles in the repo or something

show 1 reply