logoalt Hacker News

theletterftoday at 6:10 PM1 replyview on HN

Code doesn't explain best practices, architectural concerns, and so on. Best combo? Docs + code.


Replies

jaggederesttoday at 7:05 PM

It also redirects the agents from adding enormous sloppy comments in the code - I have a linter that only allows 1 line comments with a reference to a docs folder tag `See BOB-IS-UNCLE.md`

Then you can ruthlessly prune the docs folder on PR review and regular passes when e.g. claude really wants to write a novel about the glorious intricacies of bugs it's solved.