Rimozione symlink: percorsi diretti verso agency-shared-references

- Eliminati tutti i symlink references/ dalle 14 skills
- Aggiornati tutti i riferimenti nei SKILL.md con percorsi completi
  (es. ../agency-shared-references/references/quality_bar.md)
- README.md aggiornato: nessuna configurazione symlink necessaria
- INSTALL.sh semplificato: solo copia e verifica, no symlink
- Struttura più semplice e compatibile con tutte le piattaforme
- Nessun file di configurazione o link simbolico richiesto

INSTALL.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
 # Installazione Agency Skills Suite
 # Script generico per Unix/Linux/Mac
+# Nota: Nessun symlink necessario - percorsi diretti nei SKILL.md
 
 set -e
 
@@ -23,36 +24,40 @@ mkdir -p "$(dirname "$TARGET")"
 echo "📦 Copia skills in $TARGET..."
 cp -r "$SOURCE" "$TARGET"
 
-# Verifica/Crea symlink per tutte le skills
+# Verifica struttura
-echo "🔗 Configurazione symlink references..."
+echo "🔍 Verifica struttura..."
 cd "$TARGET"
+
+# Verifica che agency-shared-references esista
+if [ ! -d "agency-shared-references/references" ]; then
+    echo "❌ Errore: agency-shared-references/references non trovato"
+    exit 1
+fi
+
+# Conta i file reference
+REF_COUNT=$(ls -1 agency-shared-references/references/*.md 2>/dev/null | wc -l)
+echo "   ✓ agency-shared-references/references/ ($REF_COUNT file)"
+
+# Verifica che tutte le skills esistano
+SKILL_COUNT=0
 for skill_dir in agency-*/; do
-    # Salta la cartella shared-references
+    if [ -d "$skill_dir" ] && [ -f "$skill_dir/SKILL.md" ]; then
-    if [ "$skill_dir" = "agency-shared-references/" ]; then
+        SKILL_COUNT=$((SKILL_COUNT + 1))
-        echo "   ✓ $skill_dir (shared references, no symlink needed)"
+        echo "   ✓ $skill_dir"
-        continue
     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 ""
 echo "✅ Installation complete!"
 echo ""
 echo "Skills installate in: $TARGET"
+echo "Totale skills: $SKILL_COUNT"
+echo "Totale references: $REF_COUNT"
 echo ""
-echo "Skills disponibili:"
+echo "Nota: Nessun symlink necessario. I SKILL.md usano percorsi diretti."
-ls -1 "$TARGET" | grep -v references | sed 's/^/  - /'
+echo ""
+echo "Verifica installazione:"
+echo "  cd $TARGET"
+echo "  ls agency-shared-references/references/"
 echo ""
 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

@@ -21,13 +21,13 @@ La suite richiede una struttura directory specifica per funzionare correttamente
 
 2. **Verifica la struttura:**
    - Tutte le 15 cartelle delle skills devono essere presenti
-   - La cartella `agency-shared-references/` deve contenere tutti i file reference
+   - La cartella `agency-shared-references/` deve contenere tutti i 24 file reference
-   - Ogni skill deve avere un symlink `references/` che punta a `../agency-shared-references/references`
+   - Nessun symlink necessario: le skills puntano direttamente ai file con percorsi relativi
 
-3. **Verifica i symlink:**
+3. **Verifica i file:**
-   - Ogni skill (tranne `agency-shared-references`) deve avere un symlink `references` → `../agency-shared-references/references`
+   - I file reference sono accessibili direttamente da `agency-shared-references/references/`
-   - Su Unix/Linux/Mac: `ls -la */references` per verificare
+   - Ogni SKILL.md contiene percorsi completi verso le reference necessarie
-   - Su Windows: usa `dir */references` o ricrea i symlink se necessario
+   - Su qualsiasi piattaforma: `ls agency-shared-references/references/` per verificare
 
 4. **Testa l'installazione:**
    - Carica una skill (es. `/skill agency-orchestrator`)
@@ -40,20 +40,15 @@ cd /path/to/agency-skills-suite
 ./INSTALL.sh
 ```
 
-### Metodo 2: Copia Manuale
+### Metodo 2: Copia Manuale (Tutte le piattaforme)
 
 ```bash
 # Copia l'intera suite
 cp -r /path/to/agency-skills-suite ~/.openclaw/skills/
 
-# Verifica i symlink (Unix/Linux/Mac)
+# Verifica la struttura (nessun symlink necessario)
 cd ~/.openclaw/skills/agency-skills-suite
-for skill in agency-*/; do
+ls agency-shared-references/references/  # Deve mostrare 24 file
-  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)
@@ -155,44 +150,35 @@ agency-skills-suite/
 ├── README.md
 ├── INSTALL.sh
 ├── AGENCY_ARCHIVIST_DELIVERY.md
