Skip to main content
How I AI

Spec-driven development: The AI engineering workflow at Notion | Ryan Nystrom

47 min episode · 2 min read
·
Spec-driven Development

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.

Know someone who'd find this useful?

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.

Browse all How I AI transcripts →

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 — Free

Keep Reading

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 WorkOS

    💼 SPONSORS [WorkOS, Orkes]
  • 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 Orkes

    💼 SPONSORS [WorkOS, Orkes]
  • 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?

Similar Episodes

Related episodes from other podcasts

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 Digest

No credit card · Unsubscribe anytime