v2.3.0
Added
docs/package-guidelines.md — come si versiona e si rilascia un pacchetto scrapkit/*.
architecture-guidelines.md diceva già se creare un pacchetto, e il suo terzo criterio chiede che "someone owns its versioning and changelog" — ma nessun documento diceva cosa significhi possederli. Questo è quel documento:
- cosa conta come breaking change, concretamente
- perché
0.xè una sala d'attesa e non una destinazione - tag e release: il tag contiene il proprio changelog e non resta mai fuori da
main - CHANGELOG secondo Keep a Changelog, con le istruzioni di migrazione inline
- deprecare prima di rimuovere
- publish tag, chiavi di config e migration come API pubblica
- constraint
^nei consumer,@v1invece di@mainper i workflow riusabili
Ogni regola cita il rilascio in cui ignorarla è costato qualcosa.
Changed
architecture-guidelines.md rimanda al nuovo documento dal criterio che lo solleva, e claude/CLAUDE.md lo aggiunge ai doc che Claude consulta prima di versionare o rilasciare un pacchetto.