Conversione references in skill condivisa agency-shared-references

- Creata nuova skill agency-shared-references con 24 references centralizzate
- Spostate tutte le references da cartelle sparse (references/, agency-web-developer/, agency-archivist/) in un'unica posizione
- Aggiornati tutti i symlink delle 14 skills per puntare a ../agency-shared-references/references
- Aggiornati tutti i riferimenti nei SKILL.md (percorsi coerenti)
- README.md aggiornato con nuova struttura e istruzioni generiche
- INSTALL.sh semplificato con istruzioni platform-agnostic
- Eliminata cartella references/ dal root (ora centralizzata)
- Struttura più pulita e mantenibile, facile da installare su qualsiasi piattaforma

INSTALL.sh

@@ -1,12 +1,13 @@
 #!/bin/bash
-# Installazione agency_v3_1-skills
+# Installazione Agency Skills Suite
+# Script generico per Unix/Linux/Mac
 
 set -e
 
 SOURCE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TARGET="$HOME/.openclaw/skills/agency_v3_1-skills"
+TARGET="$HOME/.openclaw/skills/agency-skills-suite"
 
-echo "🚀 Installing agency_v3_1-skills..."
+echo "🚀 Installing Agency Skills Suite..."
 echo ""
 
 # Rimuovi installazione precedente se esiste
@@ -22,16 +23,24 @@ mkdir -p "$(dirname "$TARGET")"
 echo "📦 Copia skills in $TARGET..."
 cp -r "$SOURCE" "$TARGET"
 
-# Verifica symlink
+# Verifica/Crea symlink per tutte le skills
-echo "🔗 Verifica symlink..."
+echo "🔗 Configurazione symlink references..."
-for skill_dir in "$TARGET"/*/; do
+cd "$TARGET"
-    if [ -d "$skill_dir" ] && [ "$skill_dir" != "$TARGET/references/" ]; then
+for skill_dir in agency-*/; do
-        if [ ! -L "$skill_dir/references" ]; then
+    # Salta la cartella shared-references
-            echo "   Fix symlink: $skill_dir"
+    if [ "$skill_dir" = "agency-shared-references/" ]; then
-            rm -rf "$skill_dir/references"
+        echo "   ✓ $skill_dir (shared references, no symlink needed)"
-            ln -s ../references "$skill_dir/references"
+        continue
-        fi
     fi
+    
+    # Rimuovi references esistenti (file o symlink)
+    if [ -e "$skill_dir/references" ]; then
+        rm -rf "$skill_dir/references"
+    fi
+    
+    # Crea symlink verso agency-shared-references/references
+    ln -s ../agency-shared-references/references "$skill_dir/references"
+    echo "   ✓ $skill_dir → ../agency-shared-references/references"
 done
 
 echo ""
@@ -42,4 +51,8 @@ echo ""
 echo "Skills disponibili:"
 ls -1 "$TARGET" | grep -v references | sed 's/^/  - /'
 echo ""
-echo "Per usare una skill, riferisciti a lei come 'agency_v3_1-skills/<nome-skill>'"
+echo "Per usare una skill, riferisciti a lei come 'agency-skills-suite/<nome-skill>'"
+echo ""
+echo "Verifica symlink:"
+echo "  cd $TARGET"
+echo "  ls -la */references"

README.md

@@ -4,30 +4,62 @@ Suite completa di AgentSkills per agenzie digitali e content producer — un sis
 
 ## Panoramica
 
-- **Skills:** 14
+- **Skills:** 15 (14 specialistiche + 1 shared references)
-- **References:** 21
+- **References:** 23 (tutte centralizzate in agency-shared-references)
 - **Lingua:** Italiano/English
 - **Dominio:** Digital Agency / Content Production / Multi-Agent System
 
 ## Installazione
 
