The Best Way to Talk to Your AI Agents

The debate over whether to use Markdown or HTML for AI agent communication highlights a fundamental shift in knowledge work, where humans increasingly act as managers staging conditions for agents rather than direct producers. While Markdown remains a standard for its simplicity, proponents of HTML argue it offers superior information density, visual clarity, and interactivity, enabling better representation of complex specifications and diagrams. Critics caution that HTML increases token usage, yet the optimal format often depends on the project's audience, lifecycle, and duration. Ultimately, this transition reflects the need for new frameworks to manage "mixed doneness" in projects, where some elements are locked while others remain exploratory. Using native HTML features like tabs and visual hierarchy allows for more effective calibration of agent tasks, helping users navigate the liminal space between initial brainstorming and final execution.