-├── agency-shared-references/     📚 References centralizzate
+├── agency-shared-references/     📚 References centralizzate (24 file)
 │   └── references/
 │       ├── design_patterns.md
 │       ├── hero_sections.md
-│       ├── ... (23 references)
+│       ├── ... (24 references)
 │       └── resource_types.md
 ├── agency-orchestrator/
-│   ├── SKILL.md
+│   └── SKILL.md                  # Puntano direttamente a ../agency-shared-references/references/
-│   └── references → ../agency-shared-references/references
 ├── agency-archivist/ ⭐
 │   ├── SKILL.md
 │   ├── README.md
-│   ├── scripts/
+│   └── scripts/
-│   │   ├── extract_archive.js    # Estrazione zip/URL
+│       ├── extract_archive.js
-│   │   ├── scan_resources.js     # Scansione metadata
+│       ├── scan_resources.js
-│   │   └── generate_catalog.js   # Generazione catalogo
+│       └── generate_catalog.js
-│   └── references → ../agency-shared-references/references
 ├── agency-strategy/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-research/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-creative-director/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-design-system/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-ux-copy/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-seo/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-social/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
 ├── agency-youtube/
 │   ├── SKILL.md
 │   └── references → ../agency-shared-references/references
@@ -206,13 +192,16 @@ agency-skills-suite/
 │   ├── SKILL.md
 │   └── references → ../agency-shared-references/references
 ├── agency-publisher/
-│   ├── SKILL.md
+│   └── SKILL.md
-│   └── references → ../agency-shared-references/references
+└── agency-youtube/
+    └── SKILL.md
 ```
 
+**Nota:** Nessun symlink necessario. Ogni SKILL.md contiene percorsi diretti verso `../agency-shared-references/references/`.
+
 ## Uso
 
-Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
+Ogni skill è auto-contenuta e punta direttamente ai file reference necessari.
 
 **Esempio:**
 
@@ -220,7 +209,7 @@ Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
 /skill agency-orchestrator
 ```
 
-La skill caricherà automaticamente le references necessarie dal percorso `../agency-shared-references/references`.
+La skill caricherà automaticamente le references necessarie dai percorsi specificati nel SKILL.md (`../agency-shared-references/references/*`).
 
 ### Uso di agency-archivist
 

agency-analytics/SKILL.md

@@ -177,7 +177,7 @@ Report KPI settimanali e azioni misurabili per social e YouTube.
 
 **Azioni:**
 
-1. Usa template da `references/weekly_report_template.md`
+1. Usa template da `../agency-shared-references/references/weekly_report_template.md`
 2. Compila tutte le sezioni
 3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md`
 4. Documenta azioni nel run log del progetto se richiedono follow-up

agency-analytics/references

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

agency-archivist/references

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

agency-creative-director/references

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

agency-design-system/SKILL.md

@@ -180,7 +180,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
    - Sezione header (hero)
    - Sezioni content (ordine)
    - Sezione footer
-   - Pattern usati (da references)
+   - Pattern usati (da agency-shared-references/references)
 
 **Template:**
 
@@ -268,7 +268,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile.
 
 - **Brand esistente:** Adatta tokens ai colori/font esistenti
 - **Progetto piccolo:** Semplifica (tokens essenziali + 5-6 components base)
-- **Nessun designer:** Usa pattern standard da references
+- **Nessun designer:** Usa pattern standard da agency-shared-references/references
 
 **Limitazioni:**
 

agency-design-system/references

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

agency-orchestrator/SKILL.md

@@ -175,7 +175,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile
    └── assets/           (immagini, video, documenti — gestito da agency-archivist)
    ```
 
-4. **Leggi `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`**
 
@@ -236,7 +236,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile
 
 1. Raccogli output da tutti gli agenti
 2. Verifica coerenza cross-deliverable