-### Metodo 1: Script Automatico
+### Istruzioni Generiche
+
+La suite richiede una struttura directory specifica per funzionare correttamente. Segui questi passaggi:
+
+1. **Copia la suite nella directory delle skills:**
+   - Posiziona l'intera cartella `agency-skills-suite` nella directory delle skills del tuo sistema
+   - Path tipico: `~/.openclaw/skills/agency-skills-suite/`
+
+2. **Verifica la struttura:**
+   - Tutte le 15 cartelle delle skills devono essere presenti
+   - La cartella `agency-shared-references/` deve contenere tutti i file reference
+   - Ogni skill deve avere un symlink `references/` che punta a `../agency-shared-references/references`
+
+3. **Verifica i symlink:**
+   - Ogni skill (tranne `agency-shared-references`) deve avere un symlink `references` → `../agency-shared-references/references`
+   - Su Unix/Linux/Mac: `ls -la */references` per verificare
+   - Su Windows: usa `dir */references` o ricrea i symlink se necessario
+
+4. **Testa l'installazione:**
+   - Carica una skill (es. `/skill agency-orchestrator`)
+   - Verifica che le references vengano caricate correttamente
+
+### Metodo 1: Script Automatico (Unix/Linux/Mac)
 
 ```bash
-cd /home/noe/.openclaw/workspace/agency-skills-suite
+cd /path/to/agency-skills-suite
 ./INSTALL.sh
 ```
 
 ### Metodo 2: Copia Manuale
 
 ```bash
-cp -r /home/noe/.openclaw/workspace/agency-skills-suite ~/.openclaw/skills/agency-skills
+# Copia l'intera suite
+cp -r /path/to/agency-skills-suite ~/.openclaw/skills/
+
+# Verifica i symlink (Unix/Linux/Mac)
+cd ~/.openclaw/skills/agency-skills-suite
+for skill in agency-*/; do
+  if [ "$skill" != "agency-shared-references/" ]; then
+    rm -rf "$skill/references"
+    ln -s ../agency-shared-references/references "$skill/references"
+  fi
+done
 ```
 
 ### Metodo 3: ClawHub (se pubblicato)
 
 ```bash
-clawhub install agency-skills
+clawhub install agency-skills-suite
 ```
 
 ## Skills Incluse
@@ -48,38 +80,47 @@ clawhub install agency-skills
 | 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 |
+| 15 | **agency-shared-references** 📚 | References condivise (tutte le skills) | — |
 
-## References Incluse
+## References Incluse (in agency-shared-references)
 
-### Agency Core (17)
+Tutte le references sono centralizzate in un'unica cartella condivisa:
-1. `design_patterns.md` — Pattern UI riusabili
-2. `hero_sections.md` — Layout hero efficaci
-3. `layout_systems.md` — Grid, spacing, density
-4. `navigation_patterns.md` — IA e navigazione
-5. `conversion_patterns.md` — CTA e conversioni
-6. `trust_signal_patterns.md` — Proof e credibilità
-7. `case_study_structures.md` — Template case study
-8. `copy_frameworks.md` — Framework copywriting
-9. `content_formats.md` — Formati social/YouTube
-10. `brand_voice.md` — Tone of voice
-11. `audience_personas.md` — Template personas
-12. `platform_patterns.md` — Pattern per piattaforma
-13. `quality_bar.md` — Standard qualità V1
-14. `publishing_gates.md` — Gate pre-publish
-15. `research_citation_rules.md` — Regole citazione fonti
-16. `strategy_playbook.md` — Framework positioning
-17. `research_playbook.md` — Metodo research
-18. `youtube_script_framework.md` — Struttura script
-19. `qa_visual.md` — QA checklist visual
-20. `weekly_report_template.md` — Template report
 
-### Web Developer (3)
+### Design & UX Patterns
-21. `html_semantics.md` — Semantic HTML best practices (in agency-web-developer/references)
+1. `design_patterns.md` — Pattern UI riusabili (card grid, split layout, testimonial, FAQ)
-22. `css_layout.md` — Layout Bootstrap/custom (in agency-web-developer/references)
+2. `hero_sections.md` — Layout hero efficaci (formula, checklist, esempi)
-23. `js_interactivity.md` — jQuery + GSAP patterns (in agency-web-developer/references)
+3. `layout_systems.md` — Grid, spacing, density, vertical rhythm
+4. `navigation_patterns.md` — IA e navigazione (primary nav, mobile nav, footer)
+5. `conversion_patterns.md` — CTA e conversioni (hierarchy, forms, friction reducers)
+6. `trust_signal_patterns.md` — Proof e credibilità (loghi, testimonial, numeri)
+7. `qa_visual.md` — QA checklist visual (accessibilità, responsive, performance)
 
