This aligns 100% with the philospohy of Varar (<a href="https://varar.dev" rel="nofollow">https://varar.dev).
In-between all those ephemeral agent sessions, spec, plan and design files, there is something that survives. The src/*.md files.
With Varar you can link small parts (cells) of those Markdown files to your code, so they stay in sync. So you (and agents) can find out what your system does without reading 300 million lines of code.
Full disclaimer: I am the guy who wrote Cucumber - that most people here hate. I eventually lost my love for that tool myself, but I did miss the ability to keep docs and code in sync. Hence Varar - a tool like that with fewer (different?) warts, for the agentic area.
aslakhellesoy · · focus · HN ↗
In-between all those ephemeral agent sessions, spec, plan and design files, there is something that survives. The src/*.md files.
With Varar you can link small parts (cells) of those Markdown files to your code, so they stay in sync. So you (and agents) can find out what your system does without reading 300 million lines of code.
Full disclaimer: I am the guy who wrote Cucumber - that most people here hate. I eventually lost my love for that tool myself, but I did miss the ability to keep docs and code in sync. Hence Varar - a tool like that with fewer (different?) warts, for the agentic area.