Maintaining project documentation is:

(1) Easier with AI

(2) Critical for letting AI work effectively in your codebase.

Try creating well structured rules for working in your codebase, put in .cursorrules or Claude equivalent... let AI help you... see if that helps.

The magic to using agentic LLMs efficiently is...

proper project management.

You need to have good documentation, split into logical bits. Tasks need to be clearly defined and not have extensive dependencies.

And you need to have a simple feedback loop where you can easily run the program and confirm the output matches what you want.

And the chance of that working depends on the weather, the phase of the moon and the arrangement of bird bones in a druidic augury.

It's a non-deterministic system producing statistically relevant results with no failure modes.

I had Cursor one-shot issues in internal libraries with zero rules.

And then suggest I use StringBuilder (Java) in a 100% Elixir project with carefully curated cursor rules as suggested by the latest shamanic ritual trends.