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:
parent
3e926f27eb
commit
a29db752af
15 changed files with 159 additions and 160 deletions
23
README.md
23
README.md
|
|
@ -142,24 +142,22 @@ agency-skills-suite/
|
||||||
├── agency-social/
|
├── agency-social/
|
||||||
│ └── SKILL.md
|
│ └── SKILL.md
|
||||||
├── agency-youtube/
|
├── agency-youtube/
|
||||||
│ ├── SKILL.md
|
│ └── SKILL.md
|
||||||
│ └── references → ../agency-shared-references/references
|
|
||||||
├── agency-visual-generator/
|
├── agency-visual-generator/
|
||||||
│ ├── SKILL.md
|
│ └── SKILL.md
|
||||||
│ └── references → ../agency-shared-references/references
|
|
||||||
├── agency-web-developer/
|
├── agency-web-developer/
|
||||||
│ ├── SKILL.md
|
│ └── SKILL.md
|
||||||
│ └── references → ../agency-shared-references/references
|
|
||||||
├── agency-analytics/
|
├── agency-analytics/
|
||||||
│ ├── SKILL.md
|
│ └── SKILL.md
|
||||||
│ └── references → ../agency-shared-references/references
|
|
||||||
├── agency-publisher/
|
├── agency-publisher/
|
||||||
│ └── SKILL.md
|
│ └── SKILL.md
|
||||||
└── agency-youtube/
|
└── agency-archivist/
|
||||||
└── SKILL.md
|
└── 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
|
## 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
|
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
|
## Publishing Gates
|
||||||
|
|
||||||
|
|
@ -214,7 +212,8 @@ Vedi documentazione interna per dettagli.
|
||||||
- **Lingua:** Skills in inglese, alcune references bilingue (IT/EN)
|
- **Lingua:** Skills in inglese, alcune references bilingue (IT/EN)
|
||||||
- **Dominio:** Agency digitali, content production, multi-agent coordination
|
- **Dominio:** Agency digitali, content production, multi-agent coordination
|
||||||
- **Complexity:** MEDIUM-HIGH (15 skills, 23 references, workflow coordinati)
|
- **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
|
## Supporto
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Report KPI settimanali e azioni misurabili per social e YouTube.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `kpi_definitions` | object | KPI da tracciare |
|
| `kpi_definitions` | object | KPI da tracciare |
|
||||||
| `dashboards_links` | array | Link a analytics (se disponibili) |
|
| `dashboards_links` | array | Link a analytics (se disponibili) |
|
||||||
| `week_number` | string | Numero settimana (es. "2026-W10") |
|
| `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`
|
1. Usa template da `../agency-shared-references/references/weekly_report_template.md`
|
||||||
2. Compila tutte le sezioni
|
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
|
4. Documenta azioni nel run log del progetto se richiedono follow-up
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale |
|
| `{project}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale |
|
||||||
| `clients/{client}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) |
|
| `{project}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
---
|
---
|
||||||
name: agency-archivist
|
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
|
# 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:
|
Ogni progetto ha una cartella dedicata per le risorse:
|
||||||
|
|
||||||
```
|
```
|
||||||
clients/{client}/
|
{project}/
|
||||||
├── assets/ ← Gestito da agency-archivist
|
├── assets/ ← Gestito da agency-archivist
|
||||||
│ ├── archive/ # Archivi originali (zip, tar, rar)
|
│ ├── archive/ # Archivi originali (zip, tar, rar)
|
||||||
│ ├── images/ # Immagini estratte
|
│ ├── images/ # Immagini estratte
|
||||||
|
|
@ -69,16 +69,16 @@ clients/{client}/
|
||||||
|
|
||||||
1. **Ricevi input:** Path file, URL o allegato
|
1. **Ricevi input:** Path file, URL o allegato
|
||||||
2. **Valida formato:** Verifica estensione supportata
|
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/
|
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:**
|
**Esempio Log:**
|
||||||
```markdown
|
```markdown
|
||||||
## 2026-03-10 23:30 — Archivist Upload
|
## 2026-03-10 23:30 — Archivist Upload
|
||||||
|
|
||||||
- **Input:** `brand_assets.zip` (allegato)
|
- **Input:** `brand_assets.zip` (allegato)
|
||||||
- **Destinazione:** `clients/demo_co_srl/assets/archive/`
|
- **Destinazione:** `{project}/assets/archive/`
|
||||||
- **Dimensioni:** 15.4 MB
|
- **Dimensioni:** 15.4 MB
|
||||||
- **Status:** ✅ Completato
|
- **Status:** ✅ Completato
|
||||||
```
|
```
|
||||||
|
|
@ -147,7 +147,7 @@ Per immagini e video:
|
||||||
- Contesto (interno/esterno, prodotto/persone)
|
- Contesto (interno/esterno, prodotto/persone)
|
||||||
- Tag automatici
|
- Tag automatici
|
||||||
|
|
||||||
**Output:** `clients/{client}/assets/catalog.md`
|
**Output:** `{project}/assets/catalog.md`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -222,7 +222,7 @@ _Generato: {data} | Totale: {N} risorse_
|
||||||
```markdown
|
```markdown
|
||||||
**Prima di eseguire task che richiedono asset:**
|
**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
|
2. Cerca risorse per tag/tipo/descrizione
|
||||||
3. Se trovi: Usa path completo
|
3. Se trovi: Usa path completo
|
||||||
4. Se NON trovi: "🔒 Bloccato: servono [descrizione risorse]"
|
4. Se NON trovi: "🔒 Bloccato: servono [descrizione risorse]"
|
||||||
|
|
@ -303,9 +303,9 @@ node scripts/generate_catalog.js --client <client_name>
|
||||||
|
|
||||||
| File | Formato | Descrizione |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/assets/catalog.md` | Markdown | Catalogo completo risorse |
|
| `{project}/assets/catalog.md` | Markdown | Catalogo completo risorse |
|
||||||
| `clients/{client}/ops/run_log.md` | Markdown | Log operazioni archivist |
|
| `{project}/ops/run_log.md` | Markdown | Log operazioni archivist |
|
||||||
| `clients/{client}/assets/archive/` | Cartella | Archivi originali (opzionale) |
|
| `{project}/assets/archive/` | Cartella | Archivi originali (opzionale) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `strategy_docs` | array | Positioning, messaging (da strategy) |
|
| `strategy_docs` | array | Positioning, messaging (da strategy) |
|
||||||
| `reference_library` | array | Referenze visive (da research) |
|
| `reference_library` | array | Referenze visive (da research) |
|
||||||
| `brand_constraints` | object | Vincoli brand (colori, font, etc.) |
|
| `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:**
|
**Azioni:**
|
||||||
|
|
||||||
1. Leggi `clients/{client}/strategy/positioning.md`
|
1. Leggi `{project}/strategy/positioning.md`
|
||||||
2. Leggi `clients/{client}/strategy/messaging.md`
|
2. Leggi `{project}/strategy/messaging.md`
|
||||||
3. Studia `clients/{client}/research/reference_library.md`
|
3. Studia `{project}/research/reference_library.md`
|
||||||
4. Identifica:
|
4. Identifica:
|
||||||
- Attributi brand (da positioning)
|
- Attributi brand (da positioning)
|
||||||
- Visual patterns ricorrenti nelle referenze
|
- Visual patterns ricorrenti nelle referenze
|
||||||
|
|
@ -71,7 +71,7 @@ Definisce la direzione creativa e visiva che guida il design del progetto.
|
||||||
- Abstract/3D
|
- Abstract/3D
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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
|
- Cosa prendere
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/design/creative_direction.md` | Markdown | Direzione creativa |
|
| `{project}/design/creative_direction.md` | Markdown | Direzione creativa |
|
||||||
| `clients/{client}/design/moodboard.md` | Markdown + immagini | Moodboard visiva |
|
| `{project}/design/moodboard.md` | Markdown + immagini | Moodboard visiva |
|
||||||
| `clients/{client}/design/design_principles.md` | Markdown | Principi design |
|
| `{project}/design/design_principles.md` | Markdown | Principi design |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
---
|
---
|
||||||
name: agency-design-system
|
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
|
# Agency Visual Designer — Design System
|
||||||
|
|
@ -20,7 +20,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `creative_direction` | object | Da creative director |
|
| `creative_direction` | object | Da creative director |
|
||||||
| `design_principles` | array | Principi guida |
|
| `design_principles` | array | Principi guida |
|
||||||
| `brand_assets` | object | Loghi, colori brand (se esistenti) |
|
| `brand_assets` | object | Loghi, colori brand (se esistenti) |
|
||||||
|
|
@ -36,7 +36,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
|
||||||
**Azioni:**
|
**Azioni:**
|
||||||
|
|
||||||
1. **LEGGI CATALOGO RISORSE:**
|
1. **LEGGI CATALOGO RISORSE:**
|
||||||
- Apri `clients/{client}/assets/catalog.md`
|
- Apri `{project}/assets/catalog.md`
|
||||||
- Cerca:
|
- Cerca:
|
||||||
- Logo: `#logo`, `#brand` → Path per UI
|
- Logo: `#logo`, `#brand` → Path per UI
|
||||||
- Colori: `#brand`, `#guidelines` → PDF con palette
|
- Colori: `#brand`, `#guidelines` → PDF con palette
|
||||||
|
|
@ -109,7 +109,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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:**
|
**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)
|
2. Includi esempi visivi (se possibile)
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/design/tokens.md` | Markdown | Design tokens |
|
| `{project}/design/tokens.md` | Markdown | Design tokens |
|
||||||
| `clients/{client}/design/components.md` | Markdown | Component library |
|
| `{project}/design/components.md` | Markdown | Component library |
|
||||||
| `clients/{client}/design/page_layouts.md` | Markdown | Page layouts |
|
| `{project}/design/page_layouts.md` | Markdown | Page layouts |
|
||||||
| `clients/{client}/design/design_system.md` | Markdown | Design system completo |
|
| `{project}/design/design_system.md` | Markdown | Design system completo |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -134,7 +134,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile
|
||||||
|
|
||||||
**Gestione campi mancanti:**
|
**Gestione campi mancanti:**
|
||||||
- Se un campo non è trovabile nel documento, fai un'assunzione ragionevole basata sul contesto
|
- 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
|
- Segnala all'utente i campi con assunzioni e chiedi conferma o correzione prima di procedere
|
||||||
|
|
||||||
**Vantaggi Modalità B:**
|
**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à A (Questionario):** Usa dati compilati dal cliente
|
||||||
- **Modalità B (Documento):** Estrai informazioni automaticamente (vedi sezione sopra)
|
- **Modalità B (Documento):** Estrai informazioni automaticamente (vedi sezione sopra)
|
||||||
|
|
||||||
2. **Proposta path cliente:**
|
2. **Proposta path progetto:**
|
||||||
- Proponi: `clients/{nome_cliente_lowercase}/`
|
- Proponi: `{project}/` (es. `{nome_cliente_lowercase}/` o nome progetto)
|
||||||
- Esempio: `clients/demo_co_srl/`
|
- Esempio: `demo_co_srl/` oppure `campagna_prodotto_x/`
|
||||||
- **Chiedi conferma esplicita** prima di procedere
|
- **Chiedi conferma esplicita** prima di procedere
|
||||||
|
|
||||||
3. **Dopo conferma, crea struttura cartelle:**
|
3. **Dopo conferma, crea struttura cartelle:**
|
||||||
```
|
```
|
||||||
clients/{client}/
|
{project}/
|
||||||
├── knowledge/ (company profile, audience, brand)
|
├── knowledge/ (company profile, audience, brand)
|
||||||
├── research/ (competitor, market insights)
|
├── research/ (competitor, market insights)
|
||||||
├── strategy/ (positioning, messaging, pillars)
|
├── 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à
|
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:**
|
6. **(Opzionale) Upload risorse:**
|
||||||
- **Chiedi:** "Hai un archivio di risorse (immagini, logo, brand assets) da caricare?"
|
- **Chiedi:** "Hai un archivio di risorse (immagini, logo, brand assets) da caricare?"
|
||||||
- **Se SI:** Ricevi zip/URL e triggera `agency-archivist`
|
- **Se SI:** Ricevi zip/URL e triggera `agency-archivist`
|
||||||
- **Workflow:**
|
- **Workflow:**
|
||||||
```
|
```
|
||||||
a. agency-archivist estrae archivio in clients/{client}/assets/
|
a. agency-archivist estrae archivio in {project}/assets/
|
||||||
b. Scansiona risorse e genera metadata
|
b. Scansiona risorse e genera metadata
|
||||||
c. Crea catalog.md con descrizione e tag
|
c. Crea catalog.md con descrizione e tag
|
||||||
d. Notifica orchestrator: "✅ Risorse pronte"
|
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
|
1. Raccogli output da tutti gli agenti
|
||||||
2. Verifica coerenza cross-deliverable
|
2. Verifica coerenza cross-deliverable
|
||||||
3. Esegui QA checklist (vedi `../agency-shared-references/references/quality_bar.md`)
|
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:**
|
**QA Checklist:**
|
||||||
- [ ] Output in path corretto
|
- [ ] Output in path corretto
|
||||||
|
|
@ -281,7 +281,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile
|
||||||
- Nome cliente
|
- Nome cliente
|
||||||
↓
|
↓
|
||||||
3. agency-archivist esegue:
|
3. agency-archivist esegue:
|
||||||
- Estrazione in clients/{client}/assets/
|
- Estrazione in {project}/assets/
|
||||||
- Scansione e catalogazione
|
- Scansione e catalogazione
|
||||||
- Generazione catalog.md
|
- Generazione catalog.md
|
||||||
↓
|
↓
|
||||||
|
|
@ -322,7 +322,7 @@ Esempio: agency-visual-generator deve creare social post ma mancano foto prodott
|
||||||
### Struttura Cartelle Assets
|
### Struttura Cartelle Assets
|
||||||
|
|
||||||
```
|
```
|
||||||
clients/{client}/assets/
|
{project}/assets/
|
||||||
├── archive/ # Archivi originali (zip, tar)
|
├── archive/ # Archivi originali (zip, tar)
|
||||||
├── images/ # Immagini estratte
|
├── images/ # Immagini estratte
|
||||||
│ ├── logo/ # Loghi aziendali
|
│ ├── logo/ # Loghi aziendali
|
||||||
|
|
@ -343,7 +343,7 @@ clients/{client}/assets/
|
||||||
**Prima di eseguire task che richiedono asset:**
|
**Prima di eseguire task che richiedono asset:**
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
1. Leggi `clients/{client}/assets/catalog.md`
|
1. Leggi `{project}/assets/catalog.md`
|
||||||
2. Cerca risorse per tag/tipo/descrizione
|
2. Cerca risorse per tag/tipo/descrizione
|
||||||
3. Se trovi: Usa path completo
|
3. Se trovi: Usa path completo
|
||||||
4. Se NON trovi:
|
4. Se NON trovi:
|
||||||
|
|
@ -365,9 +365,9 @@ clients/{client}/assets/
|
||||||
|
|
||||||
| File | Formato | Descrizione |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/ops/decisions.md` | Markdown | Decisioni e assunzioni |
|
| `{project}/ops/decisions.md` | Markdown | Decisioni e assunzioni |
|
||||||
| `clients/{client}/ops/qa_notes.md` | Markdown | Issue QA + fix proposti |
|
| `{project}/ops/qa_notes.md` | Markdown | Issue QA + fix proposti |
|
||||||
| `clients/{client}/ops/run_log.md` | Markdown | Log operativo (opzionale) |
|
| `{project}/ops/run_log.md` | Markdown | Log operativo (opzionale) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `content_files` | array | File content da pubblicare |
|
| `content_files` | array | File content da pubblicare |
|
||||||
| `platform` | string | "social" / "youtube" |
|
| `platform` | string | "social" / "youtube" |
|
||||||
| `publish_mode` | string | "immediate" / "scheduled" |
|
| `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
|
- **YouTube:** Title, description, thumbnail_path, tags, scheduled_for
|
||||||
|
|
||||||
2. Genera `idempotency_key`:
|
2. Genera `idempotency_key`:
|
||||||
- Formula: `{client}_{platform}_{post_id}_{version}`
|
- Formula: `{project}_{platform}_{post_id}_{version}`
|
||||||
- Esempio: `demo_co_linkedin_post_001_v1`
|
- Esempio: `demo_co_linkedin_post_001_v1`
|
||||||
|
|
||||||
3. Compila payload:
|
3. Compila payload:
|
||||||
|
|
@ -161,7 +161,7 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic
|
||||||
|
|
||||||
**Azioni:**
|
**Azioni:**
|
||||||
|
|
||||||
1. Apri/crea `clients/{client}/ops/publish_log.md`
|
1. Apri/crea `{project}/ops/publish_log.md`
|
||||||
|
|
||||||
2. Aggiungi entry:
|
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 |
|
| 2026-03-09 | YouTube | ep_001 | Scheduled | - | Publish: 2026-03-10 14:00 |
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Per YouTube, aggiorna anche `clients/{client}/youtube/published_log.md`
|
3. Per YouTube, aggiorna anche `{project}/youtube/published_log.md`
|
||||||
4. Per Social, aggiorna `clients/{client}/social/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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/ops/publish_log.md` | Markdown | Log centrale publish |
|
| `{project}/ops/publish_log.md` | Markdown | Log centrale publish |
|
||||||
| `clients/{client}/social/published_log.md` | Markdown | Log social (opzionale) |
|
| `{project}/social/published_log.md` | Markdown | Log social (opzionale) |
|
||||||
| `clients/{client}/youtube/published_log.md` | Markdown | Log YouTube (opzionale) |
|
| `{project}/youtube/published_log.md` | Markdown | Log YouTube (opzionale) |
|
||||||
| Content files aggiornati | Markdown | `status: published/scheduled` |
|
| Content files aggiornati | Markdown | `status: published/scheduled` |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `competitors` | array | Lista competitor (min 3) |
|
| `competitors` | array | Lista competitor (min 3) |
|
||||||
| `research_type` | string | "competitor" / "reference" / "both" |
|
| `research_type` | string | "competitor" / "reference" / "both" |
|
||||||
| `focus_areas` | array | Aree di focus (es. positioning, visual, UX) |
|
| `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-###`
|
2. Logga fonti in `sources_log.md` con ID `SRC-###`
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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-###`
|
3. Logga fonti con ID `SRC-###`
|
||||||
|
|
||||||
**Output:**
|
**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)
|
- Esempio (screenshot o link)
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor |
|
| `{project}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor |
|
||||||
| `clients/{client}/research/opportunity_map.md` | Markdown | Insight prioritizzati |
|
| `{project}/research/opportunity_map.md` | Markdown | Insight prioritizzati |
|
||||||
| `clients/{client}/research/reference_library.md` | Markdown | 10-15 referenze |
|
| `{project}/research/reference_library.md` | Markdown | 10-15 referenze |
|
||||||
| `clients/{client}/research/pattern_catalog.md` | Markdown | Pattern catalog |
|
| `{project}/research/pattern_catalog.md` | Markdown | Pattern catalog |
|
||||||
| `clients/{client}/research/sources_log.md` | Markdown | Log fonti |
|
| `{project}/research/sources_log.md` | Markdown | Log fonti |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ SEO tecnico, metadata e schema markup per visibilità search.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `website_pages` | array | Lista pagine da ottimizzare |
|
| `website_pages` | array | Lista pagine da ottimizzare |
|
||||||
| `copy_docs` | array | Copy pagine (da ux-copy) |
|
| `copy_docs` | array | Copy pagine (da ux-copy) |
|
||||||
| `keyword_seed` | array | Keyword iniziali (opzionale) |
|
| `keyword_seed` | array | Keyword iniziali (opzionale) |
|
||||||
|
|
@ -65,7 +65,7 @@ SEO tecnico, metadata e schema markup per visibilità search.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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:**
|
**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:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/website/seo/keywords.md` | Markdown | Keyword seed list |
|
| `{project}/website/seo/keywords.md` | Markdown | Keyword seed list |
|
||||||
| `clients/{client}/website/seo/meta_library.md` | Markdown | Title e meta per pagine |
|
| `{project}/website/seo/meta_library.md` | Markdown | Title e meta per pagine |
|
||||||
| `clients/{client}/website/seo/schema_notes.md` | Markdown | Schema markup plans |
|
| `{project}/website/seo/schema_notes.md` | Markdown | Schema markup plans |
|
||||||
| `clients/{client}/website/changelog.md` | Markdown | SEO changelog |
|
| `{project}/website/changelog.md` | Markdown | SEO changelog |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Social strategy, calendario editoriale e post queue con visual brief.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `content_pillars` | array | Da strategy |
|
| `content_pillars` | array | Da strategy |
|
||||||
| `brand_voice` | object | Tone of voice |
|
| `brand_voice` | object | Tone of voice |
|
||||||
| `platforms` | array | Piattaforme target (LinkedIn, Instagram, X) |
|
| `platforms` | array | Piattaforme target (LinkedIn, Instagram, X) |
|
||||||
|
|
@ -71,7 +71,7 @@ Social strategy, calendario editoriale e post queue con visual brief.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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)
|
2. Crea minimo 10 post (mix di pillar e formati)
|
||||||
|
|
||||||
**Output:**
|
**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)
|
- Performance (se disponibili)
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/social/social_strategy.md` | Markdown | Strategy per piattaforma |
|
| `{project}/social/social_strategy.md` | Markdown | Strategy per piattaforma |
|
||||||
| `clients/{client}/social/calendar.md` | Markdown | Calendario 4 settimane |
|
| `{project}/social/calendar.md` | Markdown | Calendario 4 settimane |
|
||||||
| `clients/{client}/social/posts/*.md` | Markdown | 10+ post in queue |
|
| `{project}/social/posts/*.md` | Markdown | 10+ post in queue |
|
||||||
| `clients/{client}/social/published_log.md` | Markdown | Log publish (opzionale) |
|
| `{project}/social/published_log.md` | Markdown | Log publish (opzionale) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| 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) |
|
| `company_profile` | object | Profilo azienda (da knowledge o input) |
|
||||||
| `audience_data` | object | Dati audience (personas, ICP) |
|
| `audience_data` | object | Dati audience (personas, ICP) |
|
||||||
| `competitor_insights` | array | Insight da research competitor |
|
| `competitor_insights` | array | Insight da research competitor |
|
||||||
|
|
@ -36,16 +36,16 @@ Definisce la direzione strategica di un brand: positioning, messaging e content
|
||||||
|
|
||||||
**Azioni:**
|
**Azioni:**
|
||||||
|
|
||||||
1. Leggi `clients/{client}/knowledge/company_profile.md`
|
1. Leggi `{project}/knowledge/company_profile.md`
|
||||||
2. Leggi `clients/{client}/knowledge/audience.md` (o crea da template)
|
2. Leggi `{project}/knowledge/audience.md` (o crea da template)
|
||||||
3. Leggi `clients/{client}/research/competitor_teardowns.md` (se esiste)
|
3. Leggi `{project}/research/competitor_teardowns.md` (se esiste)
|
||||||
4. Identifica:
|
4. Identifica:
|
||||||
- Problema principale che l'azienda risolve
|
- Problema principale che l'azienda risolve
|
||||||
- Audience primaria e secondaria
|
- Audience primaria e secondaria
|
||||||
- Differentiatori vs competitor
|
- Differentiatori vs competitor
|
||||||
|
|
||||||
**Output intermedi:**
|
**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)
|
3. Scrivi positioning statement finale (1-2 frasi)
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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 |
|
| Behind the Scenes | Mostrare processo | Process snippet, team |
|
||||||
|
|
||||||
**Output:**
|
**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
|
3. Identifica KPI di successo
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/strategy/positioning.md` | Markdown | Positioning statement |
|
| `{project}/strategy/positioning.md` | Markdown | Positioning statement |
|
||||||
| `clients/{client}/strategy/messaging.md` | Markdown | Messaging house |
|
| `{project}/strategy/messaging.md` | Markdown | Messaging house |
|
||||||
| `clients/{client}/strategy/content_pillars.md` | Markdown | 4-6 content pillars |
|
| `{project}/strategy/content_pillars.md` | Markdown | 4-6 content pillars |
|
||||||
| `clients/{client}/strategy/go_to_market.md` | Markdown | GTM plan (opzionale) |
|
| `{project}/strategy/go_to_market.md` | Markdown | GTM plan (opzionale) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `strategy_docs` | array | Positioning, messaging, content pillars |
|
| `strategy_docs` | array | Positioning, messaging, content pillars |
|
||||||
| `design_layouts` | array | Page layouts (da design system) |
|
| `design_layouts` | array | Page layouts (da design system) |
|
||||||
| `seo_keywords` | array | Keyword seed (se disponibili) |
|
| `seo_keywords` | array | Keyword seed (se disponibili) |
|
||||||
|
|
@ -73,7 +73,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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
|
- Proof ovunque possibile
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**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
|
3. Compila QA checklist
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/website/sitemap.md` | Markdown | Architettura sito |
|
| `{project}/website/sitemap.md` | Markdown | Architettura sito |
|
||||||
| `clients/{client}/website/pages/*.md` | Markdown | Copy pagine |
|
| `{project}/website/pages/*.md` | Markdown | Copy pagine |
|
||||||
| `clients/{client}/website/seo/meta.md` | Markdown | SEO metadata |
|
| `{project}/website/seo/meta.md` | Markdown | SEO metadata |
|
||||||
| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist |
|
| `{project}/website/qa/qa_website.md` | Markdown | QA checklist |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
---
|
---
|
||||||
name: agency-visual-generator
|
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
|
# Agency Visual Generator — Asset Visuali
|
||||||
|
|
@ -20,7 +20,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| 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 |
|
| `content_files` | array | Post o script che richiedono visual |
|
||||||
| `style_guide` | object | Style guide cliente (colori, font) |
|
| `style_guide` | object | Style guide cliente (colori, font) |
|
||||||
| `asset_type` | string | "card" / "carousel" / "thumbnail" |
|
| `asset_type` | string | "card" / "carousel" / "thumbnail" |
|
||||||
|
|
@ -57,7 +57,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide.
|
||||||
**Azioni:**
|
**Azioni:**
|
||||||
|
|
||||||
1. **LEGGI CATALOGO RISORSE:**
|
1. **LEGGI CATALOGO RISORSE:**
|
||||||
- Apri `clients/{client}/assets/catalog.md`
|
- Apri `{project}/assets/catalog.md`
|
||||||
- Cerca risorse per il task:
|
- Cerca risorse per il task:
|
||||||
- Logo: `#logo`, `#brand`
|
- Logo: `#logo`, `#brand`
|
||||||
- Foto prodotto: `#prodotto`, `#product`
|
- 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
|
- **Attendi** che archivist carichi e sblocchi
|
||||||
|
|
||||||
3. **Carica style guide:**
|
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 esiste: Carica colori, font, logo path
|
||||||
- Se NON esiste: Crea draft e chiedi approvazione
|
- 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
|
2. Passa JSON template come prompt strutturato
|
||||||
3. Genera immagine PNG/webp
|
3. Genera immagine PNG/webp
|
||||||
4. Salva in:
|
4. Salva in:
|
||||||
- `clients/{client}/assets/social/{post_id}.png`
|
- `{project}/assets/social/{post_id}.png`
|
||||||
- `clients/{client}/assets/youtube/thumbnails/{ep_id}.png`
|
- `{project}/assets/youtube/thumbnails/{ep_id}.png`
|
||||||
- `clients/{client}/assets/social/carousels/{id}/slide_01.png`, etc.
|
- `{project}/assets/social/carousels/{id}/slide_01.png`, etc.
|
||||||
|
|
||||||
5. Aggiorna content file con `asset_path`
|
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
|
- [ ] No artifacts / broken text
|
||||||
- [ ] Safe margins for UI overlays
|
- [ ] 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:**
|
**Template:**
|
||||||
|
|
||||||
|
|
@ -230,10 +230,10 @@ Genera asset visuali platform-ready basati su content approvato e style guide.
|
||||||
|
|
||||||
| File | Formato | Descrizione |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/assets/social/*.png` | PNG/webp | Card social |
|
| `{project}/assets/social/*.png` | PNG/webp | Card social |
|
||||||
| `clients/{client}/assets/social/carousels/*/slide_*.png` | PNG | Carousel slides |
|
| `{project}/assets/social/carousels/*/slide_*.png` | PNG | Carousel slides |
|
||||||
| `clients/{client}/assets/youtube/thumbnails/*.png` | PNG | YouTube thumbnail |
|
| `{project}/assets/youtube/thumbnails/*.png` | PNG | YouTube thumbnail |
|
||||||
| `clients/{client}/assets/qa/qa_visual.md` | Markdown | QA checklist |
|
| `{project}/assets/qa/qa_visual.md` | Markdown | QA checklist |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
---
|
---
|
||||||
name: agency-web-developer
|
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
|
# 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 |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `sitemap` | object | Da agency-ux-copy |
|
| `sitemap` | object | Da agency-ux-copy |
|
||||||
| `page_copy` | array | Copy completo per ogni pagina |
|
| `page_copy` | array | Copy completo per ogni pagina |
|
||||||
| `design_tokens` | object | Da agency-design-system |
|
| `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:**
|
**Azioni:**
|
||||||
|
|
||||||
1. **LEGGI CATALOGO RISORSE:**
|
1. **LEGGI CATALOGO RISORSE:**
|
||||||
- Apri `clients/{client}/assets/catalog.md`
|
- Apri `{project}/assets/catalog.md`
|
||||||
- Cerca:
|
- Cerca:
|
||||||
- Logo: `#logo` → Per header/footer
|
- Logo: `#logo` → Per header/footer
|
||||||
- Immagini hero: `#hero`, `#sfondo`, `#prodotto` → Per homepage
|
- 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
|
- **Attendi** che archivist carichi e sblocchi
|
||||||
|
|
||||||
3. **Crea cartella `clients/{client}/website/`**
|
3. **Crea cartella `{project}/website/`**
|
||||||
|
|
||||||
4. **Crea sottocartelle:**
|
4. **Crea sottocartelle:**
|
||||||
- `index.html` (homepage)
|
- `index.html` (homepage)
|
||||||
|
|
@ -70,7 +70,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e
|
||||||
- `assets/fonts/`
|
- `assets/fonts/`
|
||||||
|
|
||||||
5. **Collega asset da archivio:**
|
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`
|
- Oppure usa path relativi: `../assets/images/logo/logo.png`
|
||||||
|
|
||||||
6. **Inizializza file base:**
|
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)
|
- SEO on-page (heading structure, alt text)
|
||||||
|
|
||||||
**Output:**
|
**Output:**
|
||||||
- `clients/{client}/website/index.html`
|
- `{project}/website/index.html`
|
||||||
- `clients/{client}/website/pages/*.html`
|
- `{project}/website/pages/*.html`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -189,7 +189,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e
|
||||||
- Footer
|
- Footer
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**Output:**
|
||||||
- `clients/{client}/website/js/main.js`
|
- `{project}/website/js/main.js`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -327,7 +327,7 @@ $(document).ready(function() {
|
||||||
- No console warnings
|
- No console warnings
|
||||||
|
|
||||||
**Output:**
|
**Output:**
|
||||||
- `clients/{client}/website/qa/qa_website.md`
|
- `{project}/website/qa/qa_website.md`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -335,12 +335,12 @@ $(document).ready(function() {
|
||||||
|
|
||||||
| File | Formato | Descrizione |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/website/index.html` | HTML | Homepage |
|
| `{project}/website/index.html` | HTML | Homepage |
|
||||||
| `clients/{client}/website/pages/*.html` | HTML | Altre pagine |
|
| `{project}/website/pages/*.html` | HTML | Altre pagine |
|
||||||
| `clients/{client}/website/css/main.css` | CSS | Stylesheet |
|
| `{project}/website/css/main.css` | CSS | Stylesheet |
|
||||||
| `clients/{client}/website/js/main.js` | JS | Interattività |
|
| `{project}/website/js/main.js` | JS | Interattività |
|
||||||
| `clients/{client}/website/assets/` | Folder | Immagini, font, etc. |
|
| `{project}/website/assets/` | Folder | Immagini, font, etc. |
|
||||||
| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist |
|
| `{project}/website/qa/qa_website.md` | Markdown | QA checklist |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ Strategia YouTube, calendario e script orientati a retention.
|
||||||
|
|
||||||
| Input | Tipo | Validazione |
|
| Input | Tipo | Validazione |
|
||||||
|-------|------|-------------|
|
|-------|------|-------------|
|
||||||
| `client_path` | string | Percorso client |
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
||||||
| `content_pillars` | array | Da strategy |
|
| `content_pillars` | array | Da strategy |
|
||||||
| `brand_voice` | object | Tone of voice |
|
| `brand_voice` | object | Tone of voice |
|
||||||
| `target_audience` | object | Audience YouTube |
|
| `target_audience` | object | Audience YouTube |
|
||||||
|
|
@ -78,7 +78,7 @@ Strategia YouTube, calendario e script orientati a retention.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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:**
|
**Output:**
|
||||||
- `clients/{client}/youtube/calendar.md`
|
- `{project}/youtube/calendar.md`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -187,7 +187,7 @@ Strategia YouTube, calendario e script orientati a retention.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Output:**
|
**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.)
|
- Performance (views, retention, etc.)
|
||||||
|
|
||||||
**Output:**
|
**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 |
|
| File | Formato | Descrizione |
|
||||||
|------|---------|-------------|
|
|------|---------|-------------|
|
||||||
| `clients/{client}/youtube/youtube_strategy.md` | Markdown | Strategy canale |
|
| `{project}/youtube/youtube_strategy.md` | Markdown | Strategy canale |
|
||||||
| `clients/{client}/youtube/calendar.md` | Markdown | Calendario episodi |
|
| `{project}/youtube/calendar.md` | Markdown | Calendario episodi |
|
||||||
| `clients/{client}/youtube/scripts/*.md` | Markdown | 2+ script completi |
|
| `{project}/youtube/scripts/*.md` | Markdown | 2+ script completi |
|
||||||
| `clients/{client}/youtube/published_log.md` | Markdown | Log publish (opzionale) |
|
| `{project}/youtube/published_log.md` | Markdown | Log publish (opzionale) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue