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.
Un prompt e lo installi
2 minutiApri 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ì.
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.
Genera la mappa
Qualche minutoApri 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.
Fammi una floorplan di questa app. Scrivi nomi e descrizioni dei pezzi in parole semplici, per qualcuno che il codice non lo legge.
- 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ù.
- 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.
- 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.
Fai domande alla mappa
AskIn 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.
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.
Vedi cosa ha toccato Claude
Recent workDopo 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.
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.
Il controllo Health
SicurezzaIn alto nella mappa c'è il pulsante Health. Elenca gli errori classici delle app fatte con l'AI, ognuno con il prompt pronto per sistemarlo:
- chiavi e password scritte nel codice o mandate al browser;
- tabelle di Supabase che chiunque può leggere e regole di Firebase aperte;
- webhook di Stripe che qualcuno potrebbe falsificare;
- indirizzi del server che si usano senza fare il login.
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.
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.