News for hackers. Stuff that matters.

A comment on Ask HN: How do you keep system context from rotting over time?.

Re:Ask HN: How do you keep system context from rotting over ... by amadeuswoo on Tuesday January 20, 2026 @06:53PM (#46699333)
One thing that’s evidently helped: using CLAUDE.md / agent instructions as de facto architecture docs. If the agent needs to understand system boundaries to work effectively, those docs actually get maintained
[ Parent | on HN ]
Re:Ask HN: How do you keep system context from rotting over ... by kennethops on Tuesday January 20, 2026 @09:23PM (#46700422)
But how do you ensure the .md file is able to see all of the details of the infra?
[ Parent | on HN ]
Re:Ask HN: How do you keep system context from rotting over ... by amadeuswoo on Tuesday January 20, 2026 @11:09PM (#46700988)
You don't, it's a map of intent, not infra state. What exists, why, what talks to what. Live state still needs IaC and observability. The .md captures the 'why' that terraform can't
[ Parent | on HN ]