-### Archivist (1)
+### Copy & Content
-24. `resource_types.md` — Tipologie risorse e use case (in agency-archivist/references)
+8. `copy_frameworks.md` — Framework copywriting (AIDA, PAS, FAB, 4U)
+9. `content_formats.md` — Formati social/YouTube (post, carousel, video, blog)
+10. `brand_voice.md` — Tone of voice (dimensioni, esempi, do/don't)
+11. `audience_personas.md` — Template personas (demografici, psicografici, bisogni)
+12. `case_study_structures.md` — Template case study (problema, soluzione, risultati)
+13. `youtube_script_framework.md` — Struttura script (hook, retention, CTA)
+
+### Strategy & Research
+14. `strategy_playbook.md` — Framework positioning (positioning statement, pillars)
+15. `research_playbook.md` — Metodo research (fonti, validazione, sintesi)
+16. `research_citation_rules.md` — Regole citazione fonti (quando, come, formato)
+
+### Quality & Publishing
+17. `quality_bar.md` — Standard qualità V1 (criteri, checklist, scoring)
+18. `publishing_gates.md` — Gate pre-publish (approval workflow, checklist)
+19. `weekly_report_template.md` — Template report (KPI, highlights, actions)
+20. `platform_patterns.md` — Pattern per piattaforma (Instagram, LinkedIn, YouTube)
+
+### Technical (Web Development)
+21. `html_semantics.md` — Semantic HTML best practices (structure, accessibility, SEO)
+22. `css_layout.md` — Layout, responsive, Bootstrap/custom (grid, breakpoints)
+23. `js_interactivity.md` — jQuery + GSAP patterns (animations, interactions)
+
+### Resources & Assets
+24. `resource_types.md` — Tipologie risorse e use case (immagini, video, documenti)
 
 ## Workflow Disponibili
 
@@ -114,9 +155,15 @@ agency-skills-suite/
 ├── README.md
 ├── INSTALL.sh
 ├── AGENCY_ARCHIVIST_DELIVERY.md
+├── agency-shared-references/     📚 References centralizzate
+│   └── references/
+│       ├── design_patterns.md
+│       ├── hero_sections.md
+│       ├── ... (23 references)
+│       └── resource_types.md
 ├── agency-orchestrator/
 │   ├── SKILL.md
-│   └── references → ../references
+│   └── references → ../agency-shared-references/references
 ├── agency-archivist/ ⭐
 │   ├── SKILL.md
 │   ├── README.md
@@ -124,16 +171,43 @@ agency-skills-suite/
 │   │   ├── extract_archive.js    # Estrazione zip/URL
 │   │   ├── scan_resources.js     # Scansione metadata
 │   │   └── generate_catalog.js   # Generazione catalogo
-│   └── references/
+│   └── references → ../agency-shared-references/references
-│       └── resource_types.md
 ├── agency-strategy/
 │   ├── SKILL.md
-│   └── references → ../references
+│   └── references → ../agency-shared-references/references
-├── ... (altre 11 skills)
+├── agency-research/
-└── references/
+│   ├── SKILL.md
-    ├── design_patterns.md
+│   └── references → ../agency-shared-references/references
-    ├── hero_sections.md
+├── agency-creative-director/
-    └── ... (17 references)
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-design-system/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-ux-copy/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-seo/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-social/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-youtube/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-visual-generator/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-web-developer/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-analytics/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
+├── agency-publisher/
+│   ├── SKILL.md
+│   └── references → ../agency-shared-references/references
 ```
 
 ## Uso
@@ -146,7 +220,7 @@ Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
 /skill agency-orchestrator
 ```
 
-La skill caricherà automaticamente le references necessarie dal percorso `../references`.
+La skill caricherà automaticamente le references necessarie dal percorso `../agency-shared-references/references`.
 
 ### Uso di agency-archivist
 
@@ -173,7 +247,7 @@ node scripts/generate_catalog.js --client demo_co_srl
 - Mai publish senza `PUBLISH_APPROVED.md` = YES
 - QA obbligatorio prima di publish
 
-Vedi `references/publishing_gates.md` per dettagli.
+Vedi `agency-shared-references/references/publishing_gates.md` per dettagli.
 
 ## Miglioramento Continuo
 
@@ -188,7 +262,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 (13 skills, 20 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
 
 ## Supporto
 
@@ -196,4 +271,4 @@ Per issue o domande sulla suite, consulta la documentazione interna o il reposit
 
 ---
 
-_Agency Skills Suite v1.0_
+_Agency Skills Suite v2.0 — References Centralizzate_

agency-analytics/SKILL.md

@@ -198,8 +198,8 @@ Report KPI settimanali e azioni misurabili per social e YouTube.
 
 ## References
 
-- [weekly_report_template.md](../../references/weekly_report_template.md) — Template report
+- [weekly_report_template.md](../agency-shared-references/references/weekly_report_template.md) — Template report
-- [quality_bar.md](../../references/quality_bar.md) — Standard V1
+- [quality_bar.md](../agency-shared-references/references/quality_bar.md) — Standard V1
 
 ---
 

agency-analytics/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-archivist/SKILL.md

@@ -311,8 +311,7 @@ node scripts/generate_catalog.js --client <client_name>
 
 ## References
 
-- [resource_types.md](./references/resource_types.md) — Tipologie risorse e use case
+- [resource_types.md](../agency-shared-references/references/resource_types.md) — Tipologie risorse e use case
-- [metadata_schema.md](./references/metadata_schema.md) — Schema metadata per catalogazione
 
 ---
 

agency-archivist/references

@@ -0,0 +1 @@
+../agency-shared-references/references

agency-creative-director/SKILL.md

@@ -202,10 +202,10 @@ Ogni claim supportato da evidence visibile.
 
 ## References
 
-- [design_patterns.md](../../references/design_patterns.md) — Pattern UI
+- [design_patterns.md](../agency-shared-references/references/design_patterns.md) — Pattern UI
-- [hero_sections.md](../../references/hero_sections.md) — Hero patterns
+- [hero_sections.md](../agency-shared-references/references/hero_sections.md) — Hero patterns
-- [layout_systems.md](../../references/layout_systems.md) — Grid e spacing
+- [layout_systems.md](../agency-shared-references/references/layout_systems.md) — Grid e spacing
-- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
 
 ---
 

agency-creative-director/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-design-system/SKILL.md

@@ -244,19 +244,19 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
 ## References
 
 ### UX/Design Patterns (Shared)
-- [layout_systems.md](../../references/layout_systems.md) — Grid e spacing
+- [layout_systems.md](../agency-shared-references/references/layout_systems.md) — Grid e spacing
-- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
+- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — IA patterns
-- [design_patterns.md](../../references/design_patterns.md) — UI patterns
+- [design_patterns.md](../agency-shared-references/references/design_patterns.md) — UI patterns
-- [qa_visual.md](../../references/qa_visual.md) — QA checklist
+- [qa_visual.md](../agency-shared-references/references/qa_visual.md) — QA checklist
 
 ### Resources & Assets
-- [resource_types.md](../agency-archivist/references/resource_types.md) — Tipologie risorse e use case
+- [resource_types.md](../agency-shared-references/references/resource_types.md) — Tipologie risorse e use case
 
 ### Technical Implementation (Handoff)
 **Per handoff a developer o implementazione diretta:**
-- [html_semantics.md](../agency-web-developer/references/html_semantics.md) — Semantic HTML structure
+- [html_semantics.md](../agency-shared-references/references/html_semantics.md) — Semantic HTML structure
-- [css_layout.md](../agency-web-developer/references/css_layout.md) — Bootstrap/custom CSS implementation
+- [css_layout.md](../agency-shared-references/references/css_layout.md) — Bootstrap/custom CSS implementation
-- [js_interactivity.md](../agency-web-developer/references/js_interactivity.md) — jQuery + GSAP patterns
+- [js_interactivity.md](../agency-shared-references/references/js_interactivity.md) — jQuery + GSAP patterns
 
 **Nota:** Questa skill produce design system documentato. Per implementazione codice, consultare agency-web-developer.
 

agency-design-system/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-orchestrator/SKILL.md

@@ -373,10 +373,10 @@ clients/{client}/assets/
 
 ## References
 
-- [quality_bar.md](../../references/quality_bar.md) — Standard V1
+- [quality_bar.md](../agency-shared-references/references/quality_bar.md) — Standard V1
-- [publishing_gates.md](../../references/publishing_gates.md) — Gate pre-publish
+- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) — Gate pre-publish
-- [research_citation_rules.md](../../references/research_citation_rules.md) — Citazione fonti
+- [research_citation_rules.md](../agency-shared-references/references/research_citation_rules.md) — Citazione fonti
-- [resource_types.md](../agency-archivist/references/resource_types.md) — Tipologie risorse e use case
+- [resource_types.md](../agency-shared-references/references/resource_types.md) — Tipologie risorse e use case
 
 ---
 

agency-orchestrator/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-publisher/SKILL.md

@@ -194,9 +194,8 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic
 
 ## References
 
-- [publishing_gates.md](../../references/publishing_gates.md) — Gate rules
+- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) — Gate rules
-- [quality_bar.md](../../references/quality_bar.md) — Standard qualità
+- [quality_bar.md](../agency-shared-references/references/quality_bar.md) — Standard qualità
-- [publish_webhook.md](../../skills/publish_webhook.md) — Webhook config
 
 ---
 

