TheDevRicardo · Ricardo Moses

PROJECT_STATE.md: how I hand my projects to an AI and pick them back up

The worst part of any project is coming back to it. Two weeks away, then you open the folder and stare at the code. What was I doing here? Why did I stop? And if you did the last stretch of work with an AI coding agent, it is even worse, because all the context you built up lives in a chat window that is gone forever. I used to deal with that pain by restarting. Re-read everything, re-figure out the plan, re-do a little thinking that had already been done. It burned hours every single time. Then I started keeping one file at the root of every project, and it changed how I build. It also changed how I use AI, for the better.