# SVG Framework - Fase 4 Pilot Libraries

Versione: 2026-04-24
Stato: baseline pilot approvata

---

## 1) Scelta pilot

Librerie incluse nel pilot Fase 4:

1. `lucide` (`skills/svg/assets/libraries/lucide`)
2. `open-peeps` (`skills/svg/assets/libraries/open-peeps`)

Modello operativo pilot (ibrido):

- `lucide` gestita come **submodule** (pin commit + update governato);
- `open-peeps` gestita come **vendor diretto** nel repository (nessun submodule dedicato).

Boundary:

- nessuna terza libreria nel pilot iniziale;
- eventuali estensioni richiedono nuova valutazione Fase 4.

Decisione di chiusura:

- non aggiungere Heroicons, Tabler o Phosphor in questa fase;
- considerarli candidate future solo dopo evidenza di un gap reale non coperto
  da Lucide;
- preferire tooling di discovery sull'indice locale prima di aumentare il
  numero di librerie.

---

## 2) Obiettivo tecnico del pilot

Validare con perimetro minimo:

- gestione ibrida riproducibile (submodule + vendor diretto);
- build/check di `skills/svg/assets/index.json`;
- search agent-facing di `skills/svg/assets/index.json`;
- ricerca locale su due famiglie asset (icone + illustrazioni);
- impatto operativo sostenibile su setup e manutenzione.

---

## 3) Metadati minimi obbligatori per libreria

Per ciascuna libreria il pilot deve tracciare almeno:

- repository upstream;
- strategia di allineamento (`submodule` oppure `vendored`);
- commit/tag/versione di riferimento;
- identificativo licenza e link al testo licenza;
- note attribution/credit (se richieste);
- owner interno per aggiornamenti periodici.

---

## 4) Regole di aggiornamento pilot

- aggiornamenti solo per finestra pianificata (non ad-hoc su task casuali);
- `lucide`: update via submodule con commit pin esplicito;
- `open-peeps`: update via sync vendorizzata tracciata (source ref in changelog locale);
- dopo ogni update: rebuild indice + check + smoke Fase 4;
- se cambia struttura cartelle upstream, aggiornare contestualmente parser/indexer o fallback discovery.

---

## 5) Criterio di uscita dal pilot

Il pilot puo' essere considerato pronto per estensione solo quando:

- tutti i gate A-E della valutazione Fase 4 risultano soddisfatti;
- non emergono regressioni sui workflow Fase 3;
- la policy licenze/attribution e' completa e verificata.