Applying SHAPR in AI-Assisted Research Software Development: Lessons Learnt from Building a Share Trading System
Questo articolo illustra l'applicazione del framework SHAPR nello sviluppo di un sistema di trading azionario, evidenziando come una configurazione di lavoro strutturata e la documentazione continua supportata dall'IA abbiano preservato la tracciabilità e la coerenza metodologica, fornendo cinque lezioni pratiche per la ricerca software assistita dall'intelligenza artificiale.
Articolo originale sotto licenza CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Questa è una spiegazione generata dall'IA dell'articolo qui sotto. Non è stata scritta né approvata dagli autori. Per precisione tecnica, consulta l'articolo originale. Leggi il disclaimer completo
🚗 L'Auto a Guida Autonoma (ma con un Pilota Umano)
Immagina di voler costruire un'auto da corsa complessa (il sistema di trading azionario descritto nel paper). Oggi, grazie all'Intelligenza Artificiale (come ChatGPT), hai un meccanico geniale che può scrivere pezzi di motore, suggerire colori e riparare guasti in pochi secondi.
Il problema? Se lasci che il meccanico AI lavori da solo, l'auto rischia di diventare un pasticcio:
- Una parte ha il volante a sinistra, l'altra a destra (naming drift).
- Non sai chi ha deciso cosa e perché (mancanza di tracciabilità).
- Dopo una settimana, non ricordi più come funziona il motore perché le note sono sparite (mancanza di continuità).
Per risolvere questo, l'autore del paper (Ka Ching Chan) ha usato un metodo chiamato SHAPR.
🧭 Che cos'è SHAPR? (Il Manuale di Istruzioni)
SHAPR sta per Solo, Human-centred, AI-assisted PRactice.
In parole povere: "Tu sei il capitano, l'AI è il tuo equipaggio super-veloce, ma la rotta e la responsabilità sono tue."
L'idea non è usare l'AI per fare tutto, ma per usarla come un cantiere intelligente dove tutto è ordinato, documentato e controllato da te.
🛠️ Come hanno costruito l'auto? (La "Configurazione Operativa")
L'autore non ha usato un solo strumento magico, ma ha creato un triangolo di lavoro collegato tra loro, come tre stanze diverse in una casa:
- La Stanza delle Idee (ChatGPT Project): Qui tu e l'AI chiacchierate. L'AI ti aiuta a ragionare, a riassumere idee e a scrivere codice. È come se avessi un assistente che ti sta accanto mentre disegni.
- Il Laboratorio di Costruzione (PyCharm): Qui si costruisce fisicamente l'auto. È dove il codice viene scritto e testato.
- Il Diario di Bordo (Obsidian): Questa è la parte più importante. È un quaderno digitale dove si scrivono tutte le decisioni, i contratti, le riflessioni e le "fotografie" dello stato del progetto.
La magia: Questi tre spazi parlano tra loro. Se cambi qualcosa nel Laboratorio, aggiorni il Diario. Se hai un'idea nella Stanza delle Idee, la scrivi nel Diario.
📸 La Tecnica del "Quick Capture" (Fotografare l'idea)
Uno dei segreti del successo descritto nel paper è il "Quick Capture" (Cattura Rapida).
Immagina di essere in mezzo al traffico e di avere un'idea geniale per migliorare il motore. Se ti fermi a scrivere un saggio di 10 pagine, perdi l'idea e il traffico ti blocca.
Con SHAPR, tu fai una fotografia veloce (una nota breve, un pensiero grezzo) e la butti nel Diario.
- Fase 1: Scrivi subito, senza pensare alla grammatica o alla forma (bassa frizione).
- Fase 2: Più tardi, chiedi all'AI: "Riorganizza questa nota veloce in un documento chiaro".
In questo modo, non perdi mai le idee, ma non perdi tempo a scrivere mentre lavori.
🎓 Le 5 Lezioni Imparate (Cosa abbiamo scoperto)
Dalla costruzione di questo sistema di trading, sono emerse 5 lezioni fondamentali, spiegate con metafore:
- I "Contratti" sono la legge: Prima di far scrivere codice all'AI, devi dirle: "Ehi, questa funzione deve fare solo questo e chiamarsi in questo modo". È come dare al meccanico un disegno preciso: se non lo fai, costruirà pezzi che non si incastrano.
- Il "Diario di Bordo" è la bussola: Devi avere un solo documento principale (Source-of-Truth) che dice sempre "dove siamo ora". Se il diario è vecchio o confuso, l'auto si perde.
- Le "Fotografie" alla fine di ogni tappa: Il lavoro non è un flusso continuo e caotico. Si divide in "cicli". Alla fine di ogni ciclo, fai una foto dello stato dell'auto (Snapshot) e scrivi cosa hai imparato. Quando riprendi il lavoro dopo una pausa, non devi indovinare dove eri, basta guardare la foto.
- Codice e Diario crescono insieme: Non scrivere il codice oggi e il manuale domani. Scrivili insieme. Se cambi il motore, aggiorna subito la pagina del manuale.
- Preparare il cantiere è già lavoro: Passare tempo a organizzare i tool (ChatGPT, PyCharm, Obsidian) e le regole non è tempo perso. È come costruire il garage perfetto prima di iniziare a riparare l'auto: ti fa risparmiare ore di lavoro dopo.
🏁 Conclusione: Perché è importante per tutti?
Questo paper ci dice che l'Intelligenza Artificiale non deve sostituire il nostro pensiero critico, ma potenziarlo.
Se usi l'AI senza regole, rischi di creare un "mostro di Frankenstein" che non capisci più. Se usi il metodo SHAPR, trasformi l'AI in un partner di lavoro disciplinato.
In sintesi:
- Tu sei il regista.
- L'AI è il cameraman e lo scenografo velocissimo.
- SHAPR è la sceneggiatura e il piano di produzione che assicurano che il film (il software) sia coerente, comprensibile e che tutti sappiano chi ha fatto cosa.
Il risultato non è solo un software che funziona, ma una storia chiara di come è stato costruito, che chiunque (anche tra 10 anni) potrà leggere e capire.
Sommerso dagli articoli nel tuo campo?
Ricevi digest giornalieri degli articoli più recenti corrispondenti alle tue parole chiave di ricerca — con riassunti tecnici, nella tua lingua.