Based on my observations, creating a directory with relevant claude.md files tends to increase file count, and claude --resume already stores code-related data. Given this, I'm wondering if it might be worth considering an alternative approach — summarizing the entire code and its actions instead. From what I understand, Claude handles this through a planning process, where we define a to-do list before starting a project or idea, iterate on it until we're satisfied, and then ask it to build accordingly. With this approach in place, I'm curious whether HAM is still necessary — just wanted to share this thought for consideration, not to dismiss anything.

AI coding agents are stateless. Every new session, they re-scan your entire codebase to figure out where they are. That burns thousands of tokens before writing a single line of code. I hit this building my own products. So I built HAM. HAM gives agents scoped memory files at every directory level. Instead of re-reading everything, the agent reads a small file that says what's here, what decisions were made, and what happened last session.