Notion Transforms AI Engineering with Specifications

⚡

Key Takeaways

1Ryan Nystrom, an engineer at Notion, played a key role in the development of Notion AI and Custom Agents.

2The Afterburner project aims to drastically reduce continuous integration time at Notion.

3Notion employs an innovative workflow based on specifications to automate and optimize software development.

💡Why it matters — Notion's approach could transform software development practices, making processes more efficient and less prone to burnout.

Ryan Nystrom: A Key Player at Notion

Ryan Nystrom, a renowned software engineer, joined Notion in December 2024 after the company acquired Campsite, a team communication platform he co-founded with Brian Lovin. Since his arrival, Nystrom has been a cornerstone in the development of Notion AI as well as in the creation of the Custom Agents feature, launched in February 2026. In addition to leading a team of six to seven engineers, he continues to contribute directly to the code, particularly through the Afterburner project. This ambitious project aims to reduce Notion's continuous integration (CI) time to a quarter of its current duration, thereby optimizing development processes.

Learning to Create Custom Agents

Notion AI offers powerful tools to automate complex tasks. For instance, it is possible to create a custom agent that automatically generates a daily pre-read for standup meetings. This agent pulls information from various sources such as Slack, GitHub, Honeycomb metrics, and previous meeting notes. Additionally, Notion AI allows for the configuration of sub-agents and MCP integrations, facilitating smooth and centralized data management.

The "Boxy" System and Task Automation

Notion's internal system, nicknamed "Boxy," allows engineers to mention Codex in Notion comments. In just 20 minutes, this generates a complete pull request with screenshots. This process significantly accelerates development by automating tasks that would otherwise require a lot of time and manual effort.

An Innovative Development Workflow

Specification-based development at Notion relies on an innovative workflow. Ideas are first dictated into Whisper, an OpenAI voice transcription tool. Then, Codex formats these ideas into appropriate specifications, commits them to the repository, and the agent implements and verifies them autonomously. This process not only reduces development time but also improves the accuracy and consistency of projects.

The Importance of Fast CI

In the context of AI coding agents, fast CI is crucial. It allows for quick testing and deployment of changes, which is essential for maintaining the efficiency and responsiveness of development teams. Notion emphasizes the importance of this process, highlighting that rapid iterations can make the difference between a successful project and a stagnant one.

Encouraging AI Agents to Justify Their Decisions

An interesting aspect of development at Notion is the encouragement for AI coding agents to defend their reasoning in the face of objections. This ensures that the decisions made by the agents are well-founded and aligned with project goals. This proactive approach minimizes errors and improves the quality of the produced code.

The Role of Technical Managers in Coding

Notion advocates that technical managers, and even senior executives, should continue to write code. This practice allows leaders to stay connected to daily technical challenges and better understand their teams' needs. It also fosters a culture of innovation and continuous improvement within the company.

The Afterburner Project and Its Implications

The Afterburner project, led by Ryan Nystrom, is a strategic effort to reduce Notion's CI time to a quarter of its current duration. This project aims to optimize development processes by making continuous integrations faster and more efficient. By reducing the time needed to test and deploy changes, Notion hopes to enhance productivity and alleviate stress for development teams.

The Evolution of Engineer Roles

At Notion, the roles of engineers are evolving with the integration of AI into development. Engineers are encouraged to adopt new skills and adapt to automated workflows. This evolution allows engineers to focus on higher-value tasks while leaving repetitive tasks to AI agents.

Conclusion

Notion's approach to specification-based development and the integration of AI into development processes represents a significant advancement in the field of software engineering. By automating repetitive tasks and optimizing workflows, Notion enables its teams to focus on innovation and continuous improvement while reducing the risk of burnout.