Notes from Barkan

The useful support agent is not the one that keeps every conversation automated. It is the one that recognizes its limit and hands over the work without making the customer start again.

Confirm everything and users stop reading. Confirm only the goal and consent becomes dangerously broad. The useful boundary sits at the exact action that changes the world.

Signup is instrumented to death. The moment that decides retention happens later, when a user tries the real thing your product is for — and nobody is watching.

Documentation describes the product in general. The DOM describes it for this user, right now. A look inside how Barkan turns a live page into something a model can act on.

Your docs are not bad. They are in the wrong place, written at the wrong altitude, and read at the wrong moment. Here is the anatomy of the gap — and the four behaviors that close it.