Why this Claude Code engineer uses HTML files as AI specs | Thariq Shihipar (Anthropic)

By How I AI Podcast

Categories: AI, Product

Summary

HTML is replacing markdown as the standard for AI agent specs because it's more readable and scrollable for humans—but the real insight is that you're now a "compute allocator" deciding whether to spend $500/hour on Claude's reasoning, making detailed specs and PRDs more critical than ever.

Key Takeaways

  1. HTML specs are superior to markdown for AI interaction because models render richer visual information without forcing workarounds, making plans more scannable and actionable for human-in-the-loop oversight.
  2. When Claude runs for 8 hours, you're spending ~$500 in compute costs—shift your mindset from "let AI figure it out" to actively allocating resources by writing detailed specs upfront to prevent wasted inference cycles.
  3. Plans and specs remain non-negotiable even as models improve because they force you to define success criteria and unknowns before expensive compute runs—unclear specs directly translate to wasted tokens.
  4. Stop reading thousand-line markdown plans manually and asking Claude to edit them instead—instead, use HTML to create interactive, visually rich specs that remain genuinely readable for human review and iteration.
  5. Product management hasn't died with AI agents—it's evolved into compute allocation: deciding what problems are worth spending inference budget on, which happens entirely in the planning phase.

Topics

Transcript Excerpt

Markdown became a really popular way of interacting with agents, but the plans are so long, I honestly have stopped reading them. And this was honestly a mistake. I think that you still need to be really in the loop. >> Plans matter, PRDs matter, spec matters. >> When you say, okay, cloud can run for 8 hours. What you're really saying is cloud can spend 500 bucks. All of us are becoming these compute allocators now, right? And so you have to decide what is worthwhile spending the compute on. >> People ask me all the time, Claire, you said product management is dead. What's next? >> [music] >> I'm going to say you're a compute allocator babe that's the job now >> HTML is a lot easier to read and so it's just a richer communication medium between you and quant >> instead of saying here's a m…