---
name: baia-publish
description: Usa quando prepari, rivedi o pubblichi contenuti editoriali Baialupo, eventi, locandine o aggiornamenti aeronautici destinati alla comunità VDS/AG.
---

# Pubblicazione Baialupo

Leggi `AGENTS.md`, `CONTEXT.md`, `wiki/handoff/programma-articoli.md`, `wiki/handoff/programma-articoli-stato.md` e, per pubblicazione/rollback, `docs/DEPLOYMENT.md` del checkout corrente. Queste sono le fonti operative; la skill non congela un vecchio meccanismo di deploy. Se codice, istruzioni e stato dichiarato divergono, usa `reality-check` prima di procedere.

## Contratto editoriale locale

Scrivi in italiano per piloti, allievi, gestori e appassionati VDS/AG. Apri con l'informazione utile, conserva tono competente, pratico e umano. Per eventi assorbi la locandina nel racconto: non spiegare al lettore il lavoro del redattore. Le sezioni e le emoji seguono gli articoli recenti e le istruzioni attive, non uno schema fisso.

Durante scouting e preparazione considera il programma e il backlog esistente prima di aprire nuove idee. Verifica fatti operativi, date, fonti tecniche e applicabilità; per eventi controlla anche il calendario JP4 e conferma con l'organizzatore. Il calendario di settore non sostituisce PPR/PNR, NOTAM, briefing o istruzioni ufficiali. Distingui norme pubblicate, annunci e interpretazioni; cita le fonti senza copiare lunghi testi.

Conserva frontmatter, categoria, slug e convenzioni del sito. I post vivono sotto `src/content/posts/<categoria>/YYYY-MM-DD-slug.md`; immagini locali sotto `public/img/stories/` o `public/img/covers/`. Usa la data editoriale per `created`/`updated` dei nuovi articoli, non una futura data evento. Non cambiare `created` o slug esistenti senza una ragione verificata. `featured` è legacy: non impostare `featured: 1` come regola per nuovi articoli o badge NEW; vale `CONTEXT.md`.

Percorsi pubblici root-based: `/img/...` e `/<categoria>/<slug>`. Never add `/web/...`: è il prefisso del sito legacy.

La copertina pertinente va anche nel corpo, cliccabile verso l'originale:

```md
[![Alt text](/img/stories/name.jpg)](/img/stories/name.jpg)
```

Per raduni cerca prima la locandina ufficiale. Le card in `src/pages/events/events.md` usano la locandina, non immagini generiche, loghi o cover generate. Esempio del contratto corrente:

```yaml
- link: "/news/<public-slug>"
  image: "/img/stories/<image>.jpg"
  title: "YYYY-MM-DD"
```

Usa il primo giorno dell'evento nella card. In assenza di locandina segui la conferma richiesta dal progetto; non inventare un asset o un'eccezione. Non inventare dettagli operativi nelle immagini generate.

## Direzione artistica delle cover

Per una cover originale usa uno dei **cinque stili approvati**, con i nomi seguenti. La precedente distinzione in due registri tecnico/narrativo non è il catalogo degli stili e non deve restringerne la scelta.

| ID | Stile | Trattamento da riprodurre |
| --- | --- | --- |
| 01 | **[Cinematic Editorial](references/cover-styles/01-cinematic-editorial.png)** | Realismo cinematografico con finitura illustrativa morbida, luce calda, riflessi e profondità. Contorni poco evidenti; niente matita o blueprint imposti. |
| 02 | **[Vibrant Illustration](references/cover-styles/02-vibrant-illustration.png)** | Pittura digitale dichiaratamente illustrata, colori vivaci e saturi, campiture morbide, profondità per piani e composizione scenografica. Non desaturare per uniformarla agli stili tecnici. |
| 03 | **[Technical Blueprint](references/cover-styles/03-technical-blueprint.png)** | Fondo bianco luminoso, linee azzurre sottili, geometrie discrete, superfici pulite e morbide, pochi accenti arancioni e spazio negativo. Niente tratteggio marcato. |
| 04 | **[Technical Sketchbook](references/cover-styles/04-technical-sketchbook.png)** | Carta avorio, grafite e tratteggio manuale selettivo, contorni anche incompleti, colore desaturato applicato a zone, dettagli e schizzi secondari. L'insieme rimane disegnato. |
| 05 | **[Sketch to Reality](references/cover-styles/05-sketch-to-reality.png)** | Transizione graduale sullo stesso soggetto da schizzo in grafite a superfici realistiche tridimensionali. Non è un filtro matita uniforme e non sostituisce Technical Sketchbook. |

