Riccardo Belli. Risorsa · Mappa
// risorsa · dal reel

La mappa
della tua app

Floorplan è un plugin gratuito per Claude Code e Codex. Legge il codice della tua app e ti disegna una mappa interattiva che apri nel browser: ogni parte con un nome in parole semplici e i collegamenti fra l'una e l'altra. Qui trovi il prompt che lo installa, quello che genera la mappa e le domande da farle.

Tool
Floorplan
Lettura
~4 min
Aggiornata
18 novembre 2026
Claude Code Codex GitHub Node.js 18+
Scorri
01Setup

Un prompt e lo installi

2 minuti
haydenschmitty/floorplanMIT

Apri Claude Code, incolla questo prompt e lascia fare a lui. Controlla Node.js, installa il plugin e, se sul computer c'è anche Codex, lo installa pure lì.

Il promptincolla in Claude Code
Installami Floorplan, il plugin che disegna la mappa della mia app.
Il repo è github.com/haydenschmitty/floorplan

1. Controlla che ci sia Node.js 18 o più recente.
   Se manca o è più vecchio, installalo tu.

2. Se il comando claude non c'è nel Terminale, installa la versione
   da Terminale di Claude Code: serve anche alla barra delle domande della mappa.

3. Installa il plugin in Claude Code:
   claude plugin marketplace add haydenschmitty/floorplan
   claude plugin install floorplan@floorplan

4. Se sul computer c'è anche Codex, installalo pure lì:
   codex plugin marketplace add haydenschmitty/floorplan
   codex plugin add floorplan@floorplan

Se manca qualcos'altro, installalo tu.
Alla fine dimmi cosa hai installato e se devo aprire una nuova sessione.

Gira sul piano di Claude o di ChatGPT che hai già, senza chiavi API e senza costi in più. Finita l'installazione apri una nuova sessione e il plugin è pronto.

02La mappa

Genera la mappa

Qualche minuto

Apri Claude Code nella cartella della tua app. Se il sito e il server stanno in due repo separati, apri la cartella che li contiene tutti e due: Floorplan li trova e collega le chiamate fra l'uno e l'altro.

Genera la mappain Claude Code o Codex
Fammi una floorplan di questa app.
Scrivi nomi e descrizioni dei pezzi in parole semplici,
per qualcuno che il codice non lo legge.
  1. Claude legge il progetto e scrive un nome e una riga di descrizione per ogni parte, ogni file e ogni chiamata web. Su un'app piccola ci mette qualche minuto, su una grande di più.
  2. La mappa si apre da sola nel browser e parte con un breve tour. Doppio clic su una parte per entrarci dentro, fino al singolo file.
  3. Floorplan scrive solo la sua cartella floorplan/ nel progetto: non tocca il tuo codice e resta fuori da git.

Se un nome non ti torna, chiedilo a Claude: rinomina "Main server" in "Server del negozio" sulla floorplan. Le modifiche restano anche quando aggiorni la mappa.

03Domande

Fai domande alla mappa

Ask

In fondo alla mappa c'è una barra per le domande. Scrivi e premi Invio: Claude risponde in poche righe guardando il codice vero e ti mostra solo i pezzi coinvolti, collegati fra loro, con i passaggi numerati quando la risposta è una sequenza.

Domande da farenella barra della mappa
Cosa succede quando un cliente paga?
Cosa si rompe se cambio il carrello?
Dove parliamo con Stripe?
Quali file gestiscono il login?
Come arriva la mail di conferma al cliente?
Cosa abbiamo cambiato per i rimborsi?

Per far leggere il codice alla barra delle domande serve Claude Code da Terminale. Il prompt dell'installazione lo controlla già. Con Codex funziona anche dall'app.

04Modifiche

Vedi cosa ha toccato Claude

Recent work

Dopo ogni lavoro chiedi di aggiornare la mappa. Floorplan rilegge solo quello che è cambiato, quindi ci mette poco. Le parti che Claude ha modificato si accendono di verde, ognuna con una nota su cosa ha cambiato e perché serviva.

Una mappa di Floorplan su un negozio online di prova: Negozio online, Carrello e Database collegati al Server principale, che parla con Pagamento, Mail di conferma e Buoni sconto. Le parti appena modificate sono bordate di verde
Richieste utiliin Claude Code o Codex
Aggiorna la floorplan.
Aggiungi un flusso che mostra come si iscrive un nuovo utente.
Riscrivi la floorplan per gli sviluppatori.
Esporta la floorplan, così la mando al team.

L'esportazione è un file HTML solo che si apre in qualsiasi browser. Dentro c'è la mappa con nomi e descrizioni, senza il tuo codice.

05Bonus

Il controllo Health

Sicurezza

In alto nella mappa c'è il pulsante Health. Elenca gli errori classici delle app fatte con l'AI, ognuno con il prompt pronto per sistemarlo:

  1. chiavi e password scritte nel codice o mandate al browser;
  2. tabelle di Supabase che chiunque può leggere e regole di Firebase aperte;
  3. webhook di Stripe che qualcuno potrebbe falsificare;
  4. indirizzi del server che si usano senza fare il login.
Sistema i problemiin Claude Code o Codex
Sistema i problemi importanti del controllo Health della floorplan.
Prima di cambiare qualcosa dimmi cosa tocchi e perché.

È un controllo veloce sugli errori più comuni. Se la tua app tratta pagamenti o dati personali, fai vedere il codice anche a uno sviluppatore.

E adesso?

Adesso la tua app
ha una mappa.

Un prompt per installarlo, uno per la mappa e le domande giuste da farle. La prossima volta che Claude cambia qualcosa, aggiorna la floorplan e guarda cosa si è acceso di verde.

Vuoi andare più a fondo?

Se vuoi impararlo per bene, dal primo comando a Claude Code, c'è il corso. Se invece hai un'azienda e vuoi portare l'AI dentro i processi, parliamone in una call.

Il corso su Claude → Parliamo del tuo progetto →
La risorsa che ti ho promesso. Riccardo Belli.