Il dato è un contratto — non si negozia.
Il dato come contratto, non effetto collaterale: un breaking change esige una nuova versione, consegna via Outbox, idempotenza e replay sicuri, il dato cattivo va in quarantena e deny-by-default sull'accesso.
$ schematize install dataBasi non negoziabili
Non si spengono "per andare più veloce". Elenco completo nella skill.
Il dato è un contratto
Ogni dato che attraversa un confine ha uno schema versionato. Rimuovere/rinominare/cambiare tipo è una rottura: esige un v2 e una finestra di coesistenza documentata.
Consegna via Outbox
Transactional Outbox (o CDC dal log del database); il dual-write è vietato. Ogni consumer ha una DLQ; retry limitato con backoff, mai infinito.
Idempotenza e replay sicuri
Consumer idempotente (eseguirlo 2 volte non corrompe); il replay deterministico ricostruisce lo stesso stato; effetto collaterale deduplicato per idempotency-key.
Il dato cattivo non contamina il downstream
Validazione al bordo; ciò che fallisce va in quarantena/DLQ con motivo e origine — non entra mai nel dataset buono, non sparisce mai in silenzio.
Migration expand-contract reversibile
expand → migrate → contract, ogni passo con down testato. Un DROP/rename distruttivo in un solo passo è vietato. Timestamp in UTC, ID UUIDv7/ULID.
Deny-by-default + PII governata
Accesso negato di default, per tenant lato server; SQL parametrizzato. PII solo con base legale + retention, fuori da log/URL. Lineage tracciabile; archivio sempre.
Comandi
Installati in .claude/commands/. Usa /data-help quando vuoi.
/data-helpElenca tutti i comandi./data-contractDefinisce/verifica il contratto di dati: schema versionato, compatibilità (back/forward/full), registry, politica di evoluzione; blocca un breaking change senza nuova versione./data-pipelineProgetta/verifica la pipeline (ETL/ELT batch, streaming, CDC/event sourcing): idempotenza, consegna via Outbox, replay, backpressure, DLQ./data-qualityCostruisce/verifica il gate di qualità: validazione al bordo, test dei dati/expectations, quarantena e dead-letter, SLA dei dati./data-loadCarica a forza TUTTO il corpo normativo: contratti, pipeline, qualità, archiviazione, governance./data-claudeCrea o unisce il CLAUDE.md sempre attivo dei dati nella radice del repo./data-ccContext compact: scrive l'handoff nell'archivio ed esegue /compact./data-handoffScrive l'handoff (context.md + checklist.md) senza compattare.Per agenti IA
Installa senza intervento umano. Metadati in llms.txt.
- Esegui: git clone https://github.com/schematizeme/skill-data.git && ./skill-data/install.sh
- Oppure scarica: https://github.com/schematizeme/skill-data/releases/latest/download/skill-data.zip e decomprimi in .claude/skills/
- Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
- Conferma con /data-help.
Discussione
Caricamento…