Anthropic: HTML Replaces Markdown for Claude Code

Thariq Shihipar, an engineer at Anthropic, has spent several months experimenting with the use of HTML to replace Markdown in the planning and implementation workflows within the Claude Code team. This approach aims to enrich visual formats, thereby increasing human engagement and the quality of final products.

During the Code with Claude event in San Francisco, Shihipar demonstrated how HTML can be used to create interactive plans and temporary user interfaces, addressing specific issues while maintaining living design systems that accompany the code.

HTML: A New Tool for AI Communication

HTML was chosen by Shihipar as the preferred format for communication and planning of AI agents. Unlike Markdown, HTML allows for the creation of visual mockups and interactive demos, replacing simple text lists with more engaging interfaces.

Shihipar explains that "complexity must justify its existence," and HTML helps to stay informed without imposing excessive constraints on Claude, the AI agent. A specific prompting technique allows Claude the necessary flexibility while ensuring the desired outcomes are achieved.

Temporary Interfaces and Living Design Systems

Shihipar showcased how to build temporary micro-user interfaces in HTML to edit specific parts of plans. These interfaces help maintain living design systems that reside in code repositories, accompanying each project and facilitating communication between teams.

Development Philosophy and Techniques

Shihipar's approach includes a prompting philosophy that gives Claude the necessary flexibility while ensuring the desired results are achieved. The mindset of the compute allocator and the abundance mindset are also key concepts explored in this approach.

Shihipar emphasizes that 99% of the tokens generated by the AI should be dedicated to planning, interfaces, and communication, rather than production code. This approach highlights the importance of visual and interactive communication in AI product development.

Towards a Future of Technical Specifications in HTML

The event also explored the future of PRDs (Product Requirements Documents) and technical specifications, focusing on the creation of editable and interactive HTML documents. The use of plans as artifacts for implementation was emphasized, along with the addition of comments and annotations to HTML plans.

In conclusion, Anthropic's adoption of HTML for planning and communication in AI projects could mark a turning point in development practices, making processes more dynamic and interactive.