Writing a Good Claude.md

Re:Writing a Good Claude.md by scelerat on Monday December 01, 2025 @12:18PM (#46110050)

> we recommend keeping task-specific instructions in separate markdown files with self-descriptive names somewhere in your project.

Should do this for human developers too. Can't count the number of times I've been thrown onto a project and had to spend a significant amount of time opening and skimming files just to answer simple questions that should be answered in high-level docs like this.

[ Parent | on HN ]

Re:Writing a Good Claude.md by abustamam on Monday December 01, 2025 @12:24PM (#46110125)

There's a funny joke I heard that they made Claude Code only to force developers to write better documentation.

But in all seriousness, it's working. I write cursor rules religiously and I point other devs to them. Its great.

[ Parent | on HN ]

Re:Writing a Good Claude.md by minor3 on Monday December 01, 2025 @12:28PM (#46110182)

Yeah I do love how many "best practices" we are only implementing because of LLMs, even though they were massively beneficial for humans prior as well.

[ Parent | on HN ]