What jumped out at me is how ordinary the underlying problem is, and how much ceremony the author builds around it. The basic complaint is fair: terminal output is a lousy medium for anything nuanced, and once an agent starts giving you multi-step reasoning, test results, or implementation notes, plain text gets tiring fast. But I’m not convinced the leap from “terminal text is awkward” to “HTML files fix this” is as universal as the article makes it sound.
If I were doing this day to day, I’d probably try a narrower version first: force the agent to write a compact, structured report when the task is review-heavy, not every time it says anything interesting. That feels more realistic than the author’s almost total migration to HTML. Asking for HTML 90–95% of the time sounds like the kind of habit that works for one person’s workflow because they’ve wrapped a lot of tooling around it. It also depends on having a browser split open, a user-level instruction file, and apparently a custom “superset” setup. That’s not a general technique so much as a personalized operating system.
The part I do buy is the deeper point about agent communication being an interface problem, not just a prompt problem. Claude Code and similar tools are often treated like they’re only about better reasoning, but a lot of the pain is really in presentation: where the answer appears, how much irrelevant text comes with it, and whether you can skim it without mentally parsing a wall of prose. The author is basically saying, “Stop pretending the terminal is neutral.” That’s right. It isn’t neutral. It privileges dense text and makes structure expensive.
Where I start to get skeptical is the confidence around “better for the human brain” and “5x.” Maybe for this author, sure. But that claim feels mostly anecdotal. HTML can absolutely help when there’s a lot to inspect, especially if the agent is reporting on tests, pages, screenshots, or a pipeline with multiple branches. Still, HTML is not automatically clearer. Badly structured HTML is just prettier clutter. And if the agent is already confused, giving it a nicer canvas doesn’t solve the confusion. It can even hide it.
The diagram angle is more convincing to me than the blanket HTML enthusiasm. For system understanding, a diagram is often the right artifact. If I’m tracing upload handling, OCR, classification, or other pipeline steps, a visual representation can expose missing branches or weird ordering much faster than a transcript ever could. That part feels like an actually useful habit, not just a workaround for terminal fatigue.
What I’d take from this is simpler than the article’s pitch: treat agent output like deliverables, not chat. If the task is disposable, plain text is fine. If the task needs review, testing, or explanation, ask for a format that survives skimming. HTML, Markdown, diagrams, whatever. The medium matters. I just wouldn’t dress that up as a universal productivity law.
Reference: How to 5x Your Communication Effectiveness with Claude Code | Towards Data Science