Vademecum · Onboarding collaboratori

Automazione
Social AL

Un motore unico che gestisce i social di più clienti con Claude Code: una sola logica, ogni cliente con i suoi dati. Crea i contenuti della settimana nel tono giusto e ricicla i migliori in caroselli.

Stato: in uso Tipo: sistema multi-cliente Piattaforma: Instagram Clienti attivi: 2

In una frase, e a chi serve

Orientarsi in 30 secondi.

Cos'è. Un set di 3 skill di Claude Code che, per ogni cliente social, fanno l'onboarding una volta, poi ogni settimana creano i contenuti e riciclano i migliori. La logica è una sola; cambi cliente = cambi solo l'argomento passato alla skill.

Il problema che risolve. Gestire più pagine a mano è lento e incoerente: ogni cliente ha un tono, un pubblico, dei paletti. Qui il tono di ogni cliente vive in due file (profilo.md + voice.md) e le skill leggono solo quelli - niente tono "medio da AI".

Perché è fatto così. Vive in iCloud e usa percorsi relativi, quindi lo stesso file funziona su Mac e Windows senza modifiche. Nessun percorso assoluto dentro le skill.

A chi serve

TomasManda avanti il ciclo settimanale di ogni cliente gestito dal motore.
Collaboratore socialAggiunge un cliente nuovo e lancia le due skill della settimana, crea e ricicla.
Cliente finale (AL)Riceve contenuti coerenti col proprio brand, li approva e poi li pubblica.

Stack e strumenti

Con cosa è costruito, e perché.

Strumento	Ruolo nel progetto	Perché scelto
Claude Code motore	Esegue le 3 skill che leggono i dati del cliente e scrivono i contenuti.	Una sola lingua di lavoro, skill come file di testo versionabili.
Markdown dati	`profilo.md` + `voice.md` per cliente: vincoli, pilastri, tono, off-limits.	Leggibile, editabile a mano, niente database da gestire.
iCloud Drive sync	Ospita tutto il motore, sincronizza tra Mac e PC Windows.	Stesso file su due dispositivi senza copie o Git obbligatorio.
Symlink → ~/.claude/skills collegamento	Collega le skill in iCloud a Claude Code, una volta per dispositivo.	File unico sincronizzato, non copie da riallineare a mano.
HTML + Python render	Genera i caroselli (slide) da esportare come PNG per il post.	Controllo pieno sulla grafica, coerente col format approvato.
Apify / Google AI opzionale	Sbloccherebbero reel-scripting e caroselli generati.	Token non impostati: se manca il token la skill lo salta e lavora a mano.

Le 3 skill

Comando	Quando	Cosa produce
`/nuovo-cliente <slug>`	Una volta, all'aggiunta pagina	Genera `profilo.md` + `voice.md` del cliente da sito/bio/post. Scheda da approvare.
`/settimana-social <slug>`	Lunedì (o quando crei)	Crea i contenuti della settimana nel tono del cliente. Salva in `output/AAAA-MM-GG.md`.
`/ricicla-social <slug>`	Venerdì (o quando ricicli)	Ricicla i più performanti in caroselli, in coda per la settimana dopo.

Come funziona - il flusso

Da cliente nuovo a post caricato.

Il ciclo per ogni cliente: onboarding una volta → lunedì crei → venerdì ricicli il meglio. L'ultimo passo è manuale, di proposito.

Onboarding

Incolli sito, bio, post. Rispondi a 4-5 domande. Approvi la scheda.

/nuovo-cliente

Crea settimana

La skill legge profilo + voice + ricerca di settore e scrive il mix.

/settimana-social

Ricicla

I contenuti migliori diventano caroselli, messi in coda.

/ricicla-social

Render slide

HTML+Python generano le slide del carosello come PNG.

export_slides.py

Approva & carica

Tomas/cliente rilegge, approva e carica a mano su Instagram.

manuale

Regola chiave. Le skill non hanno un tono proprio: leggono SOLO profilo.md + voice.md del cliente passato come argomento. /settimana-social pizzeria-mario è diverso da /settimana-social studio-rossi perché legge cartelle diverse, non perché la skill "sa" qualcosa di loro.

Dove finiscono le cose

Cartella	Contenuto
`motore-social/`	La logica: le 3 skill + il template cliente. Collegata a ~/.claude/skills.
`clienti/<slug>/`	I dati di quel cliente: profilo, voice, performance, output.
`clienti/<slug>/output/`	Contenuti creati (per data) + `coda-prossima-settimana.md`.
`clienti/<slug>/render/`	HTML dei caroselli, foto originali, script di export in PNG.

Onboarding collaboratore + spiegazione cliente

Come allineare chi arriva nuovo, e come raccontarlo a chi non è tecnico.

Collaboratore - primi passi

Da zero a produttivo

Installa Claude Code e collega le skill (blocco symlink nel README, una volta per dispositivo).
Apri un cliente esistente in clienti/al-consultant/ e leggi profilo.md + voice.md: è lì che vive tutto il tono.
Prova /settimana-social al-consultant e leggi l'output prima di toccare nulla.
Aggiungi un cliente finto con /nuovo-cliente prova per capire l'onboarding.

Collaboratore - cosa deve saper fare

Le competenze minime

Non serve programmare. Serve: capire cosa distingue il tono di un cliente, compilare/correggere i due file .md, lanciare le tre skill al momento giusto, e avere occhio critico sui contenuti prima che vadano al cliente.

Regola d'oro: mai numeri, fonti o performance inventati. Dato mancante = detto, non riempito.

Come lo spieghi al cliente (non tecnico)

"Abbiamo un sistema che conosce a memoria il tuo brand: il tuo tono, i tuoi pilastri, cosa non diresti mai. Ogni settimana prepara i contenuti già nel tuo stile, tu li approvi e li pubblichi. Niente post improvvisati, niente tono che cambia da un giorno all'altro."

Il cliente resta al comando: nulla va online senza la sua approvazione.

Paletti da spiegare subito

Nessuna pubblicazione automatica. Le skill preparano, una persona carica a mano su Instagram.
Il tono è vincolato. Ogni campo del profilo è un vincolo, non un suggerimento.
Formato AL fisso. "Il percorso" è sempre carosello, mai post singolo.

Paletti, limiti e stato

Cosa è vero oggi, cosa è ancora da fare.

Da fare più avanti

Promemoria	Lunedì/venerdì per cliente via `/schedule`.
Auto-selezione	Scelta automatica dei migliori quando `performance.md` ha ~5 righe.
Token	Valutare Apify/Google per sbloccare reel-scripting e caroselli generati.

Stato reale (onesto)

Pubblicazione IGManuale

Token Apify / GoogleNon impostati

Clienti onboardatial-consultant · al-altraparte

Selezione automatica miglioriDormiente