Prompt engineering per sviluppatori: tecniche per codice, refactor e test unitari

L’IA e gli LLM (Claude, GPT-4, Gemini) hanno cambiato l’ingegneria del software. Non è più solo autocomplete: è un pair programmer per architettura, profiling e test unitari. La qualità del codice è proporzionale alla chiarezza del prompt. Un prompt vago dà boilerplate generico, allucinazioni e bug sottili di runtime.

Per usare gli LLM sul serio nel quotidiano bisogna passare dalla chat sciolta al prompt engineering strutturato. Tecniche e strutture di prompt che potete mettere già nel workflow.

1. Anatomia di un prompt di codice di qualità

Quando chiedete codice a un LLM, un prompt che funziona ha quattro pilastri: ruolo, contesto, vincoli tecnici e formato di output. Una struttura da copiare e adattare:

• Persona di sistema: alzate l’asticella. Per esempio: «Agisci come ingegnere senior di React, specializzato in Next.js App Router, TypeScript e architettura di componenti pulita».
• Contesto: spiegate l’ambiente. «Il progetto usa Tailwind per gli stili, Zustand per lo state globale e TanStack Query per i dati server».
• Vincoli stretti: elencate cosa evitare. «Non installare dipendenze NPM. Usa hook nativi di React. Non scrivere file CSS: solo utility class inline».
• Formato di output: definite la risposta. «Restituisci solo lo snippet TypeScript completo in un blocco markdown. Senza intro né spiegazioni».

2. Tecniche avanzate di prompt engineering, con esempi

Prompt strutturati alzano precisione e affidabilità del codice. Tre pattern che funzionano:

• Few-shot: date al modello 1 o 2 esempi di codice buono del vostro progetto. Così copia convenzioni di nomi, formato e import.
• Chain of Thought (CoT): obbligate il LLM a scrivere un piano tecnico prima di generare codice. «Passo 1: delinea il flusso di state. Passo 2: elenca gli edge case (vuoto, loading). Passo 3: scrivi il componente TypeScript che implementa il piano».
• Iniezione del system prompt: mettete regole di codice nel system prompt dell’IDE (Cursor, VS Code) per applicarle sempre. Evita classici: API deprecate o CSS ereditato.

3. Template di prompt per lo sviluppo quotidiano

Tre prompt che uso per accelerare architettura frontend e test:

• Per il refactor: «Analizza questo componente React in cerca di memory leak, re-render di troppo e leggibilità. Fai refactor con React.memo o useMemo dove serve, converti i loop annidati in un lookup piatto e restituisci TypeScript pulito».
• Per i test unitari: «Agisci come ingegnere di QA automation. Scrivi test unitari completi per questo componente React con Vitest e React Testing Library. Copri click tipici, errori API, spinner di loading e accessibilità (aria-attributes)».
• Per conversione di schema: «Converti questo schema SQL in uno schema Prisma TypeScript e nello Zod corrispondente. Tipizza tutti i campi e aggiungi messaggi di errore di validazione su misura».

Conclusione: prodotti migliori, più in fretta

Il prompt engineering è una skill di base per lo sviluppatore di adesso. Se strutturate contesto, vincoli e istruzioni, il LLM estende la vostra capacità. L’IA mette le fondamenta; verificare, fare audit delle performance e integrare resta del senior. Mettete queste tecniche oggi nei vostri progetti Next.js e Web3.