-3. Esegui QA checklist (vedi `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
 
 **QA Checklist:**
@@ -253,7 +253,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile
 
 **Azioni:**
 
-1. Verifica `references/publishing_gates.md`
+1. Verifica `../agency-shared-references/references/publishing_gates.md`
 2. Imposta `APPROVED: YES` nei file content (post-review)
 3. Crea `PUBLISH_APPROVED.md` se pronto
 4. Triggera `agency-publisher` solo se gate superato

agency-orchestrator/references

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

agency-publisher/references

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

agency-research/references

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

agency-seo/references

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

agency-social/references

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

agency-strategy/SKILL.md

@@ -55,7 +55,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content
 
 **Azioni:**
 
-1. Usa formula da `references/strategy_playbook.md`:
+1. Usa formula da `../agency-shared-references/references/strategy_playbook.md`:
    > "For [audience] who want [outcome], we provide [solution] unlike [alternative] because [proof]."
 
 2. Compila ogni elemento:
@@ -120,7 +120,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content
 2. Per ogni pillar, definisci:
    - Nome
    - Descrizione (1 frase)
-   - Format suggeriti (da `references/content_formats.md`)
+   - Format suggeriti (da `../agency-shared-references/references/content_formats.md`)
 
 **Esempio:**
 

agency-strategy/references

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

agency-ux-copy/SKILL.md

@@ -91,7 +91,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
    - CTA sections (mid-page, footer)
    - FAQ (se applicabile)
 
-2. Usa pattern da references:
+2. Usa pattern da agency-shared-references/references:
    - `hero_sections.md` per hero
    - `conversion_patterns.md` per CTA
    - `design_patterns.md` per layout
@@ -141,12 +141,12 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
    - Bullets: 3-5 punti chiave
    - Microcopy: Label, button text
 
-3. **Usa framework da `references/copy_frameworks.md`:**
+3. **Usa framework da `../agency-shared-references/references/copy_frameworks.md`:**
    - PAS (Problem-Agitate-Solve)
    - AIDA (Attention-Interest-Desire-Action)
    - Before-After-Bridge
 
-4. **Applica `references/conversion_patterns.md`:**
+4. **Applica `../agency-shared-references/references/conversion_patterns.md`:**
    - 1 CTA primaria per pagina
    - Ripeti CTA 2-3 volte
    - Friction reducers vicino a form

agency-ux-copy/references

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

agency-visual-generator/SKILL.md

@@ -174,7 +174,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide.
 
 **Azioni:**
 
-1. Usa checklist da `references/qa_visual.md`:
+1. Usa checklist da `../agency-shared-references/references/qa_visual.md`:
 
 **Readability:**
 - [ ] Text readable at mobile size (320px)

agency-visual-generator/references

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

agency-web-developer/SKILL.md

@@ -132,7 +132,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e
    - CTA sections
    - Form di contatto
 
-6. **Segui `references/html_semantics.md`:**
+6. **Segui `../agency-shared-references/references/html_semantics.md`:**
    - Semantic HTML best practices
    - Accessibility (ARIA labels dove necessario)
    - SEO on-page (heading structure, alt text)
@@ -173,7 +173,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e
    - Crea grid system (o usa CSS Grid/Flexbox)
    - Stilizza componenti uno a uno
 
-3. **Implementa da `references/css_layout.md`:**
+3. **Implementa da `../agency-shared-references/references/css_layout.md`:**
    - Responsive design (mobile-first)
    - Breakpoints (mobile, tablet, desktop)
    - Typography scale
@@ -225,7 +225,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e
    - Hover animations complesse
    - Timeline per sequenze animate
 
-4. **Segui `references/js_interactivity.md`:**
+4. **Segui `../agency-shared-references/references/js_interactivity.md`:**
    - Best practices jQuery
    - GSAP patterns
    - Performance considerations
@@ -360,8 +360,8 @@ $(document).ready(function() {
 **Flusso consigliato:**
 1. Leggi catalogo risorse (`assets/catalog.md`)
 2. Verifica asset disponibili o richiedi ad @agency-archivist
-3. Leggi pattern UX da shared references (COSA fare)
+3. Leggi pattern UX da `agency-shared-references/references` (COSA fare)
-4. Implementa con technical references (COME codificare)
+4. Implementa con technical references da `agency-shared-references/references` (COME codificare)
 
 ---
 

agency-web-developer/references

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

agency-youtube/SKILL.md

@@ -119,7 +119,7 @@ Strategia YouTube, calendario e script orientati a retention.
 
 **Azioni:**
 
-1. Usa struttura da `references/youtube_script_framework.md`:
+1. Usa struttura da `../agency-shared-references/references/youtube_script_framework.md`:
    - 0-10s: Hook (promise + curiosity)
    - 10-25s: Credibility (why listen)
    - 25-60s: Problem definition

agency-youtube/references

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