MAKE THE PROJECT LEGIBLE

Record Intent, Decisions and Current Reality

Treat these as three complementary things.

IntentWhat you wanted.

DecisionWhy a particular approach was chosen.

RealityWhat currently exists.

Intent
Adding an artefact should require editing only data.

Decision
Store artefacts in JSON rather than JavaScript.

Why
Content should remain human-editable.

Current state
Artefact data is externalised; section descriptions are still hard-coded.

This gives you

Intent↔Decision↔Implementation

Takeaway

Track intent, decision and reality separately, and drift becomes visible.