diff --git a/agency-archivist/SKILL.md b/agency-archivist/SKILL.md index da25432..a7aa59e 100644 --- a/agency-archivist/SKILL.md +++ b/agency-archivist/SKILL.md @@ -1,8 +1,9 @@ --- name: agency-archivist -description: "Gestire archivi di risorse (immagini, video, documenti) per progetti agency. Usare quando: (1) cliente invia zip/URL di asset, (2) estrarre e organizzare risorse in {project}/assets/, (3) catalogare risorse con descrizioni e tag, (4) cercare risorse per altre skill, (5) richiedere risorse mancanti in modo proattivo." +description: "Gestire archivi di risorse (immagini, video, documenti) per progetti agency. Usare quando: (1) cliente invia zip/URL di asset, (2) estrarre e organizzare risorse in {project}/assets/, (3) catalogare risorse con descrizioni e tag, (4) cercare risorse per altre skill, (5) richiedere risorse mancanti con 3 opzioni: blocco/upload, placeholder mode per continuitΓ  workflow, o skip asset. Supporta pattern placeholder per lavorare senza asset reali." --- + # Agency Archivist β€” Gestione Risorse e Asset Gestisce upload, estrazione, catalogazione e ricerca di risorse multimediali per i progetti della suite. @@ -224,11 +225,25 @@ _Generato: {data} | Totale: {N} risorse_ 1. Leggi `{project}/assets/catalog.md` 2. Cerca risorse per tag/tipo/descrizione -3. Se trovi: Usa path completo -4. Se NON trovi: "πŸ”’ Bloccato: servono [descrizione risorse]" +3. Se trovi: Usa path completo βœ… +4. Se NON trovi: **Scegli una delle 3 opzioni:** + + **OPZIONE A β€” Blocco Task (strict):** + - "πŸ”’ Bloccato: servono [descrizione risorse]" - Tagga: @agency-archivist - - Descrivi: Cosa manca (es. "foto prodotto su sfondo bianco") - - Specifica: Requisiti tecnici (es. "minimo 1000x1000px, JPG") + - Descrivi: Cosa manca + - Attendi upload prima di procedere + + **OPZIONE B β€” Placeholder Mode (consigliata per prototipi):** + - Continua con asset placeholder/generici + - Documenta in output: "⚠️ Usati placeholder per [asset] β€” aggiorna con asset reali" + - Crea sezione "Assets Placeholder" nel deliverable + - Non bloccare il workflow + + **OPZIONE C β€” Skip Asset (se opzionale):** + - Procedi senza quella risorsa specifica + - Adatta il design/contenuto di conseguenza + - Documenta: "⏭️ Asset [nome] omesso β€” spazio riservato" ``` ### **Comportamento Proattivo di Archivist** @@ -237,27 +252,78 @@ _Generato: {data} | Totale: {N} risorse_ 1. **Analizza richiesta:** Cosa serve esattamente? 2. **Verifica catalogo:** Conferma che manca davvero -3. **Risposta strutturata:** +3. **Risposta strutturata con 3 opzioni:** ``` - ⚠️ **Risorse Mancanti** - - Per eseguire [task], servono: + ⚠️ **Risorse Mancanti per [task]** + + Per completare questo task servono: - [ ] Foto prodotto (sfondo bianco, minimo 1000x1000px) - [ ] Logo aziendale (PNG trasparente) - [ ] Brand colors (codici esadecimali) - - **Vuoi caricare queste risorse ora?** - - Opzioni: - 1. Allega zip/URL con gli asset - 2. Descrivi cosa hai a disposizione - 3. Salta per ora (usa placeholder) + + **Come vuoi procedere?** + + 1️⃣ **Upload asset** β€” Allega zip/URL con le risorse reali + 2️⃣ **Descrivi cosa hai** β€” Fornisci dettagli per orientare la ricerca + 3️⃣ **Continua con placeholder** ⚑ β€” Procedi con asset generici/placeholder + (consigliato per prototipi, wireframe, o quando l'asset non Γ¨ critico) ``` 4. **Dopo upload:** Esegui re-scan e aggiorna catalogo 5. **Sblocca skill:** Notifica: "βœ… Risorse pronte, puoi procedere" --- +## Pattern Placeholder per Asset Mancanti + +Quando si sceglie l'**Opzione 3 β€” Continua con placeholder**, seguire questo pattern standardizzato: + +### 1. Identificazione Placeholder + +Per ogni asset mancante, crea un placeholder con: +- **Tipo:** `placeholder` +- **Nome:** `placeholder_[tipo]_[descrizione_breve].[ext]` +- **Dimensioni:** Specificare dimensioni target (es. "1200x800px") +- **Note:** Cosa dovrebbe rappresentare + +### 2. Documentazione nel Deliverable + +Includi sempre una sezione **"Assets Placeholder"** nel deliverable: + +```markdown +## ⚠️ Assets Placeholder + +I seguenti elementi sono stati realizzati con asset generici/placeholder: + +| Posizione | Asset Mancante | Tipo Richiesto | Note | +|-----------|----------------|----------------|------| +| Hero section | `placeholder_hero_product.jpg` | Foto prodotto 1920x1080 | Sfondo hero, prodotto su bianco | +| Logo header | `placeholder_logo.png` | Logo PNG trasparente 512x512 | Logo aziendale | +| Team section | `placeholder_team_01.jpg` | Foto team 800x600 | 3 placeholder per 3 membri | + +**Per completare:** Sostituire i placeholder con asset reali mantenendo le stesse dimensioni e nomi file. +``` + +### 3. Comportamento delle Skill Consumatrici + +Le skill che usano asset (es. agency-visual-generator, agency-web-developer) devono: + +1. **Controllare catalogo:** Verificare se asset esiste o Γ¨ placeholder +2. **Se placeholder:** + - Procedere con il placeholder (non bloccare) + - Aggiungere nota nel deliverable + - Mantenere struttura/layout come se fosse reale +3. **Se asset reale:** Usare normalmente +4. **Documentare sempre:** Lista asset usati (reali o placeholder) nel deliverable + +### 4. Vantaggi del Pattern Placeholder + +- **Prototipi veloci:** Non bloccare workflow per asset mancanti +- **Chiarezza:** Cliente vede esattamente cosa manca +- **Iterazione:** Facile sostituire placeholder con asset reali +- **Testing:** Verificare layout/design prima di avere asset finali + +--- + ## Script ### `scripts/extract_archive.js` diff --git a/agency-design-system/SKILL.md b/agency-design-system/SKILL.md index 809f03f..90b9a43 100644 --- a/agency-design-system/SKILL.md +++ b/agency-design-system/SKILL.md @@ -42,17 +42,26 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. - Colori: `#brand`, `#guidelines` β†’ PDF con palette - Font: `#brand`, `#guidelines` β†’ Specifiche typography -2. **Se risorse mancanti:** - - **FERMATI** e segnala: "πŸ”’ Bloccato: servono brand assets" - - Tagga: @agency-archivist - - Specifica: - ``` - Per creare design system, servono: - - [ ] Logo aziendale (PNG/SVG) - - [ ] Brand colors (codici HEX o documento guidelines) - - [ ] Font (nomi o file font) - ``` - - **Attendi** che archivist carichi e sblocchi +2. **Se risorse mancanti:** **Proporre 3 opzioni** + + **OPZIONE A β€” Blocca e richiedi asset:** + - "πŸ”’ Bloccato: servono brand assets" + - Tagga: @agency-archivist con elenco specifico + - **Attendi** upload prima di procedere + + **OPZIONE B β€” Placeholder Mode (consigliata):** ⚑ + - Procedi con **placeholder tokens**: + - Logo: placeholder box grigio con testo "[LOGO]" + - Colori: palette neutra placeholder (#CCC, #666, #333, #FFF) + - Font: font-stack di sistema (Arial/Helvetica, Georgia/Times) + - Genera design system completo con **sezione "Placeholder Assets"** + - Documenta: sostituzioni da fare quando asset reali saranno disponibili + - **Non bloccare** β€” sviluppo puΓ² iniziare subito + + **OPZIONE C β€” Design system testuale/minimal:** + - Crea design tokens senza riferimenti visivi specifici + - Focus su spacing, tipografia scale, layout principles + - Documenta: "⏭️ Brand assets da integrare β€” design system strutturale pronto" 3. **Typography:** - Font family (primary, secondary) diff --git a/agency-visual-generator/SKILL.md b/agency-visual-generator/SKILL.md index 2fb9e3d..0aef72e 100644 --- a/agency-visual-generator/SKILL.md +++ b/agency-visual-generator/SKILL.md @@ -64,16 +64,23 @@ Genera asset visuali platform-ready basati su content approvato e style guide. - Immagini team: `#team`, `#people` - Sfondi: `#stock`, `#background` -2. **Se risorse mancanti:** - - **FERMATI** e segnala: "πŸ”’ Bloccato: servono [descrizione]" - - Tagga: @agency-archivist - - Specifica requisiti: - ``` - Per generare [tipo asset], servono: - - [ ] Logo aziendale (PNG trasparente, minimo 512x512px) - - [ ] Foto prodotto (sfondo bianco, minimo 1000x1000px) - ``` - - **Attendi** che archivist carichi e sblocchi +2. **Se risorse mancanti:** **Proporre 3 opzioni** + + **OPZIONE A β€” Blocca e richiedi asset:** + - "πŸ”’ Bloccato: servono [descrizione]" + - Tagga: @agency-archivist con requisiti specifici + - **Attendi** upload prima di procedere + + **OPZIONE B β€” Placeholder Mode (consigliata):** ⚑ + - Procedi con **placeholder generici** (color-block, pattern geometrici, testo "[LOGO]", "[FOTO]") + - Genera asset finale ma **documenta in sezione "Assets Placeholder"** + - Esempio placeholder: `placeholder_logo_512x512.png` (box grigio con testo "LOGO") + - **Non bloccare il workflow** β€” cliente puΓ² sostituire dopo + + **OPZIONE C β€” Genera senza asset mancanti:** + - Procedi **omettendo** la risorsa mancante (es. thumbnail senza logo) + - Adatta design di conseguenza + - Documenta: "⏭️ Asset [nome] omesso β€” design adattato" 3. **Carica style guide:** - Cerca `{project}/design/style_guide.md` o `{project}/assets/brand/style_guide.md` diff --git a/agency-web-developer/SKILL.md b/agency-web-developer/SKILL.md index 24c51b2..949d74c 100644 --- a/agency-web-developer/SKILL.md +++ b/agency-web-developer/SKILL.md @@ -45,18 +45,26 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - Immagini pagine: `#team`, `#ufficio`, `#prodotto` β†’ Per pagine interne - Favicon: `#icon`, `#favicon` β†’ Per `` -2. **Se risorse mancanti:** - - **FERMATI** e segnala: "πŸ”’ Bloccato: servono immagini per il sito" - - Tagga: @agency-archivist - - Specifica: - ``` - Per sviluppare il sito, servono: - - [ ] Logo (PNG/SVG, per header) - - [ ] Immagine hero (1920x1080, per homepage) - - [ ] Foto team/prodotto (per pagine interne) - - [ ] Favicon (32x32 o 64x64) - ``` - - **Attendi** che archivist carichi e sblocchi +2. **Se risorse mancanti:** **Proporre 3 opzioni** + + **OPZIONE A β€” Blocca e richiedi asset:** + - "πŸ”’ Bloccato: servono immagini per il sito" + - Tagga: @agency-archivist con elenco specifico + - **Attendi** upload prima di procedere + + **OPZIONE B β€” Placeholder Mode (consigliata):** ⚑ + - Procedi con **placeholder inline** (SVG color-block o gradient) + - Esempi placeholder: + - Logo: `` (stilizzato CSS) + - Hero: `
[HERO IMAGE 1920x1080]
` + - Team: `
` con iniziali + - Genera sito completo ma **documenta in README.md sezione "Assets Placeholder"** + - **Non bloccare** β€” cliente sostituisce asset reali dopo + + **OPZIONE C β€” Genera senza asset visivi:** + - Procedi con **design testuale/minimal** (no immagini, solo tipografia) + - Adatta layout: hero text-only, griglie senza foto + - Documenta: "⏭️ Design minimal β€” immagini da aggiungere in fase 2" 3. **Crea cartella `{project}/website/`**