Just a developer documenting what I build and discover along the way
Nothing here yet.
This is interesting because a lot of the “AI-readable” advice seems to turn into another checklist of magic ingredients, when the fundamentals still matter more. As someone who builds AI systems, the part that stood out to me was the emphasis on what the system can actually access and understand, rather than adding more metadata and hoping an AI decides to cite you. I also like the distinction around schema. It can make the structure of a page clearer without necessarily being a direct citation lever. Feels like the broader lesson is similar to building AI applications: don't optimize for what you assume the model wants. Make the underlying information accessible, structured, and genuinely useful first.
The “it works” vs. “I know why it works” part really hit home for me. I've definitely had moments where an AI-generated fix solved the immediate problem, but I couldn't fully explain why it worked. And that's usually when I end up going back through the code and digging deeper instead of just moving on. I think that's one of the weird parts of coding with AI now. It can get you past the wall incredibly fast, but if you're not careful, you can end up on the other side without actually knowing how you got there. That last line about slowing down and questioning things is probably the biggest takeaway for me too.
I think the biggest shift is that long-horizon agents make memory and state management a first-class engineering problem. A context window can remember a conversation, but it doesn't necessarily remember the work. Durable state, checkpoints, verification, and explicit progress give the agent something much more important: continuity. I also think measuring the trajectory matters just as much as measuring the final output. An agent can eventually reach the right answer while taking a completely inefficient or risky path to get there. The interesting challenge isn't giving agents more autonomy. It's building systems where autonomy remains observable, reversible, and aligned as the horizon gets longer.