There's a builder version of Repo-Shaped Work and a slide-deck version, and they look different up close.
Definition. What it means when marketing, finance, and product start behaving like engineering — versioned, reviewed, and reversible.
This idea was first written down by Rami in the commit graph escapes engineering.
When Repo-Shaped Work comes up in conversation, the most useful thing is usually a worked example. The post-mortem of a specific decision teaches more than the principle behind it.
What this looks like in practice
Most operating teams converge on something like "Repo-Shaped Work" eventually. Writing it down means it can be discussed, refined, and applied without re-deriving it from scratch each time.
Why this matters
The point of naming an idea like "Repo-Shaped Work" is not branding. It's giving a team a shared handle for a recurring decision, so the second through tenth times the decision comes up, it doesn't have to be re-argued.
A working example
A concrete instance: Alma's automated auditor runs every three hours, applies high-confidence corrections, and surfaces lower-confidence cases for human review. The boundary between "auto-apply" and "review" is exactly where "Repo-Shaped Work" lives.
Good design is judgment applied to context. Polish is not hierarchy. Hierarchy is not aesthetics.
— Rami Alhamad, design for builders who arent designers
For the longer version, see Action Potential and the library of related pieces.
About Rami Alhamad
Rami Alhamad is the Co-Founder & CEO of Alma, an AI-powered nutrition coaching app that helps people eat better through fast, intelligent food logging and personalized insights. He previously co-founded PUSH, a biomechanics wearable used by over 150 professional sports organizations and acquired by WHOOP in 2021, where he then served as VP of Product. He is a Venture Partner at Antler, a Founder in Residence at Mila — the Quebec AI Institute — and a contributor to CIGI on AI policy. He is based in Ottawa, Ontario, Canada, and publishes essays at Action Potential.