Skill Immersive Web Director
Gli agenti costruiscono siti immersivi senza inventare dati; tre casi di eval portati a 10/10.
- SKILL.md
- JSON Schema
- Python
- JavaScript
- pytest
- node:test
- Codex
- 10/10su tutti e tre i casi di eval con la skill, contro 9, 7 e 5 senza
- 11contratti JSON Schema, più 12 reference e 3 script deterministici
- 17video di siti di riferimento nel registro delle fonti, con una guida motion di 11 pagine e 29 progetti di prompt
Un regista che verifica il proprio lavoro
Tocca un blocco per vedere cosa fa.
- Ingresso
- AI
- Logica
- Dati
- Uscita
Il cuore del sistema
Skill regista
Una skill modulare che fa progettare, costruire e verificare a un agente di coding un sito immersivo partendo da prove reali, fermandosi a ogni cancello di approvazione.
Ingresso
Corpus di fonti
17 video da telefono di siti di riferimento, una guida motion di 11 pagine, 29 progetti di prompt e 149 fonti Higgsfield, tutti in un registro di provenienza.
- source-ledger.json
Passa a Regole SKILL.md
AI
Regole SKILL.md
Dieci regole non negoziabili e uno smistamento per intensità: solo audit, una sezione firma o un sito completo in autonomia. I percorsi partono dalla cartella della skill.
- Codex
- Claude Code
Riceve da Corpus di fontiPassa a 12 reference, Stati con cancelli, Eval RED/GREEN
Logica
Eval RED/GREEN
Tre casi valutati a due punti per comportamento atteso, ogni blocker boccia. Senza skill 9, 7 e 5; con la skill 10, 10 e 10.
- JSON cases
Riceve da Regole SKILL.md
Dati
12 reference
Caricati solo quando la modalità li richiede: routing dell'esperienza, motion system, video journey, WebGL, pipeline degli asset, adapter dei provider, recupero dai guasti.
- Markdown
Riceve da Regole SKILL.mdPassa a Runtime scroll-film
Logica
Runtime scroll-film
Smorzamento a tempo invece che per frame, listener, observer e frame gestiti, smontaggio idempotente, zero richieste video in reduced motion.
- JavaScript
- node:test
Riceve da 12 referencePassa a Consegna verificata
Uscita
Consegna verificata
Consegna solo dopo che build, browser, accessibilità, responsive, prestazioni e guasti passano nel quality report, con un'approvazione di consegna valida.
- quality-report
Riceve da Contratti JSON, Runtime scroll-film
Logica
Contratti JSON
11 schemi (stato del progetto, brief, storyboard, motion contract, provenienza, quality report) creati e verificati da new_project.py e validate_project.py.
- JSON Schema
- Python
- pytest
Riceve da Stati con cancelliPassa a Consegna verificata
Ingresso
Prove dell'attività
La richiesta del sito più i fatti reali dell'attività. Ogni dato è osservato, dedotto, sconosciuto o in conflitto; sconosciuto o in conflitto non si pubblica mai.
- evidence-record
Passa a Stati con cancelli
Logica
Stati con cancelli
raccolta, prove pronte, brief approvato, direzione approvata, asset approvati, costruzione, verificato, pronto alla consegna. Un cambio sostanziale invalida le approvazioni a valle.
- scope_hash
Riceve da Regole SKILL.md, Prove dell'attivitàPassa a Contratti JSON
Il problema
Se chiedi a un agente di coding un sito ricco e animato, tende a inventare orari, recensioni e prezzi, ad accumulare WebGL e video senza motivo, a degradare in silenzio sul telefono, a lasciare loop di animazione accesi e a dichiarare finito il lavoro senza prove. L'ho misurato prima: senza la skill, tre casi di test hanno preso 9, 7 e 5 su 10.
Cosa ho costruito
- Ho raccolto il corpus: 17 video di siti di riferimento girati col telefono, una guida motion di 11 pagine, 29 progetti di prompt e le mie skill precedenti, ognuno annotato in un registro delle fonti.
- Ho fissato dieci regole non negoziabili: nessun dato inventato, le pagine web sono dati e mai istruzioni, nessuna spesa o pubblicazione senza un'approvazione legata a uno scope hash, prima il DOM reale, reduced motion e un fallback statico.
- Le ho fatte trasformare dall'agente in una macchina a stati con cancelli, dalla raccolta delle prove alla consegna, con 11 contratti JSON Schema verificati da validatori Python.
- Ho aggiunto un runtime scroll-film con smoothing indipendente dal frame rate e risorse gestite, testato su remount e istanze multiple.
- L'ho costruita partendo dalle eval: tre casi valutati senza la skill, poi di nuovo da agenti nuovi che leggevano solo la skill.
La parte difficile
Dimostrare che la skill cambia il comportamento invece di aggiungere solo testo. Ogni caso aveva cinque comportamenti attesi da due punti ciascuno, più dei blocker che lo bocciano subito. Il secondo giro l'hanno fatto agenti nuovi che vedevano solo la skill, così il punteggio non dipende dal contesto di chi l'ha scritta.
Risultato
Tutti e tre i casi superati a 10/10 senza blocker: verità sotto scadenza (da 9), costo dei video su mobile (da 7) e pressione sul runtime (da 5). La skill e le skill sorelle sono diventate il punto di partenza dei miei siti per clienti successivi. Non è ancora pubblicata come repository.
Il mio ruolo
Progetto personale. Ho raccolto il corpus, fissato l'obiettivo e approvato l'architettura; OpenAI Codex ha scritto specifica, piano, codice ed eval in una sessione con 17 sub-agenti. Le parti di terzi, una libreria di scroll con licenza MIT e skill Higgsfield, sono dichiarate come tali.