An artist’s mind. An engineer’s discipline.

Sam's Blog

La mente di un artista. La disciplina di un ingegnere.

Sono un artista. Sono anche un ingegnere del software. Entrambi fanno parte del mio DNA. Dipingere mi ha dato un altro modo di esplorare le idee e di curare i dettagli che le fanno funzionare.

Oggi uso l’IA per sviluppare ogni software che costruisco per Hearts & Colors: il nostro sito web e gli strumenti interni che mi aiutano a gestire le nostre operazioni. È così che lavoro, ogni giorno. Dà a una piccola azienda lo spazio per fare di più.

Per gli ingegneri del software, imparare a sfruttare l’IA non significa solo restare rilevanti. Amplia ciò che possiamo creare e ci dà tempo per il lavoro che richiede giudizio umano, attenzione e cura. In Hearts & Colors, questa opportunità ha uno scopo: più tempo per prenderci cura gli uni degli altri.

Ma un codice più veloce ha comunque bisogno di un’intenzione chiara. Come sappiamo che ciò che abbiamo costruito è ciò che intendevamo?

Il 7 ottobre ho rilasciato SDD, uno skill per Claude Code e Codex. SDD significa sviluppo guidato dalle specifiche: prima di scrivere il codice, si descrive cosa deve fare il software e come lo si verificherà. Quella descrizione—la specifica—diventa il contratto per costruire e testare il risultato.

Per la comunità dello sviluppo software, SDD offre un modo per mettere al lavoro le capacità dell’IA mantenendo gli ingegneri responsabili del risultato. Il mio skill dà all’agente un processo ripetibile: requisiti verificabili, approvazione umana, implementazione ed evidenze. Il controllo resta a voi.

L’idea centrale è che l’entità di un cambiamento e la garanzia richiesta da un prodotto sono due cose diverse. Poche righe che riguardano i pagamenti o i diritti di accesso possono meritare più attenzione di un grande esperimento. Una dimostrazione rapida non dovrebbe portare la burocrazia di una grande migrazione di sistema.

Ci sono due manopole indipendenti.

L’entità decide la burocrazia. Quanto sta cambiando? Questo determina la struttura della specifica, lo sforzo di pianificazione e i punti di approvazione, da una piccola correzione a un lavoro che richiede documenti di progettazione e contratti separati.

La garanzia decide la prova. Cosa succede se il prodotto sbaglia qualcosa? Questo determina gli scenari, i casi di guasto e la verifica necessaria. Un esperimento può riconoscere i propri limiti. Un software che serve i clienti o riguarda denaro e sicurezza ha bisogno di prove più solide.

Il processo si adatta, da un sito web di una pagina a un lavoro che richiede una garanzia rigorosa.

Questo primo rilascio è la v0. Il flusso di lavoro per i piccoli cambiamenti funziona end-to-end su tutti i livelli di garanzia; le modifiche inline hanno un percorso leggero. Flussi di lavoro più grandi, revisione indipendente e verifiche aggiuntive ad alta garanzia sono nella roadmap. Installare uno skill non rende un sistema conforme a una normativa.

Le specifiche, le approvazioni e le evidenze dei test rimangono insieme al codice. Si può iniziare in Claude Code e continuare in Codex; la sessione successiva ha una documentazione su cui lavorare.

L’amore, la cura e il rispetto guidano la nostra arte e il modo in cui costruiamo questa azienda. Nel software, ciò significa rispettare le persone che dipendono da ciò che creiamo. L’IA può aiutarci a costruire di più; la nostra responsabilità è mettere questa capacità al servizio delle persone.

SDD è disponibile sotto licenza MIT. Se costruite software con l’IA, visitate il repository, leggete la guida delle due manopole e provate un piccolo cambiamento. Issue e contributi sono benvenuti.

Scopri SDD su GitHub