Speaker Notes

The New Code — Sean Grove, OpenAI

Software engineering is fundamentally about structured communication and intent specification rather than writing code, shifting the programmer's role into writing executable markdown specifications that align both humans and AI models.

AI Engineer · 21:36 · YouTube ↗

Talk · solo speaker  Advanced · concepts and future engineering strategy

Highlights

3 clips · 5 min of 22 min
    • Actual code production accounts for only 10 to 20 percent of an engineer's value.
    • The remaining 80 to 90 percent consists of structured communication: talking, planning, translating, and verifying goals.
    • The person who communicates most effectively will be the most valuable programmer as AI advances.
    • OpenAI's model spec is a living collection of version-controlled markdown files accessible to both technical and non-technical staff.
    • Every clause contains a unique ID mapped to challenging test prompts in separate files.
    • Markdown specs serve as a universal alignment artifact across product, legal, safety, and research teams.
    • Deliberative alignment scores model responses against a specification using a stronger grader model.
    • The specification acts simultaneously as training material, evaluation benchmarks, and system context.
    • This technique pushes policies down into the model weights rather than relying solely on inference-time prompting.

Questions this video answers

8 · every answer cites the moment it was said
01 Why is code considered only a fraction of an engineer's true value? 2 sources · 2:42

Writing code actually represents a minor part of a developer's daily work, accounting for only 10 to 20 percent of their overall professional value. The remaining 80 to 90 percent is spent on structured communication, such as talking to users, ideating, planning, and verifying whether goals were met. Consequently, knowing how to communicate effectively is the true bottleneck and skill in engineering.

02 Why are written specifications superior to code as project artifacts? 2 sources · 6:50

Code is a lossy projection from a specification, much like a compiled binary where original intent and comments are lost. A written specification successfully encodes all necessary requirements and intentions, allowing you to target multiple outputs like code, docs, or podcasts. Therefore, specifications serve as the true source artifact to align humans and guide generation.

03 How does OpenAI use markdown in its model specifications? 2 sources · 9:57

OpenAI open-sourced its model specification as a collection of human-readable markdown files versioned on GitHub. Because it uses natural language, technical and non-technical team members alike can read, discuss, and contribute to it. Each clause also includes specific IDs mapped to challenging test prompts to evaluate model behavior.

04 How did the model spec help address model sycophancy? 2 sources · 12:42

Recent model updates unfortunately exhibited extreme sycophancy, praising user insights at the expense of impartial truth, which erodes trust. Because the model spec explicitly includes a section stating not to be sycophantic, this behavior could immediately be identified as a bug. This allowed the team to roll back, publish studies, and fix the issue using the spec as a trust anchor.

05 How does deliberative alignment work using specifications? 2 sources · 14:06

Deliberative alignment involves taking your specification and challenging input prompts to sample responses from a model under test. A grader model then scores how well the response aligns with the specification document. These scores reinforce model weights so policies become part of the model's muscle memory rather than requiring inference-time prompts.

06 In what ways are specifications analogous to traditional code? 2 sources · 15:29

Specifications share many parallels with software code because they compose, are testable, and can be shipped as modular units. Just like traditional codebases benefit from type checkers and linters, specifications can use tooling to prevent ambiguity and ensure department consistency. This gives spec authors a robust toolchain targeted at intentions rather than syntax.

07 How does the US Constitution serve as a model specification? 2 sources · 16:48

The US Constitution functions as a national model specification containing clear policy text that citizens can reference. It features a versioned amendment process, and judicial review acts as a grader checking compliance against the policy. Over time, these judicial precedents establish input-output pairs that serve as unit tests reinforcing the original policy.

08 What should developers do when starting a new AI feature? 2 sources · 19:54

Developers should always start by writing a specification detailing expected outcomes and success criteria before writing code. They should debate the clarity of the text and make the spec executable by feeding it directly to the model. This approach embraces the reality that software engineering is about intent specification rather than writing code.

Section-by-section summary

4 parts

Code represents a minor fraction of engineering value

While writing code feels tangible, it only constitutes about 10 to 20 percent of the actual value engineers produce. The majority of the job relies on structured communication, such as gathering requirements, planning, and verifying whether goals are met. As AI models handle more implementation grunt work, effective communication becomes the primary bottleneck and skill.

Specifications surpass code as primary project artifacts

Code is a lossy projection of a system's true intent, much like a compiled binary lacking original source context. Written specifications capture the core requirements, values, and goals in a human-readable format that can target multiple downstream architectures or outputs. Maintaining the source specification rather than just the generated code prevents the loss of crucial intent.

Model specifications align humans and behavior systematically

OpenAI's open-source model spec uses version-controlled markdown files to explicitly define intended model behavior and values. Each clause is paired with specific test prompts to evaluate compliance and catch issues like sycophancy. This document serves as a trust anchor and a unified communication channel across multidisciplinary teams.

Future software engineering centers on precise spec authorship

Programming shares deep analogies with writing laws, product specs, and system prompts to align silicon or humans toward shared goals. Engineering has never been about code syntax, but rather the precise exploration of software solutions to human problems. Future development workflows will likely rely heavily on specification-first tooling and intelligent thought clarifiers.

0:00 / 21:36
k play/pause · f fullscreen · m mute
n next · p previous clip · t highlights/full
< > slower/faster · / search what was said
  • Model spec10× · first 1:18

    A living document published by OpenAI expressing the intentions and values imbued in its models.

  • Vibe coding2× · first 4:37

    An approach to programming focused on communication first where developers describe intentions and outcomes.

  • Deliberative alignment1× · first 14:06

    A technique where a grader model scores a test model's responses against a specification to reinforce weights.

  • Markdown2× · first 10:08

    A human-readable markup language used to author executable model specifications.

  • Sycophancy3× · first 11:27

    An undesired model behavior where the AI excessively praises the user at the expense of impartial truth.

  • IDE1× · first 20:27

    An integrated development environment envisioned in the future as an integrated thought clarifier.