ADR Vault
"Uno strumento che funziona per ragioni misteriose non è uno strumento — è un rituale. Zenzic funziona per ragioni documentate. Questo vault è la prova."
Questa pagina è l'indice completo degli Architectural Decision Records (ADR) del progetto Zenzic. Ogni ADR documenta una decisione tecnica rilevante: il suo contesto (perché esisteva il problema), la sua decisione (cosa è stato scelto) e i suoi invarianti (cosa non deve mai cambiare come conseguenza).
Per il flusso operativo quotidiano, i controlli di rilascio e l'enforcement di governance, usare la guida operativa:
Gli ADR sono la memoria immutabile del progetto. Spiegano non solo cosa fa Zenzic, ma perché. Il comportamento operativo durante commit e push è invece governato dal Protocollo Operativo di Rilascio e Governance.
Decisioni Genesi
Questi ADR definiscono le fondamenta filosofiche e tecniche su cui si basano tutte le decisioni successive.
| ADR | Titolo |
|---|---|
| ADR 001 | Analizza il Sorgente, Non la Build |
| ADR 002 | Policy Zero Subprocesses (Maintainer Only) |
Decisioni di Architettura Core
Questi ADR documentano le decisioni strutturali dell'architettura corrente.
| ADR | Titolo |
|---|---|
| ADR 003 | Root Discovery Protocol |
| ADR 004 | Package CLI Decentralizzata |
| ADR 005 | Agnosticismo Universale Z404 |
| ADR 007 | Sandbox Sovrana (Maintainer Only) |
| ADR 008 | Invariante Strutturale Bilingue |
| ADR 009 | Sovranità del Percorso |
| ADR 013 | The Regex Anti-Corruption Layer (ReDoS Protection) |
| ADR 015 | Validazione Telemetria Nativa |
| ADR 020 | Completezza Audit Parallelo vs. Fail-Fast |
Decisioni del Sito di Documentazione
Questi ADR documentano decisioni architetturali specifiche a questo sito di
documentazione (zenzic.dev) — scelte su come il sito Docusaurus viene costruito,
localizzato e mantenuto.
| ADR | Titolo |
|---|---|
| ADR 006 | Scope di Scansione Unificato (Storage + Blog) |
Guida alla Lettura
Ogni ADR segue una struttura coerente:
-
Contesto — il problema che esisteva prima che la decisione fosse presa.
Leggere il Contesto di un ADR ti dice quale dolore la decisione stava eliminando.
-
Decisione — la scelta che è stata fatta, enunciata con precisione e senza
ambiguità. Se ti chiedi mai "perché Zenzic fa X?", la sezione Decisione dell'ADR pertinente è la risposta.
-
Motivazione — il ragionamento ingegneristico alla base della decisione.
Questa sezione è il "perché non l'alternativa?" — registra gli approcci rifiutati e spiega perché erano insufficienti.
-
Invarianti — i vincoli che non devono mai essere violati come conseguenza
della decisione. Questi sono permanenti. Non scadono con gli incrementi di versione. Una PR che viola un invariante elencato in un ADR è un candidato automatico al revert, indipendentemente dai suoi altri meriti.
-
Conseguenze — i trade-off noti e le capacità che la decisione abilita o
preclude. Leggere le Conseguenze aiuta i contributori a comprendere i confini di ciò che Zenzic può e non può fare per progetto.
Aggiungere un Nuovo ADR
Per la procedura passo dopo passo su come proporre e registrare un nuovo Architectural Decision Record, vedi la guida operativa al protocollo ADR.