TBM 439: Day At The Gig

John Cutler, starting a new job, describes how hard it is to learn a product from its notes and maps, and argues that keeping such context current deserves more attention.

John Cutler, who writes the newsletter The Beautiful Mess, recently started a new job and describes one day of learning how its product works. He works through maps, documents, meeting transcripts and tickets, and often cannot tell which of them are still current. AI tools answer his questions across these materials, but the answers are weak.

• In his experience, the maps, notes and documents that explain a product outnumber the tickets that track the work by about eight to one.
• The tickets serve the team that wrote them but not a newcomer. The code is the one definitive record of what the product does.
• He builds a map of the product's user journeys by hand, and undoes the result when he lets an AI tool extend it.
• He argues that talk of storing context, including Notion's marketing, gives too little attention to creating and preserving it. Context starts to go out of date as soon as each day ends.

A team that relies on AI tools to answer questions about its product also needs someone who keeps the underlying documents current and marks which ones still hold. This is an inference and is not the author's claim.

Derived by Working Surface from the article. Source line: always outnumber tickets 8:1.

16 September 2026: when AI helps produce work, a person still checks it before others rely on it.