agency-publisher/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-research/SKILL.md

@@ -233,10 +233,8 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili.
 
 ## References
 
-- [research_playbook.md](../../references/research_playbook.md) — Metodo research
+- [research_playbook.md](../agency-shared-references/references/research_playbook.md) — Metodo research
-- [research_citation_rules.md](../../references/research_citation_rules.md) — Regole citazione
+- [research_citation_rules.md](../agency-shared-references/references/research_citation_rules.md) — Regole citazione
-- [competitor_teardown.md](../../templates/competitor_teardown.md) — Template teardown
-- [reference_entry.md](../../templates/reference_entry.md) — Template reference
 
 ---
 

agency-research/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-seo/SKILL.md

@@ -220,9 +220,9 @@ SEO tecnico, metadata e schema markup per visibilità search.
 
 ## References
 
-- [seo_fundamentals.md](../../references/seo_fundamentals.md) — Fondamentali SEO
+- [seo_fundamentals.md](../agency-shared-references/references/seo_fundamentals.md) — Fondamentali SEO
-- [metadata_rules.md](../../references/metadata_rules.md) — Regole meta tag
+- [metadata_rules.md](../agency-shared-references/references/metadata_rules.md) — Regole meta tag
-- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
+- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — IA patterns
 
 ---
 

agency-seo/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-shared-references/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: agency-shared-references
+description: "References condivise per la suite agency-skills. Contiene pattern, framework, template e linee guida trasversali usate da multiple skills: design patterns, copy frameworks, research playbook, quality bar, publishing gates, resource types, e altri. Usare quando: (1) serve consultare pattern UX/UI, (2) applicare framework copywriting, (3) seguire standard qualità, (4) citare fonti correttamente, (5) gestire risorse catalogate."
+---
+
+# Agency Shared References
+
+References condivise per tutte le skills della suite agency-skills.
+
+## Quando Usare
+
+Questa skill viene caricata automaticamente quando le altre skills della suite necessitano di:
+
+- **Pattern UX/UI:** design_patterns, hero_sections, layout_systems, navigation_patterns, conversion_patterns, trust_signal_patterns
+- **Framework Copy:** copy_frameworks, brand_voice, content_formats, case_study_structures
+- **Research:** research_playbook, research_citation_rules, strategy_playbook
+- **Quality & Publishing:** quality_bar, publishing_gates, qa_visual, weekly_report_template
+- **Risorse:** resource_types (tipologie asset e use case)
+- **YouTube:** youtube_script_framework
+- **Personas:** audience_personas
+- **Platform:** platform_patterns
+
+## Struttura
+
+```
+agency-shared-references/
+└── references/
+    ├── design_patterns.md
+    ├── hero_sections.md
+    ├── layout_systems.md
+    ├── navigation_patterns.md
+    ├── conversion_patterns.md
+    ├── trust_signal_patterns.md
+    ├── case_study_structures.md
+    ├── copy_frameworks.md
+    ├── content_formats.md
+    ├── brand_voice.md
+    ├── audience_personas.md
+    ├── platform_patterns.md
+    ├── quality_bar.md
+    ├── publishing_gates.md
+    ├── research_citation_rules.md
+    ├── research_playbook.md
+    ├── strategy_playbook.md
+    ├── youtube_script_framework.md
+    ├── qa_visual.md
+    ├── weekly_report_template.md
+    └── resource_types.md
+```
+
+## Uso dalle Skills
+
+Ogni skill della suite punta a queste references tramite symlink:
+
+```bash
+ln -s ../agency-shared-references/references ./references
+```
+
+## Note
+
+- **Non modificare** queste references senza approvazione dell'orchestrator
+- **Mantenere coerenti** i riferimenti incrociati tra documenti
+- **Aggiornare** quando si scoprono pattern migliori o si standardizzano nuovi workflow
+
+---
+
+_Agency Shared References v1.0_