Rispetta lo stile indicato dall'utente. In sua assenza proponi quello pertinente al soggetto, senza mescolare automaticamente tutti e cinque. Palette, luce, texture e intensità del segno dipendono dalla reference scelta: non applicare matita, carta avorio o colori attenuati a ogni cover.

Consulta la [documentazione delle reference](references/cover-styles/README.md) per nomi, provenienza e disponibilità dei file. Prima di generare, apri **l'immagine reale dello stile scelto**, dalla directory della skill o dagli originali forniti dall'utente. Un nome file o la descrizione testuale non provano che la reference sia disponibile. Se manca, dichiara il limite senza attestare fedeltà visiva; non sostituirla silenziosamente con un'immagine generica.

Per verificare la continuità con il sito, confronta anche le **cover realmente usate** dagli articoli recenti in `skunklabs-uk/baialupo.com`: leggi il campo `cover` nei post e apri gli asset corrispondenti in `public/img/stories/`. Gli ultimi file per data possono essere fotografie accessorie, non copertine. Le reference definiscono il trattamento, non obbligano a riprodurre il loro soggetto o marchio. Una fotografia pertinente e autorizzata resta preferibile quando prevista da `AGENTS.md`.

### Formato dell'immagine di apertura del sito

La `cover` di un articolo Baialupo è **un'unica immagine panoramica a pieno formato** (target 1672 × 941 px, circa 16:9), destinata alle card e al corpo dell'articolo. Non è una copertina di rivista, un manifesto o una pagina impaginata. Quando servono più cover, prepara **una richiesta autonoma per ogni articolo**, non un'unica richiesta per generare un trittico, una griglia o un collage di cover. Il termine `cover` indica il campo editoriale del sito; al generatore chiedi invece un'**immagine di apertura per UN articolo web**.

Il file di base contiene solo il soggetto e la sua ambientazione, **senza tipografia o impaginazione aggiunta**: niente titoli, testate, numeri di fascicolo, didascalie, banner, loghi, mascotte o watermark. Le scritte nelle reference non sono contenuto da copiare. Se l'articolo richiede espressamente annotazioni verificate, applicale separatamente dopo la generazione; eventuali dettagli illustrati negli stili tecnici riguardano comunque un unico soggetto, non più articoli. Per safety e normativa, non disegnare carte operative, piste, rotte, quote, marchi, aeromobili o installazioni inventati come se fossero documentari; preferisci schemi volutamente astratti o illustrazioni neutrali.

### Prompt riusabile per la sola immagine

