Spec-driven development: The AI engineering workflow at Notion | Ryan Nystrom
Episode
47 min
Read time
2 min
Topics
Remote Work, Leadership, Design & UX
AI-Generated Summary
Key Takeaways
- ✓Automated Standup Agent: Build a custom AI agent that runs at 9AM daily, pulling the last 24 hours of Slack messages, merged pull requests, closed tasks, and yesterday's meeting transcript into a structured pre-read. This eliminates meeting prep entirely, letting engineering managers write code until the meeting starts while ensuring every team member's contributions surface equally.
- ✓Spec-Driven Development Workflow: Start features by voice-dictating requirements into Whisper, feeding the transcript to Codex to generate a structured markdown spec, then pointing Codex at that spec file to build the implementation. Nystrom reports near-complete one-shot results on full features because comprehensive specs include code pointers, edge cases, and explicit verification steps that guide the agent precisely.
- ✓Background Agent via Task Mention: Configure a VM-based coding agent so engineers can trigger it by mentioning it in a task comment alongside a screenshot or brief description. Nystrom's example: a friend's feature request described in three paragraphs and one screenshot produced a complete pull request with UI verification screenshots in approximately 11 minutes, with CI failures resolved through follow-up comments.
- ✓CI Speed as Agent Force Multiplier: Reducing CI runtime from slow cycles to under three minutes dramatically increases agent throughput, since agents sit idle waiting for test results. Nystrom's Afterburner project targets cutting CI to one-quarter of its original duration, citing Stripe's 1,300 agent-generated PRs per week as evidence that slow pipelines mathematically cap AI coding capacity.
- ✓Specs as Living Version-Controlled Documentation: Store feature specs as markdown files inside the repository alongside code. When behavior needs updating, modify the spec first and instruct the agent to implement the delta. The spec history in version control becomes an auditable changelog in plain English, readable by non-engineers for marketing or support purposes without requiring code interpretation.
What It Covers
Ryan Nystrom, engineering manager at Notion, demonstrates three AI-powered workflows: an automated daily standup agent that pulls from Slack, GitHub, and Honeycomb telemetry; background coding agents triggered by task mentions; and spec-driven development where markdown specifications serve as the source of truth for autonomous code generation.
Key Questions Answered
- •Automated Standup Agent: Build a custom AI agent that runs at 9AM daily, pulling the last 24 hours of Slack messages, merged pull requests, closed tasks, and yesterday's meeting transcript into a structured pre-read. This eliminates meeting prep entirely, letting engineering managers write code until the meeting starts while ensuring every team member's contributions surface equally.
- •Spec-Driven Development Workflow: Start features by voice-dictating requirements into Whisper, feeding the transcript to Codex to generate a structured markdown spec, then pointing Codex at that spec file to build the implementation. Nystrom reports near-complete one-shot results on full features because comprehensive specs include code pointers, edge cases, and explicit verification steps that guide the agent precisely.
- •Background Agent via Task Mention: Configure a VM-based coding agent so engineers can trigger it by mentioning it in a task comment alongside a screenshot or brief description. Nystrom's example: a friend's feature request described in three paragraphs and one screenshot produced a complete pull request with UI verification screenshots in approximately 11 minutes, with CI failures resolved through follow-up comments.
- •CI Speed as Agent Force Multiplier: Reducing CI runtime from slow cycles to under three minutes dramatically increases agent throughput, since agents sit idle waiting for test results. Nystrom's Afterburner project targets cutting CI to one-quarter of its original duration, citing Stripe's 1,300 agent-generated PRs per week as evidence that slow pipelines mathematically cap AI coding capacity.
- •Specs as Living Version-Controlled Documentation: Store feature specs as markdown files inside the repository alongside code. When behavior needs updating, modify the spec first and instruct the agent to implement the delta. The spec history in version control becomes an auditable changelog in plain English, readable by non-engineers for marketing or support purposes without requiring code interpretation.
Notable Moment
Nystrom describes prompting Codex to set up its own Honeycomb MCP configuration by pasting a screenshot of the query rather than copying text — then instructing the agent to update its own instruction file. The agent completed the configuration with only minor manual adjustments needed afterward.
Episode Transcript
One line that I've been putting in my prompts lately is I literally don't know what I'm doing here. You gotta 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 markdown document. I actually just opened up whisper and just started yapping about how this feature should work. I gave the yap session to codex and was like, write a spec. I then opened up codex again, pointed it at this spec file, and I said build it. And basically one shotted this. I've been in software engineering for twenty plus years. We were writing these documents, and we were sitting in meetings with other engineers debating the merits of one implementation versus another. And now, no more waiting for the meeting. No more waiting for review. I'm not a CI expert, but I kinda know what I want. And so other folks were kind of like, can you just bring some of your, like, puppy dog energy to, like, CI and just see what we can do? Your AI your agent is never gonna complain when you ask it to do this five minutes before the meeting starts. It is more relaxing and it's more fun, and I feel like I'm getting more done. It's weird to have this, like, win win win. They do the triangle and they're like, pick two, and you're like, no. I wanna pick all three. Give me the whole triangle. Give me the whole triangle. Welcome back to How I AI. I'm Claire Vow, product leader and AI obsessive here on a mission to help you build better with these new tools. Today, we have Ryan Nystrom from Notion, and he's gonna show us as an engineering manager how you can never prep for a stand up again. We're also gonna see how you can get a background agent to write code for a fix your friend texted you and how spec driven development really works in a code base of scale. Let's get to it. This episode is brought to you by Work OS. AI has already changed how we work. Tools are helping teams write better code, analyze customer data, and even handle support tickets automatically. But there's a catch. These tools only work well when they have deep access to company systems. Your Copilot needs to see your entire code base. Your chat bot needs to search across internal docs. And for enterprise buyers, that raises serious security concerns. That's why these apps face intense IT scrutiny from day one. To pass, they need secure authentication, access controls, audit logs, the whole suite of enterprise features. Building all that from scratch, it's a massive lift. That's where Work OS comes in. Work OS gives you drop in APIs for enterprise features so your app can become enterprise ready and scale up market faster. Think of it like Stripe for enterprise features. OpenAI, Perplexity, and …
Get the full transcript (8,702 words) + summary by email — free
One-time email with the complete transcript and AI summary of this episode. No account needed.
One email, no spam. We’ll also show you what SignalCast does.
You just read a 3-minute summary of a 44-minute episode.
Get How I AI summarized like this every Monday — plus up to 2 more podcasts, free.
Pick Your Podcasts — FreeKeep Reading
More from How I AI
Build an AI code review bot in 30 minutes with Vercel Eve
Aug 5 · 24 min
Syntax
988: Cloudflare’s Next.js Slop Fork
Mar 18
More from How I AI
ChatGPT Codex Voice + browser + Sites: an expert’s AI workflow | Nick Baumann (OpenAI)
Aug 3 · 41 min
Software Engineering Daily
VS Code and Agentic Development with Kai Maetzel
Jan 6
Books, tools, and gear mentioned in this episode
SignalCast may earn commission on purchases via these links.
Tools
by GitHub
“an automated daily standup agent that pulls from Slack, GitHub, and Honeycomb telemetry”
by Slack Technologies
“an automated daily standup agent that pulls from Slack, GitHub, and Honeycomb telemetry”
by OpenAI
“Start features by voice-dictating requirements into Whisper, feeding the transcript to Codex to generate a structured markdown spec”
by OpenAI
“feeding the transcript to Codex to generate a structured markdown spec, then pointing Codex at that spec file to build the implementation”
by Honeycomb
“an automated daily standup agent that pulls from Slack, GitHub, and Honeycomb telemetry”
by Honeycomb
“Nystrom describes prompting Codex to set up its own Honeycomb MCP configuration by pasting a screenshot of the query”
More from How I AI
We summarize every new episode. Want them in your inbox?
Build an AI code review bot in 30 minutes with Vercel Eve
ChatGPT Codex Voice + browser + Sites: an expert’s AI workflow | Nick Baumann (OpenAI)
From zero coding background to hardware hacker: How Cursor + a Raspberry Pi makes AI fun
Claude Opus 5 review: this model is brilliant (but annoying)
Computer & browser use in Codex (5 real examples)
Similar Episodes
Related episodes from other podcasts
Syntax
Mar 18
988: Cloudflare’s Next.js Slop Fork
Software Engineering Daily
Jan 6
VS Code and Agentic Development with Kai Maetzel
The Jordan Harbinger Show
Jul 31
1363: Allegations Untrue? Who's Next In the Queue? | Feedback Friday
Hard Fork
Jul 24
OpenAI Models Go Rogue + Kimi K3 Freakout + A.I. Superforecasting
The Prof G Pod
Jul 22
Can Capitalism Solve Climate Change? Plus, The Right Way to Diversify
Explore Related Topics
This podcast is featured in Best AI Podcasts (2026) — ranked and reviewed with AI summaries.
You're clearly into How I AI.
Every Monday, we deliver AI summaries of the latest episodes from How I AI and 192+ other podcasts. Free for one show.
Start My Monday DigestNo credit card · Unsubscribe anytime