agency-social/SKILL.md

@@ -192,10 +192,9 @@ Social strategy, calendario editoriale e post queue con visual brief.
 
 ## References
 
-- [content_formats.md](../../references/content_formats.md) — Formati social
+- [content_formats.md](../agency-shared-references/references/content_formats.md) — Formati social
-- [platform_patterns.md](../../references/platform_patterns.md) — Pattern per piattaforma
+- [platform_patterns.md](../agency-shared-references/references/platform_patterns.md) — Pattern per piattaforma
-- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
-- [social_post_spec.md](../../templates/social_post_spec.md) — Template post
 
 ---
 

agency-social/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-strategy/SKILL.md

@@ -179,11 +179,11 @@ perché **specializzati in clarity-first e conversioni**.
 
 ## References
 
-- [strategy_playbook.md](../../references/strategy_playbook.md) — Framework positioning
+- [strategy_playbook.md](../agency-shared-references/references/strategy_playbook.md) — Framework positioning
-- [copy_frameworks.md](../../references/copy_frameworks.md) — Framework copy
+- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) — Framework copy
-- [content_formats.md](../../references/content_formats.md) — Formati content
+- [content_formats.md](../agency-shared-references/references/content_formats.md) — Formati content
-- [audience_personas.md](../../references/audience_personas.md) — Template personas
+- [audience_personas.md](../agency-shared-references/references/audience_personas.md) — Template personas
-- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
 
 ---
 

