27 convenzioni, curate a mano

La filosofia

Partiamo dai modi in cui il codice generato dall’IA si rompe davvero: tipi any silenziosi, errori inghiottiti, stati illegali raggiungibili attraverso campi opzionali, crash a runtime per input non validati. Ogni regola è scritta per spingere il modello lontano da una di queste modalità di fallimento — e resta nella libreria solo se migliora visibilmente il codice prodotto dagli agenti.

Ogni regola è breve, opinionata e autocontenuta. Il tuo agente ne legge una quando sta per fare una modifica rilevante — non tutte all’inizio della sessione. Il risultato: prompt più piccoli, bollette più leggere e regole che il modello riesce davvero a tenere in memoria di lavoro mentre scrive.

Cosa contiene la libreria

La libreria attuale conta 27 convenzioni che coprono le aree in cui il TypeScript generato dall’IA sbaglia più spesso: rigore dei tipi, gestione degli errori, validazione a runtime ai confini di fiducia, naming e struttura dei moduli, controllo del flusso e pattern specifici dei framework (per esempio le shape delle prop dei componenti React, le convenzioni dei modelli Prisma).

Le regole specifiche sono disponibili agli abbonati tramite il server MCP — non pubblichiamo qui l’elenco completo. Abbonati per accedere al corpus.

Aggiornamenti

Aggiungiamo e affiniamo le convenzioni man mano che il tooling sottostante e il comportamento dei modelli evolvono. Gli aggiornamenti arrivano istantaneamente: non c’è nulla da ridistribuire dalla tua parte. I cambiamenti rilevanti vengono comunicati agli abbonati via email.