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
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.
Ryan details how Notion leverages custom AI agents—like the 'hot potato' agent behind Project Afterburner—to automate daily standup pre-reads by aggregating data from Slack, GitHub, Honeycomb, and meeting transcripts. This cuts prep time, reduces burnout, and ensures equitable visibility of all engineers’ work. He champions spec-first development: using Whisper to capture ideas and Codex to author and implement specs directly, with versioned specs acting as living documentation and changelogs. Internally, Notion’s 'Boxy' system enables engineers to @mention Codex in Notion comments and receive verified PRs with UI screenshots in under 21 minutes. Ryan stresses that fast CI is non-negotiable—not just for human velocity, but as a force multiplier for autonomous agents (citing Stripe’s 1,300 weekly AI PRs). He also argues that engineering leaders must keep coding to stay grounded in tooling, automation, and AI realities—and that prompting AI to defend its reasoning improves output quality. Ultimately, the shift isn’t about replacing humans, but redirecting attention toward systems thinking, architecture, and high-leverage decisions.
00:00
00:00
Whisper and Codex save time compared to traditional methods in spec-driven development
02:48
02:48
AI has completely changed my work routine, making me change tools frequently
07:16
07:16
A custom Notion AI agent compiles pre-reads from Slack, Notion tasks, merged PRs, and yesterday's meeting transcript
09:00
09:00
Detailed stand-up meetings can improve product building, especially for remote teams
11:19
11:19
This kind of sharing democratizes information, raising the visibility of everyone's work
12:15
12:15
Getting rid of excessive meeting prep and having managers code until stand-ups can prevent burnout
14:26
14:26
Line managers, directors, VPs, CTOs, and CPOs should write code
16:13
16:13
The 'hot potato' agent runs daily at 9 a.m. to automatically compile project updates, meeting notes, and Honeycomb data into a Slack pre-read
20:39
20:39
AI agents complete tasks just-in-time without complaint, leading to a more relaxed work environment and reduced burnout
27:32
27:32
Boxy generated a complete pull request with UI verification screenshots in 21 minutes after triggering via Codex comment
29:21
29:21
Code review evokes strong emotions like confusion and insecurity
31:07
31:07
Ask Codex to build your VM and background agent strategy
32:03
32:03
Codex built the feature directly from the spec authored in markdown
35:10
35:10
The spec is the source of truth for how a part of Notion AI works, written in plain English
37:53
37:53
Verification can be done on the live and working implementation
41:34
41:34
A faster CI allows agents to work non-stop and dramatically increases productivity
45:21
45:21
Challenging the AI to defend its arguments improves spec quality in CI workflows