Spec-driven development: The AI engineering workflow at Notion | Ryan Nystrom
How I AI
2 DAYS AGO
Spec-driven development: The AI engineering workflow at Notion | Ryan Nystrom
Spec-driven development: The AI engineering workflow at Notion | Ryan Nystrom

How I AI
2 DAYS AGO
Shownote
Shownote
Ryan Nystrom is a software engineer at Notion. He joined in December 2024 after Notion acquired Campsite, the team communication platform he co-founded with Brian Lovin. At Notion, he’s been a core builder of Notion AI and the Custom Agents feature launche...
Highlights
Highlights
Ryan Nystrom, a software engineer and engineering manager at Notion, shares firsthand insights into how AI is transforming engineering workflows—not just as a productivity tool, but as a fundamental rethinking of collaboration, code review, specification, and leadership.
Chapters
Chapters
Introduction to Ryan Nystrom
00:00How AI has upended 12+ years of the same working routine
02:48Project Afterburner: Notion’s push to cut CI time to a quarter
04:30Why high-frequency, high-quality meetings beat lower-frequency standups
09:00How automated context surfaces every engineer’s work equally
11:10Why cutting meeting prep is a burnout protection mechanism
12:15The case for engineering managers writing code
14:26Inside “Boxy”: Notion’s internal VM-based background agent system
16:13Old World vs. New World code review
20:30Prompting Codex from Notion comments
24:51The emotions around code review
29:20Quick recap
31:01Spec-first development: writing and checking agent specs into the repo
32:00The spec as changelog: version control for how a feature actually works
35:10How engineers’ roles are evolving
37:53Lightning round
39:00Where to find Ryan
45:21Transcript
Transcript
Ryan Nystrom: One line that I've been putting in my prompts lately is I literally don't know what I'm doing here. You got to explain it like, I'm a five-year-old. I didn't start with writing code. I didn't start with anything. I just started with an empty ...