```text
Genera UNA SOLA immagine panoramica a pieno formato per l'apertura
di UN articolo web di aviazione leggera. Rapporto 16:9 (target 1672 × 941 px).
È un singolo asset visivo, non una pagina impaginata o copertina di rivista.
Tema: [TEMA]. Soggetto principale: [SOGGETTO].
Dettagli secondari essenziali: [DETTAGLI]. Ambientazione: [LUOGO GENERICO].
Stile visivo: [ID E NOME ESATTO DI UNO DEI CINQUE STILI].
Reference visiva realmente aperta: [FILE O ALLEGATO].
Riproduci questi caratteri osservati: tratto [DESCRIZIONE],
palette [DESCRIZIONE], luce [DESCRIZIONE], texture [DESCRIZIONE].
Soggetto leggibile anche in miniatura; geometria aeronautica credibile.
Non trasferire il soggetto né le scritte della reference.
Se la composizione è già approvata, conserva soggetti, proporzioni e
inquadratura: modifica soltanto il trattamento artistico richiesto.
Output: UNA immagine autonoma, non un collage o trittico di copertine.
Nessuna tipografia aggiunta: no titoli, testate, didascalie, banner o cornici.
Non generare loghi, mascotte, marchi, watermark o simboli Baialupo.
Lascia libero l'angolo [ANGOLO] per l'overlay separato successivo.
```

### Pipeline immagini e logo: due fasi separate

1. **Generazione (agente creativo, quando disponibile):** invia un prompt completo **per un solo articolo alla volta**. Controlla il testo *effettivamente inviato al generatore*, non soltanto il modello di prompt nella skill: deve chiedere un'unica immagine di apertura, non un layout, tre cover affiancate o testi da rivista. Produci e conserva una base senza loghi o elementi grafici sovrapposti. Non richiedere al modello di riprodurre l'SVG.
2. **Postprocessing (agente tecnico distinto, quando disponibile):** prendi l'immagine di base e sovrapponi in un angolo **l'esatto file** `public/img/covers/baialupo-logo-aviator.svg` del repository, senza ridisegno, alterazione di colori, font, proporzioni o parti del marchio. Usa un compositing deterministico con rendering fedele dell'SVG, margini uniformi e dimensioni leggibili sul ritaglio della card. Se il file canonico non è accessibile, ferma soltanto l'overlay e segnala il blocco: non sostituirlo con un logo generato. La presenza di più agenti non è obbligatoria, ma le due fasi e i rispettivi output devono rimanere verificabili.
3. **Review:** verifica prima che la base sia un'unica immagine panoramica riferita a un solo articolo, senza impaginazioni, scritte o marchi aggiunti. Se l'output è un trittico o una pagina da rivista, scartalo prima dell'overlay e correggi la richiesta o cambia approccio, senza ripetere alla cieca prompt equivalenti. Confronta poi la base con il composito finale: l'unica aggiunta ordinaria è l'overlay autentico (identità del marchio, posizione, proporzioni). Confronta tratto, palette, luce e texture con la reference dello stile scelto; una composizione simile non prova una revisione stilistica riuscita. Controlla crop desktop/mobile, leggibilità, geometria aeronautica e coerenza con l'articolo. Se non hai verificato visivamente il risultato, non dichiararlo approvato.

Conserva base e risultato finale almeno durante la review; registra nel lavoro corrente fonte dell'SVG e file finale, senza nuovi registri permanenti. Solo il file finale validato entra nel campo `cover` e nel corpo dell'articolo. Non usare la cover editoriale come locandina in `events.md`.

## Verifica e pubblicazione

La scrittura naturale non deve cancellare cautele o provenienza. Usa `humanize-writing` quando utile, senza cambiare fatti, vincoli e voce Baialupo.

Per modifiche puramente editoriali le istruzioni correnti richiedono `pnpm check`, `pnpm test:editorial` e `pnpm content:export`. Cambi applicativi, CSS, rendering o schema richiedono anche il percorso applicativo e `pnpm build`. Ricontrolla sempre i comandi nel progetto: non richiedere una nuova immagine OCI o un riavvio dei Pod soltanto per un articolo.

Export e CI verde non dimostrano pubblicazione. Verifica autorizzazione, commit `content-live` e revisione effettivamente servita secondo `docs/DEPLOYMENT.md`. Aggiorna lo stato editoriale, le date previste/effettive e i riferimenti coinvolti soltanto per gli esiti provati. Riporta route, file, verifiche e limiti; senza prova live non segnare «pubblicato».
