Comment by KronisLV
2 days ago
> Ensure code is written in such a way that it's easy to understand for LLMs;
> Capture all "invisible knowledge" around decisions and architecture that's difficult to infer from code alone.
I work on projects where people love to create all sorts of complex abstractions but also hate writing ADRs (so they don’t) or often any sorts of comments and when they do they’re not very well written. Like the expectation is that you should call and ask the person who wrote something or have a multi-hour meeting where you make decisions and write nothing down.
That sort of environment is only conductive to manual work, dear reader, avoid those. Heed the advice above about documenting stuff.
Whether or not we work at the same place, we work at the same place.