agency-strategy/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-ux-copy/SKILL.md

@@ -227,18 +227,18 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
 ## References
 
 ### UX/Design Patterns (Shared)
-- [copy_frameworks.md](../../references/copy_frameworks.md) — Framework copy
+- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) — Framework copy
-- [conversion_patterns.md](../../references/conversion_patterns.md) — CTA e conversioni
+- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) — CTA e conversioni
-- [hero_sections.md](../../references/hero_sections.md) — Hero patterns
+- [hero_sections.md](../agency-shared-references/references/hero_sections.md) — Hero patterns
-- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
+- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — IA patterns
-- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
-- [design_patterns.md](../../references/design_patterns.md) — UI patterns (card grid, split layout, testimonial, FAQ)
+- [design_patterns.md](../agency-shared-references/references/design_patterns.md) — UI patterns (card grid, split layout, testimonial, FAQ)
 
 ### Handoff a Developer
 **Dopo aver completato copy, passare a:**
 - **agency-web-developer** — Implementa HTML/CSS/JS dal copy
-- [html_semantics.md](../agency-web-developer/references/html_semantics.md) — Come il copy diventa struttura HTML
+- [html_semantics.md](../agency-shared-references/references/html_semantics.md) — Come il copy diventa struttura HTML
-- [css_layout.md](../agency-web-developer/references/css_layout.md) — Come i layout diventano CSS
+- [css_layout.md](../agency-shared-references/references/css_layout.md) — Come i layout diventano CSS
 
 **Nota:** Questa skill produce sitemap + copy. Per implementazione codice, usare agency-web-developer.
 

