Generalizzazione: sostituito clients/{client}/ con {project}/

- 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
This commit is contained in:
AgentePotente 2026-03-11 00:42:52 +01:00
parent 3e926f27eb
commit a29db752af
15 changed files with 159 additions and 160 deletions

View file

@ -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

View file

@ -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) |
---

View file

@ -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 <client_name>
| 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) |
---

View file

@ -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 |
---

View file

@ -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 |
---

View file

@ -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) |
---

View file

@ -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` |
---

View file

@ -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 |
---

View file

@ -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 |
---

View file

@ -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) |
---

View file

@ -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) |
---

View file

@ -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 |
---

View file

@ -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 |
---

View file

@ -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 |
---

View file

@ -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) |
---