Comporre il prompt

Il prompt per un processo nuovo non deve essere lungo: deve contenere le decisioni di dominio. Compila i campi, e a destra trovi il testo pronto da incollare in Claude Code. La bozza resta salvata in questo browser finché non la svuoti.

0 di 5 decisioni di dominio prese

1. Da dove leggere (da decidere)
2. Cosa trasformare (da decidere)
3. Dove scrivere (da decidere)
4. Su quale chiave rendere idempotente la scrittura (da decidere)
5. Cosa fare dei record invalidi (da decidere)

Il processo

NomeDiventa la cartella in src/pipelines/, la voce nel registry e il nome nell'app.Scopo

Da dove leggere

ConnettoreConnessione

Cosa leggere

Cosa trasformare

Una regola per riga

Dove scrivere

ConnettoreConnessione

DoveChiave naturale dell'upsertÈ ciò che rende la scrittura idempotente: rieseguire il processo non duplica dati.

Cosa fare degli errori

Dead-letter Il record invalido va su un sink di scarto e la run prosegue. Fail-fast Il primo record invalido fa fallire la run. Obbligatorio per le aggregazioni.

Un errore di connessione fa fallire la run

Quando

Cadenza

Prompt per Claude Code

/new-pipeline <nome-processo>

Errori
- Un errore di connessione deve far fallire la run (fail-fast).

Mancano 5 decisioni: l'agente si fermerà a chiederle.

Perché queste domande

• Il nome diventa la cartella in src/pipelines/, la voce nell'elenco dei processi e il nome mostrato nell'app. Si scrive in kebab-case, e cambiarlo dopo costa.
• La connessione è il nome di un'istanza di connettore già configurata (per esempio gestionale o dwh): un processo non contiene credenziali, le trova nell'ambiente.
• Le trasformazioni, una per riga, perché ognuna diventa un nodo del grafo. Un nodo per ogni passaggio è ciò che rende leggibile una run nell'app.
• La chiave naturale è ciò che permette di rieseguire il processo senza duplicare dati: la scrittura aggiorna la riga esistente invece di aggiungerne una nuova.
• Dead-letter o fail-fast dipende da cosa significa un record invalido. Una fattura con un importo impossibile si può scartare e recuperare; un'aggregazione a cui manca un pezzo darebbe un totale falso, quindi deve fermarsi.

Dopo aver incollato il prompt

Claude usa /new-pipeline per generare lo scheletro e chiede ciò che manca. Rispondi con decisioni, non con codice: il codice lo scrive lui, secondo le regole del repository. Poi segui i sei passi fino alla Pull Request.