From c496db151cae5df58567ac633bb84a683edb7081 Mon Sep 17 00:00:00 2001
From: AgentePotente <agent@openclaw.local>
Date: Tue, 10 Mar 2026 23:51:32 +0100
Subject: [PATCH] DOCS: Aggiornato README.md con agency-archivist
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Panoramica: 13 → 14 skills, 20 → 21 references
- Tabella skills: aggiunto agency-archivist (⭐)
- References: aggiunta sezione Archivist con resource_types.md
- Workflow: inserito step Upload Risorse (Fase 1 opzionale)
- Struttura: dettagliata agency-archivist/ con scripts/
- Uso: aggiunta sezione per comandi archivist

Tutta la documentazione ora riflette la nuova skill di gestione risorse.
---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 7fba6a7..8051b7c 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,8 @@ Suite completa di AgentSkills per agenzie digitali e content producer — un sis
 
 ## Panoramica
 
-- **Skills:** 13
-- **References:** 20
+- **Skills:** 14
+- **References:** 21
 - **Lingua:** Italiano/English
 - **Dominio:** Digital Agency / Content Production / Multi-Agent System
 
@@ -47,6 +47,7 @@ clawhub install agency-skills
 | 11 | **agency-web-developer** | Siti web statici (HTML/CSS/JS) | Media |
 | 12 | **agency-analytics** | Report KPI settimanali, actions | Bassa |
 | 13 | **agency-publisher** | Publish gate-based (social/YouTube) | Bassa |
+| 14 | **agency-archivist** ⭐ | Gestione risorse (immagini, video, documenti) | Media |
 
 ## References Incluse
 
@@ -77,6 +78,9 @@ clawhub install agency-skills
 22. `css_layout.md` — Layout Bootstrap/custom (in agency-web-developer/references)
 23. `js_interactivity.md` — jQuery + GSAP patterns (in agency-web-developer/references)
 
+### Archivist (1)
+24. `resource_types.md` — Tipologie risorse e use case (in agency-archivist/references)
+
 ## Workflow Disponibili
 
 La suite supporta 5 workflow principali, attivabili tramite `agency-orchestrator`:
@@ -92,15 +96,16 @@ La suite supporta 5 workflow principali, attivabili tramite `agency-orchestrator
 ## Workflow Consigliato (End-to-End)
 
 1. **Onboarding:** `agency-orchestrator` → definisci MVP e workflow
-2. **Analisi:** `agency-research` → competitor + reference
-3. **Posizionamento:** `agency-strategy` → positioning, messaging
-4. **Creative:** `agency-creative-director` → direzione visiva
-5. **Design:** `agency-design-system` → design system
-6. **Sito Web:** `agency-ux-copy` → sitemap, copy → `agency-web-developer` → sito HTML/CSS/JS → `agency-seo` → metadata
-7. **Content:** `agency-social` + `agency-youtube` → calendar, script
-8. **Visual:** `agency-visual-generator` → asset
-9. **Publish:** `agency-publisher` → publish (post-approvazione)
-10. **Analytics:** `agency-analytics` → report settimanali
+2. **Upload Risorse:** `agency-archivist` → estrai e cataloga asset (opzionale, Fase 1)
+3. **Analisi:** `agency-research` → competitor + reference
+4. **Posizionamento:** `agency-strategy` → positioning, messaging
+5. **Creative:** `agency-creative-director` → direzione visiva
+6. **Design:** `agency-design-system` → design system (usa asset da archivist)
+7. **Sito Web:** `agency-ux-copy` → sitemap, copy → `agency-web-developer` → sito HTML/CSS/JS (usa immagini da archivist) → `agency-seo` → metadata
+8. **Content:** `agency-social` + `agency-youtube` → calendar, script
+9. **Visual:** `agency-visual-generator` → asset (usa risorse da archivist)
+10. **Publish:** `agency-publisher` → publish (post-approvazione)
+11. **Analytics:** `agency-analytics` → report settimanali
 
 ## Struttura
 
@@ -108,13 +113,23 @@ La suite supporta 5 workflow principali, attivabili tramite `agency-orchestrator
 agency-skills-suite/
 ├── README.md
 ├── INSTALL.sh
+├── AGENCY_ARCHIVIST_DELIVERY.md
 ├── agency-orchestrator/
 │   ├── SKILL.md
 │   └── references → ../references
+├── agency-archivist/ ⭐
+│   ├── SKILL.md
+│   ├── README.md
+│   ├── scripts/
+│   │   ├── extract_archive.js    # Estrazione zip/URL
+│   │   ├── scan_resources.js     # Scansione metadata
+│   │   └── generate_catalog.js   # Generazione catalogo
+│   └── references/
+│       └── resource_types.md
 ├── agency-strategy/
 │   ├── SKILL.md
 │   └── references → ../references
-├── ... (altre 10 skills)
+├── ... (altre 11 skills)
 └── references/
     ├── design_patterns.md
     ├── hero_sections.md
@@ -133,6 +148,23 @@ Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
 
 La skill caricherà automaticamente le references necessarie dal percorso `../references`.
 
+### Uso di agency-archivist
+
+**Estrazione risorse:**
+
+```bash
+node scripts/extract_archive.js brand_assets.zip --client demo_co_srl
+```
+
+**Scansione e catalogo:**
+
+```bash
+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.
+
 ## Publishing Gates
 
 ⚠️ **Importante:** Le skills `agency-publisher` e tutte le skills che producono content pubblicabile seguono gate rigorosi: