From a29db752af8dcdb7f5051ad1147209c9392f04a8 Mon Sep 17 00:00:00 2001 From: AgentePotente Date: Wed, 11 Mar 2026 00:42:52 +0100 Subject: [PATCH] Generalizzazione: sostituito clients/{client}/ con {project}/ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Sostituite 135 occorrenze di clients/{client}/ con {project}/ - Aggiornati parametri: client_path → project_path in 11 skills - README.md aggiornato con nuova convenzione {project}/ - Struttura cartelle ora agnostica: compatibile con clients/, projects/, o qualsiasi cartella - Maggiore flessibilità per diversi sistemi e workflow Vantaggi: ✅ Compatibile con qualsiasi struttura cartelle ✅ Non impone convenzione 'clients/' ✅ Utile per progetti interni, campagne, o clienti ✅ Più generale e riutilizzabile --- README.md | 23 +++++++++++----------- agency-analytics/SKILL.md | 10 +++++----- agency-archivist/SKILL.md | 20 +++++++++---------- agency-creative-director/SKILL.md | 22 ++++++++++----------- agency-design-system/SKILL.md | 22 ++++++++++----------- agency-orchestrator/SKILL.md | 28 +++++++++++++-------------- agency-publisher/SKILL.md | 16 ++++++++-------- agency-research/SKILL.md | 22 ++++++++++----------- agency-seo/SKILL.md | 18 ++++++++--------- agency-social/SKILL.md | 18 ++++++++--------- agency-strategy/SKILL.md | 26 ++++++++++++------------- agency-ux-copy/SKILL.md | 20 +++++++++---------- agency-visual-generator/SKILL.md | 24 +++++++++++------------ agency-web-developer/SKILL.md | 32 +++++++++++++++---------------- agency-youtube/SKILL.md | 18 ++++++++--------- 15 files changed, 159 insertions(+), 160 deletions(-) diff --git a/README.md b/README.md index fd6f583..118d25c 100644 --- a/README.md +++ b/README.md @@ -142,24 +142,22 @@ agency-skills-suite/ ├── agency-social/ │ └── SKILL.md ├── agency-youtube/ -│ ├── SKILL.md -│ └── references → ../agency-shared-references/references +│ └── SKILL.md ├── agency-visual-generator/ -│ ├── SKILL.md -│ └── references → ../agency-shared-references/references +│ └── SKILL.md ├── agency-web-developer/ -│ ├── SKILL.md -│ └── references → ../agency-shared-references/references +│ └── SKILL.md ├── agency-analytics/ -│ ├── SKILL.md -│ └── references → ../agency-shared-references/references +│ └── SKILL.md ├── agency-publisher/ │ └── SKILL.md -└── agency-youtube/ +└── agency-archivist/ └── SKILL.md ``` -**Nota:** Nessun symlink necessario. Ogni SKILL.md contiene percorsi diretti verso `../agency-shared-references/references/`. +**Nota:** +- Nessun symlink necessario. Ogni SKILL.md contiene percorsi diretti verso `../agency-shared-references/references/`. +- Struttura cartelle: le skills usano `{project}/` come path di lavoro (es. `demo_co_srl/`, `campagna_x/`, o qualsiasi cartella progetto). ## Uso @@ -188,7 +186,7 @@ node scripts/scan_resources.js --client demo_co_srl --pass 1 node scripts/generate_catalog.js --client demo_co_srl ``` -**Risultato:** `clients/{client}/assets/catalog.md` con tutte le risorse catalogate. +**Risultato:** `{project}/assets/catalog.md` con tutte le risorse catalogate. ## Publishing Gates @@ -214,7 +212,8 @@ Vedi documentazione interna per dettagli. - **Lingua:** Skills in inglese, alcune references bilingue (IT/EN) - **Dominio:** Agency digitali, content production, multi-agent coordination - **Complexity:** MEDIUM-HIGH (15 skills, 23 references, workflow coordinati) -- **Architecture:** References centralizzate in agency-shared-references, accessibili tramite symlink da tutte le skills +- **Architecture:** References centralizzate in agency-shared-references, percorsi diretti da tutte le skills +- **Project Structure:** `{project}/` come cartella di lavoro (agnostico, compatibile con qualsiasi sistema) ## Supporto diff --git a/agency-analytics/SKILL.md b/agency-analytics/SKILL.md index c167b8d..20336e4 100644 --- a/agency-analytics/SKILL.md +++ b/agency-analytics/SKILL.md @@ -20,7 +20,7 @@ Report KPI settimanali e azioni misurabili per social e YouTube. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `kpi_definitions` | object | KPI da tracciare | | `dashboards_links` | array | Link a analytics (se disponibili) | | `week_number` | string | Numero settimana (es. "2026-W10") | @@ -179,11 +179,11 @@ Report KPI settimanali e azioni misurabili per social e YouTube. 1. Usa template da `../agency-shared-references/references/weekly_report_template.md` 2. Compila tutte le sezioni -3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md` +3. Salva in `{project}/analytics/weekly_reports/{YYYY-WW}.md` 4. Documenta azioni nel run log del progetto se richiedono follow-up **Output:** -- `clients/{client}/analytics/weekly_reports/YYYY-WW.md` +- `{project}/analytics/weekly_reports/YYYY-WW.md` --- @@ -191,8 +191,8 @@ Report KPI settimanali e azioni misurabili per social e YouTube. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale | -| `clients/{client}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) | +| `{project}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale | +| `{project}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) | --- diff --git a/agency-archivist/SKILL.md b/agency-archivist/SKILL.md index 3aaf5ff..da25432 100644 --- a/agency-archivist/SKILL.md +++ b/agency-archivist/SKILL.md @@ -1,6 +1,6 @@ --- 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 clients/{client}/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 in modo proattivo." --- # Agency Archivist — Gestione Risorse e Asset @@ -22,7 +22,7 @@ Gestisce upload, estrazione, catalogazione e ricerca di risorse multimediali per Ogni progetto ha una cartella dedicata per le risorse: ``` -clients/{client}/ +{project}/ ├── assets/ ← Gestito da agency-archivist │ ├── archive/ # Archivi originali (zip, tar, rar) │ ├── images/ # Immagini estratte @@ -69,16 +69,16 @@ clients/{client}/ 1. **Ricevi input:** Path file, URL o allegato 2. **Valida formato:** Verifica estensione supportata -3. **Crea cartella archive:** `clients/{client}/assets/archive/` +3. **Crea cartella archive:** `{project}/assets/archive/` 4. **Copia/Download:** Sposta file in archive/ -5. **Log operazione:** Registra in `clients/{client}/ops/run_log.md` +5. **Log operazione:** Registra in `{project}/ops/run_log.md` **Esempio Log:** ```markdown ## 2026-03-10 23:30 — Archivist Upload - **Input:** `brand_assets.zip` (allegato) -- **Destinazione:** `clients/demo_co_srl/assets/archive/` +- **Destinazione:** `{project}/assets/archive/` - **Dimensioni:** 15.4 MB - **Status:** ✅ Completato ``` @@ -147,7 +147,7 @@ Per immagini e video: - Contesto (interno/esterno, prodotto/persone) - Tag automatici -**Output:** `clients/{client}/assets/catalog.md` +**Output:** `{project}/assets/catalog.md` --- @@ -222,7 +222,7 @@ _Generato: {data} | Totale: {N} risorse_ ```markdown **Prima di eseguire task che richiedono asset:** -1. Leggi `clients/{client}/assets/catalog.md` +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]" @@ -303,9 +303,9 @@ node scripts/generate_catalog.js --client | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/assets/catalog.md` | Markdown | Catalogo completo risorse | -| `clients/{client}/ops/run_log.md` | Markdown | Log operazioni archivist | -| `clients/{client}/assets/archive/` | Cartella | Archivi originali (opzionale) | +| `{project}/assets/catalog.md` | Markdown | Catalogo completo risorse | +| `{project}/ops/run_log.md` | Markdown | Log operazioni archivist | +| `{project}/assets/archive/` | Cartella | Archivi originali (opzionale) | --- diff --git a/agency-creative-director/SKILL.md b/agency-creative-director/SKILL.md index 20eb1d3..cd5264e 100644 --- a/agency-creative-director/SKILL.md +++ b/agency-creative-director/SKILL.md @@ -20,7 +20,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `strategy_docs` | array | Positioning, messaging (da strategy) | | `reference_library` | array | Referenze visive (da research) | | `brand_constraints` | object | Vincoli brand (colori, font, etc.) | @@ -35,9 +35,9 @@ Definisce la direzione creativa e visiva che guida il design del progetto. **Azioni:** -1. Leggi `clients/{client}/strategy/positioning.md` -2. Leggi `clients/{client}/strategy/messaging.md` -3. Studia `clients/{client}/research/reference_library.md` +1. Leggi `{project}/strategy/positioning.md` +2. Leggi `{project}/strategy/messaging.md` +3. Studia `{project}/research/reference_library.md` 4. Identifica: - Attributi brand (da positioning) - Visual patterns ricorrenti nelle referenze @@ -71,7 +71,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto. - Abstract/3D **Output:** -- Note in `clients/{client}/design/visual_language_notes.md` +- Note in `{project}/design/visual_language_notes.md` --- @@ -122,7 +122,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto. ``` **Output:** -- `clients/{client}/design/creative_direction.md` +- `{project}/design/creative_direction.md` --- @@ -147,7 +147,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto. - Cosa prendere **Output:** -- `clients/{client}/design/moodboard.md` (con immagini o link) +- `{project}/design/moodboard.md` (con immagini o link) --- @@ -186,7 +186,7 @@ Ogni claim supportato da evidence visibile. ``` **Output:** -- `clients/{client}/design/design_principles.md` +- `{project}/design/design_principles.md` --- @@ -194,9 +194,9 @@ Ogni claim supportato da evidence visibile. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/design/creative_direction.md` | Markdown | Direzione creativa | -| `clients/{client}/design/moodboard.md` | Markdown + immagini | Moodboard visiva | -| `clients/{client}/design/design_principles.md` | Markdown | Principi design | +| `{project}/design/creative_direction.md` | Markdown | Direzione creativa | +| `{project}/design/moodboard.md` | Markdown + immagini | Moodboard visiva | +| `{project}/design/design_principles.md` | Markdown | Principi design | --- diff --git a/agency-design-system/SKILL.md b/agency-design-system/SKILL.md index 692073a..809f03f 100644 --- a/agency-design-system/SKILL.md +++ b/agency-design-system/SKILL.md @@ -1,6 +1,6 @@ --- name: agency-design-system -description: "Creare design system coerente con tokens, components e page layouts. PRIMA di iniziare: leggi clients/{client}/assets/catalog.md per logo e brand assets. Se mancano, richiedi @agency-archivist. Usare quando: (1) nuovo progetto needs UI system, (2) standardizzare design, (3) creare component library. Output: Design tokens, components library, page layouts, design system doc." +description: "Creare design system coerente con tokens, components e page layouts. PRIMA di iniziare: leggi {project}/assets/catalog.md per logo e brand assets. Se mancano, richiedi @agency-archivist. Usare quando: (1) nuovo progetto needs UI system, (2) standardizzare design, (3) creare component library. Output: Design tokens, components library, page layouts, design system doc." --- # Agency Visual Designer — Design System @@ -20,7 +20,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `creative_direction` | object | Da creative director | | `design_principles` | array | Principi guida | | `brand_assets` | object | Loghi, colori brand (se esistenti) | @@ -36,7 +36,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. **Azioni:** 1. **LEGGI CATALOGO RISORSE:** - - Apri `clients/{client}/assets/catalog.md` + - Apri `{project}/assets/catalog.md` - Cerca: - Logo: `#logo`, `#brand` → Path per UI - Colori: `#brand`, `#guidelines` → PDF con palette @@ -109,7 +109,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. ``` **Output:** -- `clients/{client}/design/tokens.md` +- `{project}/design/tokens.md` --- @@ -158,7 +158,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. ``` **Output:** -- `clients/{client}/design/components.md` +- `{project}/design/components.md` --- @@ -205,7 +205,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. ``` **Output:** -- `clients/{client}/design/page_layouts.md` +- `{project}/design/page_layouts.md` --- @@ -226,7 +226,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. 2. Includi esempi visivi (se possibile) **Output:** -- `clients/{client}/design/design_system.md` +- `{project}/design/design_system.md` --- @@ -234,10 +234,10 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/design/tokens.md` | Markdown | Design tokens | -| `clients/{client}/design/components.md` | Markdown | Component library | -| `clients/{client}/design/page_layouts.md` | Markdown | Page layouts | -| `clients/{client}/design/design_system.md` | Markdown | Design system completo | +| `{project}/design/tokens.md` | Markdown | Design tokens | +| `{project}/design/components.md` | Markdown | Component library | +| `{project}/design/page_layouts.md` | Markdown | Page layouts | +| `{project}/design/design_system.md` | Markdown | Design system completo | --- diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index e326adc..667a3d5 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -134,7 +134,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile **Gestione campi mancanti:** - Se un campo non è trovabile nel documento, fai un'assunzione ragionevole basata sul contesto -- Documenta tutte le assunzioni in `clients/{client}/ops/decisions.md` +- Documenta tutte le assunzioni in `{project}/ops/decisions.md` - Segnala all'utente i campi con assunzioni e chiedi conferma o correzione prima di procedere **Vantaggi Modalità B:** @@ -157,14 +157,14 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile - **Modalità A (Questionario):** Usa dati compilati dal cliente - **Modalità B (Documento):** Estrai informazioni automaticamente (vedi sezione sopra) -2. **Proposta path cliente:** - - Proponi: `clients/{nome_cliente_lowercase}/` - - Esempio: `clients/demo_co_srl/` +2. **Proposta path progetto:** + - Proponi: `{project}/` (es. `{nome_cliente_lowercase}/` o nome progetto) + - Esempio: `demo_co_srl/` oppure `campagna_prodotto_x/` - **Chiedi conferma esplicita** prima di procedere 3. **Dopo conferma, crea struttura cartelle:** ``` - clients/{client}/ + {project}/ ├── knowledge/ (company profile, audience, brand) ├── research/ (competitor, market insights) ├── strategy/ (positioning, messaging, pillars) @@ -177,14 +177,14 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile 4. **Leggi `../agency-shared-references/references/quality_bar.md`** per standard di qualità -5. **Registra assunzioni in `clients/{client}/ops/decisions.md`** +5. **Registra assunzioni in `{project}/ops/decisions.md`** 6. **(Opzionale) Upload risorse:** - **Chiedi:** "Hai un archivio di risorse (immagini, logo, brand assets) da caricare?" - **Se SI:** Ricevi zip/URL e triggera `agency-archivist` - **Workflow:** ``` - a. agency-archivist estrae archivio in clients/{client}/assets/ + a. agency-archivist estrae archivio in {project}/assets/ b. Scansiona risorse e genera metadata c. Crea catalog.md con descrizione e tag d. Notifica orchestrator: "✅ Risorse pronte" @@ -237,7 +237,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile 1. Raccogli output da tutti gli agenti 2. Verifica coerenza cross-deliverable 3. Esegui QA checklist (vedi `../agency-shared-references/references/quality_bar.md`) -4. Crea `clients/{client}/ops/qa_notes.md` con issue + fix proposti +4. Crea `{project}/ops/qa_notes.md` con issue + fix proposti **QA Checklist:** - [ ] Output in path corretto @@ -281,7 +281,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile - Nome cliente ↓ 3. agency-archivist esegue: - - Estrazione in clients/{client}/assets/ + - Estrazione in {project}/assets/ - Scansione e catalogazione - Generazione catalog.md ↓ @@ -322,7 +322,7 @@ Esempio: agency-visual-generator deve creare social post ma mancano foto prodott ### Struttura Cartelle Assets ``` -clients/{client}/assets/ +{project}/assets/ ├── archive/ # Archivi originali (zip, tar) ├── images/ # Immagini estratte │ ├── logo/ # Loghi aziendali @@ -343,7 +343,7 @@ clients/{client}/assets/ **Prima di eseguire task che richiedono asset:** ```markdown -1. Leggi `clients/{client}/assets/catalog.md` +1. Leggi `{project}/assets/catalog.md` 2. Cerca risorse per tag/tipo/descrizione 3. Se trovi: Usa path completo 4. Se NON trovi: @@ -365,9 +365,9 @@ clients/{client}/assets/ | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/ops/decisions.md` | Markdown | Decisioni e assunzioni | -| `clients/{client}/ops/qa_notes.md` | Markdown | Issue QA + fix proposti | -| `clients/{client}/ops/run_log.md` | Markdown | Log operativo (opzionale) | +| `{project}/ops/decisions.md` | Markdown | Decisioni e assunzioni | +| `{project}/ops/qa_notes.md` | Markdown | Issue QA + fix proposti | +| `{project}/ops/run_log.md` | Markdown | Log operativo (opzionale) | --- diff --git a/agency-publisher/SKILL.md b/agency-publisher/SKILL.md index b38fd69..02cae7e 100644 --- a/agency-publisher/SKILL.md +++ b/agency-publisher/SKILL.md @@ -20,7 +20,7 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `content_files` | array | File content da pubblicare | | `platform` | string | "social" / "youtube" | | `publish_mode` | string | "immediate" / "scheduled" | @@ -67,7 +67,7 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic - **YouTube:** Title, description, thumbnail_path, tags, scheduled_for 2. Genera `idempotency_key`: - - Formula: `{client}_{platform}_{post_id}_{version}` + - Formula: `{project}_{platform}_{post_id}_{version}` - Esempio: `demo_co_linkedin_post_001_v1` 3. Compila payload: @@ -161,7 +161,7 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic **Azioni:** -1. Apri/crea `clients/{client}/ops/publish_log.md` +1. Apri/crea `{project}/ops/publish_log.md` 2. Aggiungi entry: @@ -176,8 +176,8 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic | 2026-03-09 | YouTube | ep_001 | Scheduled | - | Publish: 2026-03-10 14:00 | ``` -3. Per YouTube, aggiorna anche `clients/{client}/youtube/published_log.md` -4. Per Social, aggiorna `clients/{client}/social/published_log.md` +3. Per YouTube, aggiorna anche `{project}/youtube/published_log.md` +4. Per Social, aggiorna `{project}/social/published_log.md` --- @@ -185,9 +185,9 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/ops/publish_log.md` | Markdown | Log centrale publish | -| `clients/{client}/social/published_log.md` | Markdown | Log social (opzionale) | -| `clients/{client}/youtube/published_log.md` | Markdown | Log YouTube (opzionale) | +| `{project}/ops/publish_log.md` | Markdown | Log centrale publish | +| `{project}/social/published_log.md` | Markdown | Log social (opzionale) | +| `{project}/youtube/published_log.md` | Markdown | Log YouTube (opzionale) | | Content files aggiornati | Markdown | `status: published/scheduled` | --- diff --git a/agency-research/SKILL.md b/agency-research/SKILL.md index 736df64..be4c4ec 100644 --- a/agency-research/SKILL.md +++ b/agency-research/SKILL.md @@ -20,7 +20,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `competitors` | array | Lista competitor (min 3) | | `research_type` | string | "competitor" / "reference" / "both" | | `focus_areas` | array | Aree di focus (es. positioning, visual, UX) | @@ -88,7 +88,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. 2. Logga fonti in `sources_log.md` con ID `SRC-###` **Output:** -- `clients/{client}/research/competitor_teardowns.md` +- `{project}/research/competitor_teardowns.md` --- @@ -123,7 +123,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. ``` **Output:** -- `clients/{client}/research/opportunity_map.md` +- `{project}/research/opportunity_map.md` --- @@ -160,7 +160,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. 3. Logga fonti con ID `SRC-###` **Output:** -- `clients/{client}/research/reference_library.md` +- `{project}/research/reference_library.md` --- @@ -183,7 +183,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. - Esempio (screenshot o link) **Output:** -- `clients/{client}/research/pattern_catalog.md` +- `{project}/research/pattern_catalog.md` --- @@ -215,7 +215,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. ``` **Output:** -- `clients/{client}/research/sources_log.md` +- `{project}/research/sources_log.md` --- @@ -223,11 +223,11 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor | -| `clients/{client}/research/opportunity_map.md` | Markdown | Insight prioritizzati | -| `clients/{client}/research/reference_library.md` | Markdown | 10-15 referenze | -| `clients/{client}/research/pattern_catalog.md` | Markdown | Pattern catalog | -| `clients/{client}/research/sources_log.md` | Markdown | Log fonti | +| `{project}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor | +| `{project}/research/opportunity_map.md` | Markdown | Insight prioritizzati | +| `{project}/research/reference_library.md` | Markdown | 10-15 referenze | +| `{project}/research/pattern_catalog.md` | Markdown | Pattern catalog | +| `{project}/research/sources_log.md` | Markdown | Log fonti | --- diff --git a/agency-seo/SKILL.md b/agency-seo/SKILL.md index 9a9c2e0..f2a993d 100644 --- a/agency-seo/SKILL.md +++ b/agency-seo/SKILL.md @@ -20,7 +20,7 @@ SEO tecnico, metadata e schema markup per visibilità search. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `website_pages` | array | Lista pagine da ottimizzare | | `copy_docs` | array | Copy pagine (da ux-copy) | | `keyword_seed` | array | Keyword iniziali (opzionale) | @@ -65,7 +65,7 @@ SEO tecnico, metadata e schema markup per visibilità search. ``` **Output:** -- `clients/{client}/website/seo/keywords.md` +- `{project}/website/seo/keywords.md` --- @@ -111,7 +111,7 @@ SEO tecnico, metadata e schema markup per visibilità search. ``` **Output:** -- `clients/{client}/website/seo/meta_library.md` +- `{project}/website/seo/meta_library.md` --- @@ -175,7 +175,7 @@ SEO tecnico, metadata e schema markup per visibilità search. ``` **Output:** -- `clients/{client}/website/seo/schema_notes.md` +- `{project}/website/seo/schema_notes.md` --- @@ -203,7 +203,7 @@ SEO tecnico, metadata e schema markup per visibilità search. ``` **Output:** -- `clients/{client}/website/changelog.md` +- `{project}/website/changelog.md` --- @@ -211,10 +211,10 @@ SEO tecnico, metadata e schema markup per visibilità search. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/website/seo/keywords.md` | Markdown | Keyword seed list | -| `clients/{client}/website/seo/meta_library.md` | Markdown | Title e meta per pagine | -| `clients/{client}/website/seo/schema_notes.md` | Markdown | Schema markup plans | -| `clients/{client}/website/changelog.md` | Markdown | SEO changelog | +| `{project}/website/seo/keywords.md` | Markdown | Keyword seed list | +| `{project}/website/seo/meta_library.md` | Markdown | Title e meta per pagine | +| `{project}/website/seo/schema_notes.md` | Markdown | Schema markup plans | +| `{project}/website/changelog.md` | Markdown | SEO changelog | --- diff --git a/agency-social/SKILL.md b/agency-social/SKILL.md index d0f9e0b..2c24f1e 100644 --- a/agency-social/SKILL.md +++ b/agency-social/SKILL.md @@ -20,7 +20,7 @@ Social strategy, calendario editoriale e post queue con visual brief. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `content_pillars` | array | Da strategy | | `brand_voice` | object | Tone of voice | | `platforms` | array | Piattaforme target (LinkedIn, Instagram, X) | @@ -71,7 +71,7 @@ Social strategy, calendario editoriale e post queue con visual brief. ``` **Output:** -- `clients/{client}/social/social_strategy.md` +- `{project}/social/social_strategy.md` --- @@ -109,7 +109,7 @@ Social strategy, calendario editoriale e post queue con visual brief. ``` **Output:** -- `clients/{client}/social/calendar.md` +- `{project}/social/calendar.md` --- @@ -158,7 +158,7 @@ Social strategy, calendario editoriale e post queue con visual brief. 2. Crea minimo 10 post (mix di pillar e formati) **Output:** -- `clients/{client}/social/posts/post_001.md` ... `post_010.md` +- `{project}/social/posts/post_001.md` ... `post_010.md` --- @@ -175,7 +175,7 @@ Social strategy, calendario editoriale e post queue con visual brief. - Performance (se disponibili) **Output:** -- `clients/{client}/social/published_log.md` +- `{project}/social/published_log.md` --- @@ -183,10 +183,10 @@ Social strategy, calendario editoriale e post queue con visual brief. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/social/social_strategy.md` | Markdown | Strategy per piattaforma | -| `clients/{client}/social/calendar.md` | Markdown | Calendario 4 settimane | -| `clients/{client}/social/posts/*.md` | Markdown | 10+ post in queue | -| `clients/{client}/social/published_log.md` | Markdown | Log publish (opzionale) | +| `{project}/social/social_strategy.md` | Markdown | Strategy per piattaforma | +| `{project}/social/calendar.md` | Markdown | Calendario 4 settimane | +| `{project}/social/posts/*.md` | Markdown | 10+ post in queue | +| `{project}/social/published_log.md` | Markdown | Log publish (opzionale) | --- diff --git a/agency-strategy/SKILL.md b/agency-strategy/SKILL.md index 4c386f8..afd2118 100644 --- a/agency-strategy/SKILL.md +++ b/agency-strategy/SKILL.md @@ -20,7 +20,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client (es. `clients/demo_co/`) | +| `project_path` | string | Percorso progetto (es. `demo_co/` o `campagna_x/`) | | `company_profile` | object | Profilo azienda (da knowledge o input) | | `audience_data` | object | Dati audience (personas, ICP) | | `competitor_insights` | array | Insight da research competitor | @@ -36,16 +36,16 @@ Definisce la direzione strategica di un brand: positioning, messaging e content **Azioni:** -1. Leggi `clients/{client}/knowledge/company_profile.md` -2. Leggi `clients/{client}/knowledge/audience.md` (o crea da template) -3. Leggi `clients/{client}/research/competitor_teardowns.md` (se esiste) +1. Leggi `{project}/knowledge/company_profile.md` +2. Leggi `{project}/knowledge/audience.md` (o crea da template) +3. Leggi `{project}/research/competitor_teardowns.md` (se esiste) 4. Identifica: - Problema principale che l'azienda risolve - Audience primaria e secondaria - Differentiatori vs competitor **Output intermedi:** -- Note di analisi in `clients/{client}/strategy/analysis_notes.md` +- Note di analisi in `{project}/strategy/analysis_notes.md` --- @@ -68,7 +68,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content 3. Scrivi positioning statement finale (1-2 frasi) **Output:** -- `clients/{client}/strategy/positioning.md` +- `{project}/strategy/positioning.md` --- @@ -106,7 +106,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content ``` **Output:** -- `clients/{client}/strategy/messaging.md` +- `{project}/strategy/messaging.md` --- @@ -132,7 +132,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content | Behind the Scenes | Mostrare processo | Process snippet, team | **Output:** -- `clients/{client}/strategy/content_pillars.md` +- `{project}/strategy/content_pillars.md` --- @@ -150,7 +150,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content 3. Identifica KPI di successo **Output:** -- `clients/{client}/strategy/go_to_market.md` +- `{project}/strategy/go_to_market.md` --- @@ -158,10 +158,10 @@ Definisce la direzione strategica di un brand: positioning, messaging e content | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/strategy/positioning.md` | Markdown | Positioning statement | -| `clients/{client}/strategy/messaging.md` | Markdown | Messaging house | -| `clients/{client}/strategy/content_pillars.md` | Markdown | 4-6 content pillars | -| `clients/{client}/strategy/go_to_market.md` | Markdown | GTM plan (opzionale) | +| `{project}/strategy/positioning.md` | Markdown | Positioning statement | +| `{project}/strategy/messaging.md` | Markdown | Messaging house | +| `{project}/strategy/content_pillars.md` | Markdown | 4-6 content pillars | +| `{project}/strategy/go_to_market.md` | Markdown | GTM plan (opzionale) | --- diff --git a/agency-ux-copy/SKILL.md b/agency-ux-copy/SKILL.md index fdaaf2d..ea8e855 100644 --- a/agency-ux-copy/SKILL.md +++ b/agency-ux-copy/SKILL.md @@ -20,7 +20,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `strategy_docs` | array | Positioning, messaging, content pillars | | `design_layouts` | array | Page layouts (da design system) | | `seo_keywords` | array | Keyword seed (se disponibili) | @@ -73,7 +73,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. ``` **Output:** -- `clients/{client}/website/sitemap.md` +- `{project}/website/sitemap.md` --- @@ -121,7 +121,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. ``` **Output:** -- `clients/{client}/website/pages/{page_name}.md` +- `{project}/website/pages/{page_name}.md` --- @@ -158,7 +158,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. - Proof ovunque possibile **Output:** -- Copy completo in `clients/{client}/website/pages/*.md` +- Copy completo in `{project}/website/pages/*.md` --- @@ -188,7 +188,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. ``` **Output:** -- `clients/{client}/website/seo/meta.md` +- `{project}/website/seo/meta.md` --- @@ -209,7 +209,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. 3. Compila QA checklist **Output:** -- `clients/{client}/website/qa/qa_website.md` +- `{project}/website/qa/qa_website.md` --- @@ -217,10 +217,10 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/website/sitemap.md` | Markdown | Architettura sito | -| `clients/{client}/website/pages/*.md` | Markdown | Copy pagine | -| `clients/{client}/website/seo/meta.md` | Markdown | SEO metadata | -| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist | +| `{project}/website/sitemap.md` | Markdown | Architettura sito | +| `{project}/website/pages/*.md` | Markdown | Copy pagine | +| `{project}/website/seo/meta.md` | Markdown | SEO metadata | +| `{project}/website/qa/qa_website.md` | Markdown | QA checklist | --- diff --git a/agency-visual-generator/SKILL.md b/agency-visual-generator/SKILL.md index db80eae..8b2cf58 100644 --- a/agency-visual-generator/SKILL.md +++ b/agency-visual-generator/SKILL.md @@ -1,6 +1,6 @@ --- name: agency-visual-generator -description: "Generare asset visuali (card, carousel, thumbnail) per social e YouTube basati su content approvato e style guide. Usare quando: (1) post social needs visual, (2) YouTube thumbnail, (3) carousel Instagram/LinkedIn. PRIMA di generare: leggi clients/{client}/assets/catalog.md per risorse disponibili. Se mancano risorse, richiedi @agency-archivist. Output: Asset PNG/webp in cartella client, QA visual compilato." +description: "Generare asset visuali (card, carousel, thumbnail) per social e YouTube basati su content approvato e style guide. Usare quando: (1) post social needs visual, (2) YouTube thumbnail, (3) carousel Instagram/LinkedIn. PRIMA di generare: leggi {project}/assets/catalog.md per risorse disponibili. Se mancano risorse, richiedi @agency-archivist. Output: Asset PNG/webp in cartella client, QA visual compilato." --- # Agency Visual Generator — Asset Visuali @@ -20,7 +20,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `content_files` | array | Post o script che richiedono visual | | `style_guide` | object | Style guide cliente (colori, font) | | `asset_type` | string | "card" / "carousel" / "thumbnail" | @@ -57,7 +57,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide. **Azioni:** 1. **LEGGI CATALOGO RISORSE:** - - Apri `clients/{client}/assets/catalog.md` + - Apri `{project}/assets/catalog.md` - Cerca risorse per il task: - Logo: `#logo`, `#brand` - Foto prodotto: `#prodotto`, `#product` @@ -76,7 +76,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide. - **Attendi** che archivist carichi e sblocchi 3. **Carica style guide:** - - Cerca `clients/{client}/design/style_guide.md` o `clients/{client}/assets/brand/style_guide.md` + - Cerca `{project}/design/style_guide.md` o `{project}/assets/brand/style_guide.md` - Se esiste: Carica colori, font, logo path - Se NON esiste: Crea draft e chiedi approvazione @@ -160,9 +160,9 @@ Genera asset visuali platform-ready basati su content approvato e style guide. 2. Passa JSON template come prompt strutturato 3. Genera immagine PNG/webp 4. Salva in: - - `clients/{client}/assets/social/{post_id}.png` - - `clients/{client}/assets/youtube/thumbnails/{ep_id}.png` - - `clients/{client}/assets/social/carousels/{id}/slide_01.png`, etc. + - `{project}/assets/social/{post_id}.png` + - `{project}/assets/youtube/thumbnails/{ep_id}.png` + - `{project}/assets/social/carousels/{id}/slide_01.png`, etc. 5. Aggiorna content file con `asset_path` @@ -196,7 +196,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide. - [ ] No artifacts / broken text - [ ] Safe margins for UI overlays -2. Registra risultato in `clients/{client}/assets/qa/qa_visual.md` +2. Registra risultato in `{project}/assets/qa/qa_visual.md` **Template:** @@ -230,10 +230,10 @@ Genera asset visuali platform-ready basati su content approvato e style guide. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/assets/social/*.png` | PNG/webp | Card social | -| `clients/{client}/assets/social/carousels/*/slide_*.png` | PNG | Carousel slides | -| `clients/{client}/assets/youtube/thumbnails/*.png` | PNG | YouTube thumbnail | -| `clients/{client}/assets/qa/qa_visual.md` | Markdown | QA checklist | +| `{project}/assets/social/*.png` | PNG/webp | Card social | +| `{project}/assets/social/carousels/*/slide_*.png` | PNG | Carousel slides | +| `{project}/assets/youtube/thumbnails/*.png` | PNG | YouTube thumbnail | +| `{project}/assets/qa/qa_visual.md` | Markdown | QA checklist | --- diff --git a/agency-web-developer/SKILL.md b/agency-web-developer/SKILL.md index ad2a248..24c51b2 100644 --- a/agency-web-developer/SKILL.md +++ b/agency-web-developer/SKILL.md @@ -1,6 +1,6 @@ --- name: agency-web-developer -description: "Sviluppare siti web statici o landing page partendo da copy e design system. PRIMA di sviluppare: leggi clients/{client}/assets/catalog.md per immagini e asset. Se mancano, richiedi @agency-archivist. Usare quando: (1) costruire sito da sitemap + copy, (2) creare landing page, (3) implementare design in HTML/CSS/JS. Output: Sito completo con HTML semantico, CSS (Bootstrap o custom), JS (jQuery + GSAP)." +description: "Sviluppare siti web statici o landing page partendo da copy e design system. PRIMA di sviluppare: leggi {project}/assets/catalog.md per immagini e asset. Se mancano, richiedi @agency-archivist. Usare quando: (1) costruire sito da sitemap + copy, (2) creare landing page, (3) implementare design in HTML/CSS/JS. Output: Sito completo con HTML semantico, CSS (Bootstrap o custom), JS (jQuery + GSAP)." --- # Agency Web Developer — Sviluppo Siti Web Statici @@ -20,7 +20,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `sitemap` | object | Da agency-ux-copy | | `page_copy` | array | Copy completo per ogni pagina | | `design_tokens` | object | Da agency-design-system | @@ -38,7 +38,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e **Azioni:** 1. **LEGGI CATALOGO RISORSE:** - - Apri `clients/{client}/assets/catalog.md` + - Apri `{project}/assets/catalog.md` - Cerca: - Logo: `#logo` → Per header/footer - Immagini hero: `#hero`, `#sfondo`, `#prodotto` → Per homepage @@ -58,7 +58,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e ``` - **Attendi** che archivist carichi e sblocchi -3. **Crea cartella `clients/{client}/website/`** +3. **Crea cartella `{project}/website/`** 4. **Crea sottocartelle:** - `index.html` (homepage) @@ -70,7 +70,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - `assets/fonts/` 5. **Collega asset da archivio:** - - Crea symlink o copia da `clients/{client}/assets/` a `website/assets/` + - Crea symlink o copia da `{project}/assets/` a `website/assets/` - Oppure usa path relativi: `../assets/images/logo/logo.png` 6. **Inizializza file base:** @@ -138,8 +138,8 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - SEO on-page (heading structure, alt text) **Output:** -- `clients/{client}/website/index.html` -- `clients/{client}/website/pages/*.html` +- `{project}/website/index.html` +- `{project}/website/pages/*.html` --- @@ -189,7 +189,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - Footer **Output:** -- `clients/{client}/website/css/main.css` (o `bootstrap.min.css` + `custom.css`) +- `{project}/website/css/main.css` (o `bootstrap.min.css` + `custom.css`) --- @@ -290,7 +290,7 @@ $(document).ready(function() { ``` **Output:** -- `clients/{client}/website/js/main.js` +- `{project}/website/js/main.js` --- @@ -327,7 +327,7 @@ $(document).ready(function() { - No console warnings **Output:** -- `clients/{client}/website/qa/qa_website.md` +- `{project}/website/qa/qa_website.md` --- @@ -335,12 +335,12 @@ $(document).ready(function() { | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/website/index.html` | HTML | Homepage | -| `clients/{client}/website/pages/*.html` | HTML | Altre pagine | -| `clients/{client}/website/css/main.css` | CSS | Stylesheet | -| `clients/{client}/website/js/main.js` | JS | Interattività | -| `clients/{client}/website/assets/` | Folder | Immagini, font, etc. | -| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist | +| `{project}/website/index.html` | HTML | Homepage | +| `{project}/website/pages/*.html` | HTML | Altre pagine | +| `{project}/website/css/main.css` | CSS | Stylesheet | +| `{project}/website/js/main.js` | JS | Interattività | +| `{project}/website/assets/` | Folder | Immagini, font, etc. | +| `{project}/website/qa/qa_website.md` | Markdown | QA checklist | --- diff --git a/agency-youtube/SKILL.md b/agency-youtube/SKILL.md index a6617da..f27f919 100644 --- a/agency-youtube/SKILL.md +++ b/agency-youtube/SKILL.md @@ -20,7 +20,7 @@ Strategia YouTube, calendario e script orientati a retention. | Input | Tipo | Validazione | |-------|------|-------------| -| `client_path` | string | Percorso client | +| `project_path` | string | Percorso progetto (cartella di lavoro) | | `content_pillars` | array | Da strategy | | `brand_voice` | object | Tone of voice | | `target_audience` | object | Audience YouTube | @@ -78,7 +78,7 @@ Strategia YouTube, calendario e script orientati a retention. ``` **Output:** -- `clients/{client}/youtube/youtube_strategy.md` +- `{project}/youtube/youtube_strategy.md` --- @@ -109,7 +109,7 @@ Strategia YouTube, calendario e script orientati a retention. ``` **Output:** -- `clients/{client}/youtube/calendar.md` +- `{project}/youtube/calendar.md` --- @@ -187,7 +187,7 @@ Strategia YouTube, calendario e script orientati a retention. ``` **Output:** -- `clients/{client}/youtube/scripts/ep_001.md`, `ep_002.md`, etc. +- `{project}/youtube/scripts/ep_001.md`, `ep_002.md`, etc. --- @@ -203,7 +203,7 @@ Strategia YouTube, calendario e script orientati a retention. - Performance (views, retention, etc.) **Output:** -- `clients/{client}/youtube/published_log.md` +- `{project}/youtube/published_log.md` --- @@ -211,10 +211,10 @@ Strategia YouTube, calendario e script orientati a retention. | File | Formato | Descrizione | |------|---------|-------------| -| `clients/{client}/youtube/youtube_strategy.md` | Markdown | Strategy canale | -| `clients/{client}/youtube/calendar.md` | Markdown | Calendario episodi | -| `clients/{client}/youtube/scripts/*.md` | Markdown | 2+ script completi | -| `clients/{client}/youtube/published_log.md` | Markdown | Log publish (opzionale) | +| `{project}/youtube/youtube_strategy.md` | Markdown | Strategy canale | +| `{project}/youtube/calendar.md` | Markdown | Calendario episodi | +| `{project}/youtube/scripts/*.md` | Markdown | 2+ script completi | +| `{project}/youtube/published_log.md` | Markdown | Log publish (opzionale) | ---