Statewave Guide
The Journey Index
We're building a help chat that actually understands the product — by reading the codebase, not a wiki — and we're showing the whole build, including the parts that didn't work. Every episode lands here, in order.
Episodes
Follow the build
Get each new Statewave Guide post by email.
Along with occasional Statewave updates. Unsubscribe anytime — privacy.
What is Statewave Guide?
An AI help system with Statewave underneath. It works only from the program code and its comments, and from that alone it takes a visitor straight to what they are trying to do — pointing at the right control, explaining it, and walking them through the task. It is built to replace manuals and tutorial videos, not to sit beside them.
Why is this series written after the build?
Because the code is ahead of the story. Every build day is already a commit in the public repository, and it shows how the project ended. The posts are about why each step went the way it did — nearly every day ended with something we got wrong, and a rule we took away from it.
The running threads
Every episode advances at least one of these.
#source-of-truth
The code as documentation — routes, forms, schemas and git history read as product knowledge.
#memory
The assistant remembering the user across sessions, so it stops explaining the same thing twice.
#guidance
Actually pointing at things inside the live UI, rather than describing where they are.
#trust
Permissions, being wrong, and the things it must never do.