← The Wire

Top 5 · 2026-04-30 · source-backed

Karpathy at Sequoia: The Spec Is the New Code, and AI Output Is 'Awkward and Gross'

Confidence
source-backed
Sources
1
Redaction
redacted

Story

Andrej Karpathy stood up at Sequoia Capital's AI Ascent 2026 and said what a lot of us have been thinking but hadn't articulated this cleanly. He called the current era "Software 3.0," defined as prompting an LLM interpreter, and declared December 2025 the tipping point when agentic coding went from "helpful but messy" to consistently correct.

Then he called AI-generated code "awkward" and "gross."

He's right. I see it every day in my own workflow. Claude Code produces working solutions that make me wince. The code runs. It passes tests. It also reads like it was written by someone who learned programming from reading every Stack Overflow answer simultaneously. Variable names that are technically descriptive but miss the intent. Abstractions that solve a problem nobody had. Correct but graceless.

Karpathy's framing is that agents are interns who need supervision on "aesthetics, judgment, taste." The specification and the plan are becoming the actual code. You write a detailed document describing what you want, and agents execute it. The document IS the program.

This maps directly to my experience shipping three products last year. The bottleneck was never writing code. It was knowing what code to write and whether the output met my standard. My design background, 20+ years of visual communications before I went full-stack, turned out to be the competitive advantage I didn't expect. I can look at a component, a function, an architecture diagram, and feel whether it's right before I can explain why.

That intuition is what Karpathy means by taste. And it's the thing agents can't do yet.

His practical advice: invest in writing better specifications. Treat your project docs, your CLAUDE.md files, your architecture decision records as first-class code. Because increasingly, they are. The agent reads the spec. The agent writes the implementation. The human evaluates craft.

If you're a builder who's been spending your learning budget on new frameworks and languages, consider redirecting some of that toward technical writing and system design documentation. The spec is the new code. The person who writes the clearest spec gets the best agent output.


Related stories

Each link below shares sources, entities, or timing with this story.

  1. Shared entities / Shared topic / What happened next

    Karpathy's CLAUDE.md Template Grows to Ten Rules

    Both cover Andrej Karpathy, Claude, Claude Code, Karpathy; overlapping topics (agent, claude, code, karpathy); picks up the Andrej Karpathy thread on 2026-06-30.

  2. Shared entities / Shared topic / Earlier coverage

    A Markdown File Got 44K Stars This Week. Skills Are the New Package Manager.

    Both cover CLAUDE, Claude Code, Karpathy, LLM; overlapping topics (agent, claude, code, karpathy, spec); earlier CLAUDE coverage from 2026-04-25.

  3. Shared entities / Shared topic / What happened next

    Karpathy Says December 2025 Was the Moment Everything Flipped

    Both cover Claude Code, December, Karpathy, LLM; overlapping topics (agent, code, karpathy, writing); picks up the Claude Code thread on 2026-05-17.

  4. Karpathy formalized "Software 3.0," and it's the most useful frame I've read this year

    Both cover Andrej Karpathy, December, Karpathy, Software; overlapping topics (agent, been, correct, karpathy, output); picks up the Andrej Karpathy thread on 2026-06-19.

  5. Shared entities / Shared topic / Earlier coverage

    The CLAUDE.md File That Ate GitHub: 56K Stars, Agent Guardrails as Config

    Both cover CLAUDE, Claude Code, Karpathy, LLM; overlapping topics (agent, architecture, claude, code); earlier CLAUDE coverage from 2026-04-18.

  6. Karpathy Documents Full Workflow Flip to Claude.

    Both cover Andrej Karpathy, CLAUDE, Karpathy, LLM; overlapping topics (claude, code, document, karpathy); earlier Andrej Karpathy coverage from 2026-03-19.

  7. Shared entities / Shared topic / What happened next

    Andrej Karpathy Joins Anthropic's Pre-Training Team

    Both cover Andrej Karpathy, Claude, Claude Code, Karpathy; overlapping topics (agent, claude, karpathy); picks up the Andrej Karpathy thread on 2026-05-20.

  8. Shared entities / Shared topic / Earlier coverage

    Karpathy's 'Second Brain' Wiki Pattern Challenges RAG Orthodoxy. 100 Articles, 400K Words, Zero Code Written.

    Both cover Andrej Karpathy, December, Karpathy, LLM; overlapping topics (code, document, karpathy); earlier Andrej Karpathy coverage from 2026-04-12.

Source trail

Entities

Provenance

AI generated
no
Story unit
2026-04-30-karpathy-at-sequoia-the-spec-is-the-new-code-and-ai-output-is-awkward-and-gross
Labels
source-backed, canonical briefing excerpt