Hacker News new | ask | show | jobs
by hakanderyal 307 days ago
With Claude Code, you need to create the docs beforehand, not after.

For my latest project, I have 20k+ lines of markdown docs to guide it, with great success. Some of them are generic rules, some of them describes how I code, some of them describing the codebase & features. Then I have another 17k+ that are used while coding. Plans, phases, todos, reviews etc.

All of them are written by Claude Code also. I'm calling it "spec-driven development".

Cursor has a much different flow, where you usually pair program with it, which I call "ai-assisted development".

2 comments

I've tried this approach but at some point you're just coding in a less precise language (English), and with more duplication.

My current approach is to stub out the architecture I want, write the type definitions I want in full, and ask Claude to fill in the blanks. It's good at implementing an interface but bad at devising the interface on its own.

That’s more or less what I do, but in an expanded way.

It’s not coding in English, but giving Claude memory about how the code base works, how it’s structured, what features available, why things are created etc.

This is how we work too, we have all these info in our head when building. But every CC session starts a new with blank slate. These documents helps getting the session “warmed up” enough to get quality output with lesser tech debt.

Yes, but claude forgets things