# shihipar-claude-code-html-unreasonable-effectiveness-markdown-2026-05-10

## Veille

Articolo in stile manifesto di **Thariq Shihipar** (Ingegnere e imprenditore seriale, team Claude Code di Anthropic) che annuncia un **cambiamento nel formato di output predefinito per gli agenti**: la sostituzione di **Markdown con HTML**. Tesi: Markdown è stato il formato dominante tra umani e agenti (semplice, portabile, modificabile, leggibile) ma è diventato **un collo di bottiglia** man mano che gli agenti producono artefatti più lunghi e ricchi (specifiche, piani, report, code review). Oltre le ~100 righe, nessuno legge più un file Markdown. HTML risolve sei limiti contemporaneamente: **densità informativa** (tabelle, CSS, SVG, script, canvas, immagini), **chiarezza visiva** (layout navigabile, responsive per mobile), **facilità di condivisione** (un link S3 apribile direttamente nel browser), **interattività bidirezionale** (slider, manopole, pulsanti "copy as JSON/prompt" per il rientro in Claude Code), **ingestione contestuale nativa** (Claude Code legge la codebase + MCP Slack/Linear + cronologia git + Chrome) e **piacere** (l'autore afferma esplicitamente *"it's joyful"*). Cinque usi canonici approfonditi: (1) **specifiche/piani/esplorazione** in una griglia comparativa, (2) **PR review** con diff annotato inline, (3) **design e prototipi** con slider di animazione, (4) **report/ricerca/apprendimento** (l'autore ha fatto generare un explainer sul prompt caching a partire dalla cronologia git), (5) **editor usa e getta personalizzati** (drag-and-drop di ticket Linear, editor di feature flag, prompt-tuner affiancati) che producono un export "copy as markdown/diff/JSON" re-iniettabile. Anti-pattern esplicito: *"I'm a little bit afraid that people will read this article and turn it into a /html skill"* — l'autore **rifiuta la skill-ificazione prematura**, raccomandando di scrivere il prompt da zero ("make a HTML file"). FAQ pragmatica: costo in token assorbito dal contesto da 1MM di **Opus 4.7**, generazione 2-4× più lunga, diff HTML rumorosi (uno svantaggio reale), stile tenuto sotto controllo tramite un design system HTML di riferimento.

## Titre Article

Using Claude Code: The Unreasonable Effectiveness of HTML

## Date

2026-05-10

## URL

https://x.com/i/status/2052809885763747935

## Keywords

HTML, Markdown, formato di output, Claude Code, artefatti agentici, Thariq Shihipar, Anthropic, Opus 4.7, contesto da 1MM, densità informativa, SVG, CSS, canvas, layout responsive, interattività bidirezionale, copy as JSON, copy as prompt, ingestione contestuale, MCP, Slack, Linear, cronologia git, Chrome, specifiche, piani, esplorazione, code review, PR review, diff annotato, design system, prototipi, animazioni, slider, report, ricerca, explainer, editor usa e getta, editor usa e getta, feature flag, prompt tuning, piacevole, anti-skill-ificazione, prompt da zero, S3, condivisione, efficienza dei token, diff rumoroso, deriva del design, plugin di frontend design, gusto, memoria di design, html-effectiveness, galleria, playground, interazione bidirezionale, giudizio, debito di comprensione, in-the-loop, file design system, illustrazioni vs ASCII, anti-pattern colore via unicode, responsive per mobile, tab, illustrazioni, UI personalizzata usa e getta

## Authors

Thariq Shihipar (Engineer & serial entrepreneur, équipe Claude Code chez Anthropic — site : thariqs.github.io/html-effectiveness ; X : @trq212)

## Ton

**Profilo**: Articolo manifesto personale (~1500 parole) pubblicato su X / un blog personale, apertamente in prima persona, registro da praticante-evangelista. Pubblico target: utenti avanzati di Claude Code, designer, PM, ingegneri che producono specifiche/piani/report con un agente. Livello tecnico: intermedio — nessun codice, molta pratica vissuta (esempi concreti: il suo articolo sul prompt caching, le sue PR quotidiane, i suoi brainstorming di onboarding).

**Stile**: **Pedagogico-dimostrativo**. Si apre con una concessione ("Markdown has become the dominant file format used by agents… *But* as agents have become more and more powerful, I have felt that markdown has become a restricting format"). Segue poi una struttura retorica classica: *perché → come → casi d'uso → FAQ → conclusione*. Ogni sezione è supportata da un **esempio vissuto** ("when writing this article, I asked Claude Code to read through my code folder…") piuttosto che da una dimostrazione astratta. Anticipa le obiezioni ("Isn't it less token efficient?", "How do I view the HTML file?", "What about version control?") sotto forma di una FAQ onesta (concedendo che il diff HTML rumoroso sia *"one of the biggest downsides"*).

Posizione epistemica: **insider Anthropic Claude Code** che formalizza una pratica già adottata dal suo team (*"I increasingly see this being used by others on the Claude Code team"*). Tono emotivo: entusiasta ma non proselitista. Frasi segnale piantate per la viralità: *"the unreasonable effectiveness of HTML"* (un omaggio a Wigner-Karpathy), *"it's joyful"*, *"the chance of someone actually reading your spec is much much higher if it's in HTML"*, *"I'm a little bit afraid that people will read this article and turn it into a /html skill"*. Meta-mossa degna di nota: **anti-skill-ificazione esplicita** — l'autore, pur appartenendo all'ecosistema che spinge le Claude Skill, rifiuta di canonizzare la propria pratica in una skill. *"You don't need to do much to get Claude to do this. You can just ask it to 'make a HTML file' or 'make a HTML artifact'."*

Tono complessivo: **dottrinale ma umile**. Conclusione emotiva ("I feel much more in the loop than ever before when using HTML. I hope you do too.") — riporta la questione tecnica al problema vissuto della **perdita di controllo cognitivo** di fronte ad agenti che producono piani troppo lunghi da leggere (in forte risonanza con la *resa cognitiva* / *debito di comprensione* di Osmani).

## Pense-betes

- **Autore**: Thariq Shihipar — Ingegnere e imprenditore seriale, **team Claude Code di Anthropic**. X: @trq212. Sito: thariqs.github.io/html-effectiveness (galleria di esempi HTML generati da Claude Code, organizzata per categoria d'uso).
- **Data**: ~2026-05-10 (articolo recente, cita Opus 4.7 con contesto da 1MM, ID snowflake di X ~ maggio 2026). URL: `https://x.com/i/status/2052809885763747935`.
- **Tesi in una riga**: *"I've started preferring HTML as an output format instead of Markdown"* — il formato di output predefinito per gli artefatti agentici dovrebbe passare da Markdown a HTML.
- **Perché ora?**: tre fattori convergenti: 1. Gli agenti producono specifiche/piani più lunghi e ricchi di prima. 2. L'autore (e chi gli sta intorno) **non modifica più manualmente** questi file — chiede a Claude di modificarli → il vantaggio del "Markdown modificabile a mano" scompare. 3. **Opus 4.7 + contesto da 1MM** assorbe senza sforzo i token extra dell'HTML.
- **Le 6 ragioni (perché HTML)**: 1. **Densità informativa** — tabelle, CSS, SVG, script, canvas, immagini, posizionamento assoluto, dati spaziali. *"Almost no set of information that Claude can read that you cannot fairly efficiently represent with HTML."* 2. **Chiarezza visiva e facilità di lettura** — tab, illustrazioni, link, responsive per mobile. Oltre 100 righe di Markdown, nessuno le legge più. 3. **Facilità di condivisione** — upload su S3 → link diretto. *"The chance of someone actually reading your spec is much much higher if it's in HTML."* 4. **Interazione bidirezionale** — slider, manopole, pulsanti "copy as prompt" per il rientro in Claude Code. 5. **Ingestione dei dati** — Claude Code aggrega codebase + MCP (Slack, Linear) + cronologia git + Chrome → contesto più ampio rispetto a ClaudeAI o Claude Design. 6. **È piacevole** — *"makes me feel more involved and invested in the creation, and that by itself is enough"*.
- **Anti-pattern osservato in Markdown**: il modello, privato dell'espressività visiva, produce **diagrammi ASCII** o **approssima i colori con caratteri Unicode** (l'articolo include uno screenshot di Claude Code che tenta di "mostrare un colore" in Unicode → un segnale assurdo dell'inadeguatezza del formato).
- **Riferimento retorico**: *"The Unreasonable Effectiveness of HTML"* è un omaggio a *"The Unreasonable Effectiveness of Mathematics"* (Wigner, 1960) e alla tradizione dei titoli "unreasonable effectiveness of X" nel ML (Karpathy 2015 sulle RNN).
- **5 casi d'uso canonici approfonditi**: 1. **Specifiche, pianificazione ed esplorazione** — *"a web of HTML files"*: brainstorming di 6 direzioni in una griglia comparativa, espansione di un'opzione, mockup, snippet di codice, piano di implementazione. Prompt di esempio: *"Generate 6 distinctly different approaches — vary layout, tone, and density — and lay them out as a single HTML file in a grid so I can compare them side by side."* 2. **Code Review e comprensione** — allegare un explainer HTML a ogni PR. Diff renderizzato inline con annotazioni a margine, colorazione del codice per gravità. Prompt di esempio: *"Render the actual diff with inline margin annotations, color-code findings by severity."* 3. **Design e prototipi** — Claude Design è esso stesso basato su HTML. Prototipazione di animazioni con slider e pulsante "copy parameters" per esportare i valori regolati. 4. **Report, ricerca e apprendimento** — l'autore ha fatto generare il proprio articolo sul prompt caching leggendo la cronologia git. HTML long-form, explainer interattivo, presentazione a diapositive. 5. **Interfacce di editing personalizzate (editor usa e getta)** — un editor usa e getta a file singolo per uno specifico insieme di dati, che termina sempre con un **export** (copy as JSON/markdown/prompt) re-iniettabile in Claude Code. Esempi: drag-and-drop di 30 ticket Linear nelle colonne Now/Next/Later/Cut, un editor di feature flag con dipendenze e avvisi, un prompt-tuner affiancato con contatore di token. *"Not a product, or a reusable tool, but a single HTML file, purpose-built for this one piece of data."*
- **Anti-pattern principale reso esplicito**: *"I'm a little bit afraid that people will read this article and turn it into a /html skill or something. While there might be some value in that, I want to emphasize that you don't need to do much to get Claude to do this."* → **Anti-skill-ificazione**: la pratica è troppo dipendente dal contesto per essere fissata in una skill; basta il prompt "make a HTML file".
- **FAQ onesta** (concessioni esplicite):
- **Efficienza dei token**: HTML usa più token ma il contesto da 1MM di Opus 4.7 lo assorbe.
- **Generazione**: 2-4× più lenta di Markdown — *"but I've found the results are worth it"*.
- **Controllo di versione**: *"this is honestly one of the biggest downsides of HTML, HTML diffs are noisy and hard to review compared to Markdown"* — uno svantaggio irrisolto che l'autore riconosce apertamente.
- **Stile / evitare la bruttezza**: usare il **plugin di frontend design** o creare un unico **design system HTML** facendo puntare Claude sulla codebase, per poi farvi riferimento negli altri file HTML generati.
- **Meta-tesi finale (in-the-loop)**: *"I had begun to fear that because I had stopped reading plans in depth I would simply have to leave Claude to make its choices. But I am happy to say instead that I feel more in the loop than ever before when using HTML."* → HTML come **antidoto alla resa cognitiva** (Osmani) / **debito di comprensione**: la leggibilità ritrovata permette di restare nel ciclo decisionale.
- **Collegamenti con il corpus di veille**:
- Convergenza diretta con **`design.md` di Isenberg × Meng To** (2026-05-06): Meng afferma esplicitamente *"HTML = finished dish, MD file = recipe, skills = ingredients"*. Shihipar convalida la centralità di HTML per il **piatto finito consegnato all'umano**.
- Risposta operativa a **Osmani — Cognitive Surrender / Comprehension Debt** (2026-05-05): Shihipar nomina esattamente lo stesso problema (*"I had stopped reading plans in depth"*) e propone HTML come soluzione per "restare nel ciclo".
- Tensione con **Lattice / Vincent / Karpathy "skills-maxi"**: Shihipar adotta la posizione **opposta** sulla skill-ificazione ("don't turn this into a /html skill"). Compromesso: skill per pattern stabili, prompting nudo per pratiche emergenti.
- Conferma di **Opus 4.7 + contesto da 1MM** come **cambiamento architetturale** che rende economicamente sostenibili formati più verbosi (HTML, design system, brainstorming estesi).
- Parte della tradizione **Compounding engineering / Cherny**: HTML come nuovo strato di **output artefattuale** tra agente e umano, alla pari di descrizioni di PR, note di rilascio e messaggi di commit.
- **Esempio meta**: per scrivere questo articolo, l'autore ha chiesto a Claude Code di leggere la propria cartella di codice, trovare tutti i file HTML generati, raggrupparli/categorizzarli e produrre un file HTML con tutti i diagrammi per tipo → le illustrazioni dell'articolo sono esse stesse un prodotto del pattern che descrivono.
- **Flusso di lavoro risultante per una pratica solida**:
- Ogni specifica, piano o report > 100 righe → passare a HTML.
- PR critiche → allegare un explainer HTML.
- Onboarding di file, esplorazioni di design, riordini → editor HTML usa e getta con export strutturato.
- Mantenere Markdown per: messaggi di commit, brevi note di fiche, file di configurazione .md (CLAUDE.md, agents.md, ecc.).

## RésuméDe400mots

**Thariq Shihipar** (team Claude Code di Anthropic) pubblica un articolo in stile manifesto che annuncia un cambiamento nel formato di output predefinito per gli agenti: la sostituzione di **Markdown con HTML**. La diagnosi: Markdown ha regnato come formato dominante tra umano e agente (semplice, portabile, modificabile) ma è diventato **limitante** man mano che gli agenti producono artefatti più lunghi e ricchi. Oltre le ~100 righe, nessuno legge più un file Markdown — e poiché l'autore non modifica più manualmente le proprie specifiche (chiede a Claude di modificarle tramite prompt), il vantaggio storico di Markdown scompare.

**Sei ragioni** giustificano il passaggio a HTML: (1) **densità informativa** — tabelle, CSS, SVG, script, canvas, immagini; *"almost no set of information that Claude can read that you cannot represent with HTML"*; (2) **chiarezza visiva** — tab, illustrazioni, responsive per mobile; (3) **condivisione** — upload su S3 → link diretto, tasso di lettura moltiplicato; (4) **interattività bidirezionale** — slider, manopole, pulsanti "copy as prompt" per il rientro; (5) **ingestione contestuale** nativa di Claude Code (codebase + MCP + git + Chrome); (6) **piacere** — *"it's joyful"*.

L'autore formalizza **cinque usi canonici**: (a) **specifiche/piani/esplorazione** in una griglia comparativa; (b) **PR review** con diff annotato inline e colorazione del codice per gravità; (c) **design e prototipi** con slider di animazione; (d) **report/ricerca** (il suo explainer sul prompt caching generato a partire dalla cronologia git); (e) **editor usa e getta personalizzati** — file HTML singoli costruiti su misura per un singolo insieme di dati (drag-and-drop di ticket Linear, editor di feature flag, prompt-tuner affiancati) che terminano sempre con un export "copy as JSON/markdown/prompt" re-iniettabile.

Anti-pattern esplicito: **l'autore rifiuta la skill-ificazione** della propria pratica. *"I'm a little bit afraid that people will read this article and turn it into a /html skill. You don't need to do much — just ask it to 'make a HTML file'."* La pratica è troppo dipendente dal contesto per essere fissata in una skill.

FAQ onesta: HTML costa più token ma il **contesto da 1MM di Opus 4.7** lo assorbe; la generazione è 2-4× più lenta; i **diff HTML rumorosi** = uno svantaggio irrisolto, riconosciuto come tale.

Meta-tesi finale: HTML come **antidoto alla resa cognitiva**. *"I had begun to fear that because I had stopped reading plans in depth I would simply have to leave Claude to make its choices. But I feel more in the loop than ever before when using HTML."* La leggibilità ritrovata permette di restare in grado di decidere di fronte ad agenti sempre più potenti.

L'articolo si collega direttamente al **`design.md` di Meng To** (HTML = "piatto finito") e al **debito di comprensione di Osmani**, a cui offre una risposta operativa.

## GrapheDeConnaissance

- Thariq Shihipar —travaille_chez→ Anthropic (ORGANISATION, 0.97)
- Thariq Shihipar —fait_partie_de→ équipe Claude Code (ORGANISATION, 0.97)
- Thariq Shihipar —recommande→ HTML (format de sortie agent) (METHODOLOGIE, 0.98)
- HTML (format de sortie agent) —remplace→ Markdown pour artefacts agentiques longs (METHODOLOGIE, 0.95)
- Thariq Shihipar —affirme_que→ Markdown devient restrictif au-delà de ~100 lignes (AFFIRMATION, 0.92)
- HTML (format de sortie agent) —permet→ densité d'information (tables, CSS, SVG, scripts, canvas) (CONCEPT, 0.97)
- HTML (format de sortie agent) —permet→ interactivité bidirectionnelle (sliders, copy as prompt) (CONCEPT, 0.96)
- HTML (format de sortie agent) —améliore→ taux de lecture des specs et rapports (CONCEPT, 0.93)
- HTML (format de sortie agent) —résout→ Cognitive surrender (réponse) (CONCEPT, 0.9)
- Claude Code —utilise→ codebase + MCP + git history + Chrome (CONCEPT, 0.95)
- Opus 4.7 —utilise→ 1MM context window (CONCEPT, 0.97)
- 1MM context Opus 4.7 —permet→ HTML (format de sortie agent) (CONCEPT, 0.93)
- Throwaway HTML editor —utilise→ export copy as JSON / markdown / prompt (CONCEPT, 0.96)
- Thariq Shihipar —s_oppose_à→ Anti-skill-ification (CONCEPT, 0.95)
- Thariq Shihipar —affirme_que→ les diffs HTML sont bruyants et difficiles à reviewer (downside assumé) (AFFIRMATION, 0.92)
- HTML (format de sortie agent) —mesure→ 2-4× plus lente que Markdown (MESURE, 0.88)
- Frontend design plugin —permet→ HTML (format de sortie agent) (CONCEPT, 0.85)
- Design system HTML de référence —permet→ cohérence stylistique cross-fichiers (CONCEPT, 0.88)
- Unreasonable effectiveness —converge_avec→ design.md de Meng To (HTML = finished dish) (CONCEPT, 0.93)
- Unreasonable effectiveness —résout→ comprehension debt d'Osmani (réponse opérationnelle) (CONCEPT, 0.9)
- Claude Code —permet→ HTML (format de sortie agent) (METHODOLOGIE, 0.96)
- Anthropic —emploie→ Thariq Shihipar (PERSONNE, 0.97)

---
Canonical: https://www.thekb.eu/it/fiches/shihipar-claude-code-html-unreasonable-effectiveness-markdown-2026-05-10/