4 karma · joined June 29, 2026
I knew the context.md file, but read how big and cumbersome that file can get, and that as memory fills in a session, more of that context can be left behind. My project wasn’t about speed; I knew I would need a way to pass the latest session details - status, open items, decisions made in session, etc - to the next agent in a new clear session. That was the thinking behind a session state doc.
I created those two docs outside of claude.md, with session.md living in each project directory, and working_with_me.md available in the claude root directory.
My starting instructions are for the agent to read those docs - plus other project info, and my ending instructions are to update working_with_me and handoff.md. If mid-sessions something is lost - like the agent gets sycophantic, I’ll stop and dig into that, trying to understand how context was lost and how to firm up the point.
Let me know what you think, or what I’m missing.
With claude, we built an iOS app for a personal need - pre-scan and score QR codes before the phone acts. I thought it would just be for me, but with encouragement from friends, it is now more fully featured and polished and under review in the app store.
I used claude code 4.8 and followed a structured and linear process, not unlike how I would work with an engineering team on a new product. Requirements document, tech design spec, function contracts and test plans, etc. No agents, just me and claude discussing design and iterating through the steps across ~3 months. Some may say vibe coded but I don't like that term. It doesn't really capture the level of structure and process required for a non-programmer to get quality output.
Has it allowed me to build something I could not have? Absolutely and it's been a wonderful learning experience.
What have I learned that might be helpful? Something I learned in a programming course years ago - garbage in, garbage out. In other words, the better instruction you provide (an agent or a human counterpart) and the more discussion to tease out issues before a line of code is written, the better.
I've also found a "working_with_me" file and a specific "project_handoff" file help maintain state session over session.
If you get enough comments, I'd love to see a roll up report on how HN is using AI. Otherwise.... #subscribed.