Nelle parole della skill
Trasforma un prodotto esistente in un contratto di design scritto. In modalità repository analizza i token, i temi, i primitivi condivisi e le route renderizzate di un prodotto locale e scrive DESIGN.md alla radice di quel prodotto; in modalità URL ricostruisce una bozza a partire dal DOM, dagli stili calcolati e dai fogli di stile caricati, a larghezza desktop e mobile.
Entrambe le modalità condividono un'unica pipeline di evidenze — ruolo, valore, fonte, ambito, ricorrenza, confidenza — e un unico schema di token piatto, con target di esportazione css-tailwind, json-tailwind o dtcg. I valori sopravvivono solo se una fonte autorevole li nomina o superano un controllo a tre prove, e il documento non viene rilasciato finché lint ed esportazione non hanno successo. Non modifica nulla se non DESIGN.md.
Che cosa produce
- Una bozza di DESIGN.md ricostruita e scritta nell'area di lavoro corrente in modalità URL, etichettata come bozza.
- Un report che elenca la modalità e il prodotto o URL analizzato, le fonti autorevoli utilizzate, e i conflitti o le aree non supportate escluse dal documento.
- I risultati finali di lint ed esportazione, che devono entrambi avere esito positivo prima che il documento venga restituito.
Come funziona
- 01Scelta della Modalità
Modalità repository quando è disponibile un repository di prodotto locale, con scrittura di DESIGN.md alla radice di quel prodotto; modalità URL quando viene fornito solo un URL pubblico, producendo una bozza ricostruita nell'area di lavoro corrente.
- 02Raccolta delle Evidenze e Registrazione della Provenienza
Ogni candidato viene registrato con la propria fonte, ambito e ricorrenza prima di qualsiasi normalizzazione, così entrambe le modalità alimentano la stessa pipeline di registrazione.
- 03Normalizzazione nello Schema di DESIGN.md
I candidati incerti, locali senza un contratto, o non rilevanti per l'implementazione vengono scartati; il resto viene mappato nello schema canonico di token piatto.
- 04Blocco della Bozza Dietro la Validazione
Il markdown viene scritto solo dopo che il frontmatter analizzato supera i controlli di forma, così il testo non viene mai redatto prima e poi adattato allo YAML.
- 05Lint ed Esportazione
Viene eseguito prima il lint strutturale, poi un'esportazione di compatibilità nel target selezionato, e ogni categoria popolata deve apparire nell'output.
- 06Report su Modalità, Fonti e Lacune
Il report indica la modalità e il prodotto o URL analizzato, le fonti autorevoli utilizzate, ciò che è stato omesso come non supportato, e i risultati di lint ed esportazione.