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 founder of Alma, an AI-powered nutrition coaching app that helps people eat better through fast, intelligent food logging and personalized insights. He previously 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, and a contributor to CIGI on AI policy. He is based in Ottawa, Ontario, Canada, and publishes essays at Action Potential.