# thariq-field-guide-fable-finding-unknowns-2026-07-03

## Veille

Thread X (thread illustrato) di **Thariq Shihipar** (team Claude Code / Anthropic): una *field guide* per trarre il massimo da **Claude Fable 5**. Tesi centrale mutuata da Korzybski — *"la mappa non è il territorio"*: la **mappa** = ciò che si fornisce a Claude (prompt, skill, contesto); il **territorio** = dove il lavoro avviene realmente (codebase, vincoli del mondo reale); lo scarto tra i due = gli **unknowns**. Fable è *"il primo modello in cui la qualità del lavoro è limitata dalla mia capacità di chiarire i suoi unknowns"*. L'articolo propone un **framework a 4 quadranti** (known knowns / known unknowns / unknown knowns / unknown unknowns) e un **toolkit di tecniche** ordinate nel tempo (prima / durante / dopo l'implementazione) — blindspot pass, brainstorm & prototipi, interviste, riferimenti, implementation plan, implementation-notes, pitch & explainer, quiz — ciascuna con prompt d'esempio. Ambito: prompt engineering, agenti di codifica, metodologia di lavoro con l'IA, artefatti HTML.

## Titre Article

A Field Guide to Fable: Finding Your Unknowns

## Date

2026-07-03

## URL

https://x.com/trq212/status/2073100352921215386

## Keywords

Unknowns, map vs territory, known/unknown knowns, unknown unknowns, blindspot pass, brainstorm, prototipo, intervista, riferimenti, implementation plan, implementation-notes.md, pitch ed explainer, quiz, artefatti HTML, Claude Fable 5, Claude Design, thought partner, prompt engineering, long-horizon tasks, scoperta iterativa degli unknowns

## Authors

Thariq Shihipar (@trq212)

## Ton

**Profilo**: field guide in prima persona, registro riflessivo e pedagogico da practitioner, pubblicato come thread X illustrato di lunga durata con 4 diagrammi. Livello tecnico medio-alto, rivolto a utilizzatori quotidiani di agenti di codifica.