agency-ux-copy/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-visual-generator/SKILL.md

@@ -239,10 +239,10 @@ Genera asset visuali platform-ready basati su content approvato e style guide.
 
 ## References
 
-- [qa_visual.md](../../references/qa_visual.md) — QA checklist
+- [qa_visual.md](../agency-shared-references/references/qa_visual.md) — QA checklist
-- [platform_patterns.md](../../references/platform_patterns.md) — Pattern per piattaforma
+- [platform_patterns.md](../agency-shared-references/references/platform_patterns.md) — Pattern per piattaforma
-- [publishing_gates.md](../../references/publishing_gates.md) — Gate pre-publish
+- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) — Gate pre-publish
-- [resource_types.md](../agency-archivist/references/resource_types.md) — Tipologie risorse e use case
+- [resource_types.md](../agency-shared-references/references/resource_types.md) — Tipologie risorse e use case
 
 ---
 

agency-visual-generator/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references

agency-web-developer/SKILL.md

@@ -346,21 +346,16 @@ $(document).ready(function() {
 
 ## References
 
-### Technical (Web Developer Specific)
+### Shared References (Agency Suite)
-- [html_semantics.md](./references/html_semantics.md) — Semantic HTML best practices
+- [html_semantics.md](../agency-shared-references/references/html_semantics.md) — Semantic HTML best practices
-- [css_layout.md](./references/css_layout.md) — Layout, responsive, Bootstrap
+- [css_layout.md](../agency-shared-references/references/css_layout.md) — Layout, responsive, Bootstrap
-- [js_interactivity.md](./references/js_interactivity.md) — jQuery + GSAP patterns
+- [js_interactivity.md](../agency-shared-references/references/js_interactivity.md) — jQuery + GSAP patterns
-
+- [hero_sections.md](../agency-shared-references/references/hero_sections.md) — Hero checklist, formula, layouts
-### UX/Design Patterns (Shared References)
+- [design_patterns.md](../agency-shared-references/references/design_patterns.md) — Card grid, split layout, testimonial, FAQ patterns
-**Consultare PRIMA di implementare:**
+- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — Primary nav, mobile nav, IA
-- [hero_sections.md](../references/hero_sections.md) — Hero checklist, formula, layouts
+- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) — CTA hierarchy, forms, friction reducers
-- [design_patterns.md](../references/design_patterns.md) — Card grid, split layout, testimonial, FAQ patterns
+- [layout_systems.md](../agency-shared-references/references/layout_systems.md) — Grid, spacing, vertical rhythm
-- [navigation_patterns.md](../references/navigation_patterns.md) — Primary nav, mobile nav, IA
+- [resource_types.md](../agency-shared-references/references/resource_types.md) — Tipologie risorse e use case
-- [conversion_patterns.md](../references/conversion_patterns.md) — CTA hierarchy, forms, friction reducers
-- [layout_systems.md](../references/layout_systems.md) — Grid, spacing, vertical rhythm
-
-### Resources & Assets
-- [resource_types.md](../agency-archivist/references/resource_types.md) — Tipologie risorse e use case
 
 **Flusso consigliato:**
 1. Leggi catalogo risorse (`assets/catalog.md`)

agency-web-developer/references

@@ -0,0 +1 @@
+../agency-shared-references/references

agency-youtube/SKILL.md

@@ -220,10 +220,9 @@ Strategia YouTube, calendario e script orientati a retention.
 
 ## References
 
-- [youtube_script_framework.md](../../references/youtube_script_framework.md) — Struttura script
+- [youtube_script_framework.md](../agency-shared-references/references/youtube_script_framework.md) — Struttura script
-- [content_formats.md](../../references/content_formats.md) — Formati YouTube
+- [content_formats.md](../agency-shared-references/references/content_formats.md) — Formati YouTube
-- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
-- [youtube_script.md](../../templates/youtube_script.md) — Template script
 
 ---
 

agency-youtube/references

@@ -1 +1 @@
-../references
+../agency-shared-references/references