Manifesto-style article by **Thariq Shihipar** (Engineer & serial entrepreneur, Claude Code team at Anthropic) announcing a **change in the default output format for agents**: replacing **Markdown with HTML**. Thesis: Markdown has been the dominant format between humans and agents (simple, portable, editable, readable) but has become **a bottleneck** as agents produce longer and richer artifacts (specs, plans, reports, code review). Beyond ~100 lines, no one reads a Markdown file anymore. HTML solves six limitations simultaneously: **information density** (tables, CSS, SVG, scripts, canvas, images), **visual clarity** (navigable, mobile-responsive layout), **ease of sharing** (an S3 link directly openable in a browser), **two-way interactivity** (sliders, knobs, "copy as JSON/prompt" buttons to loop back into Claude Code), **native contextual ingestion** (Claude Code reads the codebase + MCP Slack/Linear + git history + Chrome) and **enjoyment** (the author explicitly claims *"it's joyful"*). Five canonical uses detailed: (1) **specs/plans/exploration** in a comparative grid, (2) **PR review** with inline annotated diff, (3) **design & prototypes** with animation sliders, (4) **reports/research/learning** (the author had a prompt-caching explainer generated from git history), (5) **custom throwaway editors** (drag-and-drop of Linear tickets, feature-flag editors, side-by-side prompt-tuner) that produce a re-injectable "copy as markdown/diff/JSON" export. Explicit anti-pattern: *"I'm a little bit afraid that people will read this article and turn it into a /html skill"* — the author **rejects premature skill-ification**, recommending prompting from scratch ("make a HTML file"). Pragmatic FAQ: token cost absorbed by **Opus 4.7**'s 1MM context, 2-4× longer generation, noisy HTML diffs (a real downside), style kept in check via a reference HTML design system.
#HTML#Markdown#output format
Thariq Shihipar (Engineer & serial entrepreneur, équipe Claude Code chez Anthropic — site : thariqs.github.io/html-effectiveness ; X : @trq212)
Doctrinal article by Addy Osmani (Google) that establishes a foundational distinction for the 2026 debate on AI and cognition: **Cognitive Offloading** (healthy — delegating the *how* while retaining judgment over results) vs **Cognitive Surrender** (toxic — accepting AI output wholesale without forming parallel reasoning, *"borrowing the model's confidence as substitute for personal understanding"*). Solid scientific grounding: the **Shaw & Nave (Wharton/UPenn)** study of 1,372 participants — **73% accept demonstrably wrong AI answers**, with confidence rising despite a 50% error rate. **MIT *Your Brain on ChatGPT*** — reduced neural connectivity among AI-assisted writers. **Anthropic Skill-Formation** — engineers using AI to generate code score **17% lower** on comprehension versus those using it for conceptual inquiry. Four concrete examples of surrender (reviewing 600-line PRs on surface signals, shallow debugging, architectural decisions made without reasoning, degraded learning). Five personal heuristics (pre-generating expectations, junior-engineer-standard review, adversarial prompting, fatigue awareness, verification of the source of confidence). Six structural guardrails (verification exit criteria, anti-rationalization tables, **PRs ~100 lines max**, interrogative over generative mode, scaffolded friction, **regular solo keyboard time**). Two new concepts: ***Comprehension Debt*** (the growing gap between total codebase volume and human understanding) and ***Mutual Amplification*** (a cooperative prompt-refine loop vs surrender-delegation). Pivot thesis: ***"the choice between thinking with AI versus not thinking at all remains entirely human"***. A structural and operational counterweight to *"coding is solved"* (Cherny 2026-05) and an analytical complement to Frizzo (2026-05-05).
Addy Osmani (Software Engineer at Google, Cloud + Gemini, ex-Chrome — déjà au dossier veille avec *Agent Harness Engineering* 2026-04-19, *How to write a good spec for AI agents* 2026-01-13, *Conductors to Orchestrators* 2025-11-01).