**Stile**: un saggio costruito attorno a una **metafora cartografica estesa** mutuata dalla semantica generale ("la mappa non è il territorio") e portata avanti fino alla punchline ("Matching the Map and Territory"). Struttura temporale esplicita (prima / durante / dopo l'implementazione) abbinata a un framework concettuale mutuato da Rumsfeld/Johari (la matrice 2×2 known/unknown). Autorevolezza tramite **auto-dimostrazione incarnata**: Thariq racconta come ha montato il **video di lancio di Fable** interamente con Claude Code pur non conoscendo nulla dell'ambito (trascrizione Whisper, montaggio ffmpeg, interfaccia sincronizzata sulle parole via Remotion, *color grading* che si è fatto *insegnare* da Claude. Ogni tecnica è accompagnata da **prompt d'esempio pronti all'uso** — è una guida operativa, non una teoria. Frasi-manifesto: *"ridurre e pianificare i propri unknowns è LA competenza della programmazione agentica"*, *"ogni explainer, brainstorm, intervista, prototipo e riferimento è un modo economico per scoprire ciò che non si sapeva prima che diventi costoso da correggere"*, *"non integro finché non supero perfettamente il quiz"*, *"ciò che si impara diventa la mappa per la volta successiva"*. **Pubblico target**: ingegneri e maker che lavorano con Claude, anche al di fuori del proprio ambito di competenza.

## Pense-betes

- **Metafora guida: la mappa non è il territorio.** La **mappa** = ciò che si fornisce a Claude (prompt, skill, contesto). Il **territorio** = dove il lavoro avviene realmente (codebase, mondo reale, vincoli). Lo scarto tra i due = gli **unknowns**. Di fronte a un unknown, Claude *decide sulla base della sua migliore ipotesi su ciò che si desidera* → più ampio è il lavoro, più unknowns incontra.
- **Il plateau di Fable.** *"Fable è il primo modello in cui trovo che la qualità del lavoro sia limitata dalla mia capacità di chiarire i suoi unknowns"* — il collo di bottiglia si è spostato dal modello alla **chiarezza umana**. Pianificare in anticipo non basta: gli unknowns emergono a metà implementazione, oppure rivelano che il problema andava risolto **diversamente**. → un processo **iterativo**: scoprire i propri unknowns **prima, durante e dopo**.
- **I 4 quadranti (matrice degli unknowns)**: **Known knowns** = ciò che è nel prompt (ciò che si dichiara di volere); **Known unknowns** = ciò che non è ancora stato risolto ma di cui si è consapevoli; **Unknown knowns** = *"troppo ovvio da scrivere, ma lo riconoscerei"* (il "lo saprò quando lo vedrò"); **Unknown unknowns** = *"la buca che non si sapeva potesse esserci sulla strada"*.
- **La vera competenza**: *"ridurre e pianificare i propri unknowns è LA competenza della programmazione agentica"*. I migliori (cita **Boris**, **Jarred**) hanno **pochi unknowns** (in sintonia sia con la codebase sia con i comportamenti del modello) ma **presumono** che alcuni restino. Buona notizia: è una competenza che **migliora lavorando con Claude**.
- **Istruire Claude è un equilibrio delicato.** Troppo preciso → Claude segue le istruzioni anche quando sarebbe meglio un **cambio di rotta**. Troppo vago → Claude colma i vuoti con le *best practice del settore*, non necessariamente adatte al caso. Senza gestire i propri unknowns, **si fallisce su entrambi i fronti**. Rimedio: fornire a Claude il **contesto sul proprio punto di partenza** (dove si è nel proprio ragionamento, la propria esperienza col problema) e trattarlo come un **partner di pensiero**. Claude esplora la codebase e il web molto rapidamente e itera dal fallimento più velocemente di noi.
- **PRIMA — Blindspot pass**: quando si lavora in territorio sconosciuto (unknown unknowns), chiedere a Claude di **trovare e spiegare i propri punti ciechi**. Usare le parole letterali *"blindspot pass"* e *"unknown unknowns"* più il contesto su chi si è. Es. *"sto aggiungendo un nuovo provider di autenticazione ma non so nulla dei moduli di auth… fai un blindspot pass"*; *"insegnami a capire i miei unknown unknowns sul color grading così posso scrivere prompt migliori"*.
- **PRIMA — Brainstorm & prototipi**: per gli **unknown knowns** (criteri definibili solo vedendoli, ad es. il design visivo). Verbalizzarli **precocemente**, poiché scoprirli durante l'implementazione è costoso (una piccola modifica alla specifica può significare codice radicalmente diverso, difficile da annullare). Iniziare **quasi ogni sessione** con una fase di esplorazione/brainstorm per inquadrare l'ambito (né troppo ristretto né troppo ampio). Es. *"fammi una pagina HTML con 4 direzioni di design radicalmente diverse così posso reagire"*; *"simula la nuova toolbar in un unico file HTML con dati fittizi prima di toccare l'app reale"*; *"fai un brainstorm di 10 punti di intervento possibili, dal più economico al più ambizioso"*.
- **PRIMA — Interviste**: dopo il brainstorm, chiedere a Claude di **intervistarci** sulle ambiguità rimanenti, **una domanda alla volta**, dando priorità alle *"domande la cui risposta cambierebbe l'architettura"*.
- **PRIMA — Riferimenti**: quando non si riesce a descrivere ciò che si vuole, **il miglior riferimento è il codice sorgente**. Indicare a Fable una cartella/libreria (anche in un altro linguaggio) e dire cosa cercarvi. **Claude Design** funziona così: puntato su un modulo di un sito, **legge il codice sottostante** (markup, struttura, costruzione effettiva), non solo lo screenshot. Es. *"questo crate Rust implementa esattamente il backoff che voglio — reimplementa la stessa semantica nel nostro client TypeScript"*.
- **PRIMA — Implementation plan**: chiedere un piano **guidato dalle decisioni più suscettibili di cambiare** (modelli di dati, interfacce di tipo, flussi UX) e **relegando in fondo il refactoring meccanico** (*"su quella parte mi fido di te"*). Il piano **fa emergere** ciò che effettivamente andrà modificato.
- **DURANTE — Implementation notes**: per quanta pianificazione si faccia, **restano unknown unknowns** (l'agente trova un edge case mentre scrive il codice). Far tenere a Claude Code un **`implementation-notes.md`** temporaneo in cui registra le decisioni *"così da poter imparare per il nostro prossimo tentativo"*. Es. *"se incontri un edge case che impone una deviazione, scegli l'opzione conservativa, registrala sotto 'Deviations' e continua"*.
- **DOPO — Pitch & explainer**: *shippare* significa ottenere **consenso e approvazioni**. Impacchettare prototipo + specifica + note in **un unico documento** che *"parta dalla GIF della demo"* → accelera la comprensione (i revisori **partono dagli stessi unknowns**) e le approvazioni (gli esperti vogliono vedere che i loro punti di rottura sono stati coperti).
- **DOPO — Quiz**: dopo una lunga sessione, leggere i diff dà solo una comprensione **superficiale** (il comportamento dipende dai percorsi di codice esistenti). Chiedere a Claude un **report HTML + un quiz** sulle modifiche — *"non integro finché non supero perfettamente il quiz"*.
- **Prova concreta: il video di lancio di Fable**, montato **interamente con Claude Code** in un ambito che Thariq non padroneggiava — parte da ciò che conosce (Claude può montare/trascrivere video tramite codice), si fa **spiegare** Whisper/ffmpeg, **prototipa** un'interfaccia sincronizzata sulle parole via Remotion, poi si fa **insegnare** da Claude il color grading (non avendo idea di cosa significhi "buono") invece di generare varianti alla cieca.
- **Punchline**: *"ogni explainer, brainstorm, intervista, prototipo e riferimento è un modo economico per scoprire ciò che non si sapeva prima che diventi costoso da correggere"* → *"inizia il tuo prossimo progetto chiedendo a Claude di aiutarti a trovare i tuoi unknowns"*. Il residuo dell'apprendimento diventa la mappa per la volta successiva ("ciò che si impara diventa la mappa per la prossima volta").
- **Collegamenti**: converge con il *Compounding Knowledge Lifecycle* (capitalizzare ciò che si è appreso), il *loop engineering*, e la nota **[[willison-fable-judgement-delegation-subagents-2026-07-03]]** (stesso autore citato, Thariq, stesso momento su Fable) — due sfaccettature complementari: Willison su **lasciar giudicare Fable**, Thariq su **ridurre i propri unknowns per guidarlo meglio**.

## RésuméDe400mots

In questa *field guide* pubblicata il 3 luglio 2026, **Thariq Shihipar** (team Claude Code) formalizza una prassi per trarre il massimo da **Claude Fable 5**. Punto di partenza, mutuato da Korzybski: *"la mappa non è il territorio"*. La **mappa** è ciò che si fornisce a Claude — prompt, skill, contesto. Il **territorio** è dove il lavoro avviene realmente — la codebase, il mondo reale, i suoi vincoli. Lo scarto tra i due lo chiama gli **unknowns**: quando Claude ne incontra uno, decide sulla base della sua migliore ipotesi su ciò che si desidera. Più ampio è l'ambito del lavoro, più unknowns incontra. Fable è *"il primo modello in cui trovo che la qualità del lavoro sia limitata dalla mia capacità di chiarire i suoi unknowns"* — il collo di bottiglia si è spostato dal modello alla chiarezza umana.

Thariq propone una **matrice 2×2**: *known knowns* (ciò che è nel prompt), *known unknowns* (ciò che si sa di non sapere), *unknown knowns* (l'ovvio che non si scrive ma che si riconoscerebbe) e *unknown unknowns* (ciò che non si è mai considerato). Ridurre e anticipare i propri unknowns è, a suo avviso, **LA competenza** della programmazione agentica — e si apprende lavorando con Claude. Istruire resta un esercizio di equilibrio: troppo preciso, e Claude segue le indicazioni anche quando sarebbe meglio un cambio di rotta; troppo vago, e riempie i vuoti con *best practice* poco adatte.

Segue un **toolkit** ordinato nel tempo, ogni tecnica corredata di prompt. **Prima**: il *blindspot pass* (far esplicitare i propri punti ciechi), *brainstorm & prototipi* (verbalizzare precocemente gli *unknown knowns*, ad es. 4 direzioni di design in HTML), *interviste* (Claude interroga una domanda alla volta, dando priorità a ciò che cambia l'architettura), *riferimenti* (il migliore è il codice sorgente — è così che funziona **Claude Design**), e l'*implementation plan* guidato da ciò che è più probabile che cambi. **Durante**: un `implementation-notes.md` in cui l'agente registra le proprie deviazioni. **Dopo**: *pitch & explainer* (un unico documento guidato dalla demo, poiché i revisori partono dagli stessi unknowns) e *quiz* ("non integro finché non supero perfettamente il quiz").

Prova a sostegno: il **video di lancio di Fable**, montato interamente con Claude Code in un ambito sconosciuto all'autore, al punto da farsi *insegnare* dal modello il color grading. Morale: ogni artefatto è un modo economico per scoprire ciò che non si sapeva **prima che diventi costoso da correggere**. *"Inizia il tuo prossimo progetto chiedendo a Claude di aiutarti a trovare i tuoi unknowns."*

## GrapheDeConnaissance

- Thariq Shihipar —travaille_chez→ équipe Claude Code (Anthropic) (ORGANISATION, 0.95)
- Thariq Shihipar —affirme_que→ "Fable est le premier modèle où la qualité du travail est plafonnée par ma capacité à clarifier ses inconnues" (AFFIRMATION, 0.95)
- Finding Your Unknowns —s_applique_à→ Claude Fable 5 (TECHNOLOGIE, 0.95)
- Finding Your Unknowns —est_basé_sur→ "la carte n'est pas le territoire" (AFFIRMATION, 0.93)
- Matrice des inconnues —fait_partie_de→ Finding Your Unknowns (METHODOLOGIE, 0.9)
- Thariq Shihipar —affirme_que→ "reducing and planning for your unknowns is THE skill of agentic coding" (CITATION, 0.94)
- Blindspot pass —permet→ Unknowns (CONCEPT, 0.9)
- Brainstorms & prototypes —permet→ verbaliser tôt les unknown knowns (moins cher qu'en implémentation) (CONCEPT, 0.9)
- References —résout→ l'incapacité à décrire ce qu'on veut en détail (CONCEPT, 0.9)
- Claude Design —utilise→ lecture du code sous-jacent d'un module (pas seulement la capture) (CONCEPT, 0.88)
- implementation-notes.md —permet→ journaliser les déviations pendant l'implémentation (CONCEPT, 0.9)
- Quizzes —améliore→ la compréhension réelle d'un changement avant le merge (CONCEPT, 0.9)
- Pitches & explainers —permet→ obtenir buy-in et approbations (reviewers partant des mêmes inconnues) (CONCEPT, 0.88)
- Claude Code —a_créé→ vidéo de lancement de Fable (DOCUMENT, 0.9)
- Instruction de Claude —affirme_que→ trop spécifique empêche le pivot, trop vague invoque des best practices inadaptées (AFFIRMATION, 0.9)

---
Canonical: https://www.thekb.eu/it/fiches/thariq-field-guide-fable-finding-unknowns-2026-07-03/