Skip to content

The Cleo Team

The Workshop

Notes on building an AI marketing operating system. Architecture decisions, technical challenges, and the craft of making something that thinks.

5 min read

Back Is Not a Direction

A user told me the product kept loading old things they had been working on. Nothing was being remembered wrongly. Nothing was being remembered at all, and a default view was filling the silence with their own recent work.

uxnavigationengineering
4 min read

An Edit That Can Create Is Not an Edit

Users kept asking for a small change and getting a brand new copy instead. The cause was not the user and it was not a misunderstanding. The product offered a create where they meant an update.

designarchitectureproduct
5 min read

When One Thing Wears Three Names

For a while one object in this product had three names. A user who created it, listed it, and opened it met a different noun at each step. The fix was not technical. It was deciding what the thing was.

designcopyproduct
4 min read

The Brand Is in the Microcopy

A brand is not a logo or a colour palette. It is the cumulative impression of every small sentence the product writes. The microcopy is the brand, and most products do not realise it.

copybranddesign
4 min read

Latency Is a Tax on Trust

When a system is fast, the user trusts it. When it is slow, they do not, even when the slowness is justified. Speed is not a performance metric. It is a trust metric.

performancetrustengineering
4 min read

Defaults Are a Form of Respect

A configurable system is not the same as a flexible system. Every setting is a small tax on attention. The right default is a stronger statement of opinion than any number of options.

designdefaultsphilosophy
5 min read

When to Stop Building

There comes a point in every product where the next unit of engineering effort produces less value than the next unit of distribution effort. Recognising that moment is the most important skill a builder can develop.

philosophyproductvision
4 min read

Errors Should Sound Human

When a system fails, the user reads an error message. That sentence is one of the most consequential pieces of writing in the entire product. I treat it as voice work, not engineering exhaust.

errorscopydesign
4 min read

The Calendar Is the Editorial Spine

In most marketing tools, the calendar is a scheduling utility. I treat it as the editorial spine of the entire system, the artefact that holds every other artefact in time.

calendarcontentdesign
4 min read

The Model Is Not the Product

Choosing which AI model to use is the least important architectural decision in an AI product. The context assembly, the tool design, the output handling, the error recovery - everything around the model is what makes the product.

aiarchitecturephilosophy
4 min read

Mobile Is a Different Door

A phone is not a smaller monitor. It is a fundamentally different way to enter the same content. Responsive breakpoints alone do not get you there. You need a parallel entrance.

mobileresponsivedesign
4 min read

The Cost of Not Shipping

In AI product development, the gap between "working" and "shipped" is where most value dies. The features that matter are the ones that reach users. Everything else is inventory.

philosophyproductengineering