Mia sorella gestisce un'attività di dog-walking dalla sua auto. Quattordici clienti, un Google Calendar condiviso che tre persone modificano male, e l'abitudine di mandare un messaggio "sto arrivando!" a chiunque sia il prossimo cane, il che significa che se n'è dimenticata due volte e ha dovuto affrontare la telefonata imbarazzante. Mi ha chiesto "un'app, niente di che" un giovedì e la voleva online entro il lunedì successivo. Le ho detto che avrei provato ad avere qualcosa entro la domenica sera. Questo è il diario che ho tenuto, perché volevo sapere in seguito cosa avesse davvero richiesto tempo rispetto a cosa pensavo soltanto lo richiedesse.
Venerdì, 20:40 — il prompt
Non ho aperto un editor vuoto. Ho aperto la chat e ho semplicemente descritto l'attività: dog-walker solo, quattordici clienti ricorrenti, serve un messaggio di promemoria automatico ai clienti la mattina della loro passeggiata, serve una pagina semplice dove poter aggiungere un nuovo cliente e il nome del suo cane in meno di trenta secondi perché di solito lo fa in piedi nel vialetto di qualcuno. Ho detto "app di prenotazione" una volta e poi mi sono immediatamente corretto — non è un'app di prenotazione, è una lista clienti con un promemoria automatico. Essere precisi su cosa non era si è rivelato più importante che descrivere cosa era.
Venerdì, 21:05 — arriva il piano
Il piano aveva tre elementi che non avevo chiesto e che avrei dimenticato:
- Un modo per contrassegnare una passeggiata come completata, così il promemoria non scatta due volte
- Un link di opt-out SMS per la conformità normativa
- Una semplice vista giornaliera invece di una griglia calendario, perché una griglia calendario su un telefono con quattordici voci è solo un muro di testo minuscolo
Ho riscritto il piano tre volte separate nei venti minuti successivi, per lo più riformulando cose che non avevano bisogno di essere riformulate. Col senno di poi era pura ansia — l'agente per la pianificazione aveva già azzeccato la struttura la prima volta, e io stavo modificando le frasi invece della sostanza.
Venerdì, 21:40 — prima esecuzione
L'ho avviato e ho guardato il team di agenti lavorare sul modello cliente, la pagina della vista giornaliera e il job dei promemoria. Il design è tornato con l'aspetto di un modulo di accettazione di uno studio veterinario, il che era in realtà corretto per il pubblico — i clienti di mia sorella sono proprietari di cani sui 40-50 anni, non un pitch deck da Serie A. Per abitudine ho quasi contestato lo stile visivo prima di rendermi conto che si adattava all'utente reale meglio di qualsiasi cosa avrei scelto io.
Venerdì, 22:30 — primo intoppo
La parte SMS aveva bisogno di una chiave provider live prima di poter inviare qualcosa di reale, il che è un comportamento corretto e non un bug, ma avevo dimenticato di non averne configurata una. Tutto il resto continuava a funzionare — l'app registrava semplicemente cosa avrebbe inviato invece di inviarlo, il che significava che potevo continuare a costruire invece di bloccarmi su una registrazione Twilio alle 22:30 di venerdì. Sono andato a dormire.
Sabato, 8:00 — l'intoppo vero
Questo è quello che mi è costato tempo vero. Avevo chiesto che i promemoria partissero "la mattina stessa", e la prima versione lo aveva interpretato come un invio fisso alle 7 del mattino per ogni cliente, indipendentemente dall'orario della passeggiata. Andava bene per una passeggiata delle 9, inutile per una delle 16. Sono tornato nella chat e l'ho detto direttamente:
Il promemoria dovrebbe scattare un numero fisso di ore prima dell'orario programmato di ogni singola passeggiata, non a un orario fisso dell'orologio.
La correzione ha richiesto un solo scambio. La lezione non riguardava lo strumento, riguardava il mio prompt: "la mattina stessa" è il tipo di frase che sembra precisa a chi la dice ed è completamente ambigua per chiunque altro, incluso, a quanto pare, me stesso dodici ore dopo.
Sabato, 11:15 — la lettura del registro di verifica
Prima di toccare qualsiasi altra cosa ho tirato fuori ciò rispetto a cui la build si era autoverificata:
- Il salvataggio corretto del modulo cliente
- Il job dei promemoria eseguito su un giorno di test di appuntamenti
- Il link di opt-out che effettivamente disiscrive un numero di test
Non c'era niente in fiamme. Ho preso l'abitudine di leggere questo prima di andare a cercare problemi da solo, perché mi dice dove concentrare davvero l'attenzione invece di cliccare in giro a caso sperando di notare qualcosa di sbagliato.
Sabato, 14:00 — SMS, sul serio stavolta
Ho configurato l'account del provider, inserito la chiave, e inviato a me stesso un promemoria di prova.
Piccola cosa, ma è il momento in cui un progetto smette di essere una demo e inizia a essere qualcosa che esiste nel mondo reale.
Sabato, 16:20 — l'attesa del dominio
Ho puntato il suo dominio reale e poi non ho fatto niente di utile per due ore mentre il DNS si propagava. Ho usato il tempo per scrivere io stesso le quattordici righe dei clienti reali, invece di lasciarglielo fare da telefono domenica sera, il che col senno di poi è stata la decisione migliore di tutto il weekend — l'inserimento dati poco glamour vince su qualsiasi lucido extra che nessuno ha chiesto.
Domenica, 9:00 — la parte che ho quasi sovracostruito
Mi sono convinto che lei avrebbe voluto un riepilogo settimanale — passeggiate fatte, assenze, entrate — e ho iniziato a chiedere un digest automatico del lunedì mattina. Mi sono fermato a metà descrizione. Ha quattordici clienti e tiene la contabilità su un quaderno. Una funzione di riepilogo è la soluzione a un problema che non ha ancora. L'ho tolta. Posso aggiungerla in cinque minuti la settimana in cui lo chiederà davvero, e fino ad allora è solo superficie su cui qualcosa può andare storto.
Domenica, 13:10 — le ho inviato il link
Ha aggiunto un cliente dal telefono mentre era in piedi in un parcheggio, ed è stato il vero test che contava più di qualsiasi cosa avessi controllato io stesso.
Domenica, 18:40 — cosa salterei la prossima volta
Cosa salterei, la prossima volta:
- Tre riscritture del piano che non hanno cambiato nulla
- Due ore a preoccuparmi del provider SMS prima ancora di averlo provato a configurare
- La dashboard di riepilogo quasi costruita — la mezz'ora più veloce di tutto il weekend è stata quella spesa a dire "no" alla mia stessa idea invece di costruirla
Tutto ciò che ha davvero richiesto tempo era o un'ambiguità genuina nella mia stessa richiesta, o l'attesa inevitabile sul server DNS di qualcun altro. Nel prossimo progetto, scriverò il prompt una volta, lo rileggerò come farebbe uno sconosciuto, e mi fiderò del primo piano più di quanto mi sia fidato di questo.
