agentleFS
Lucas-GrilliLucas-Grilli/SMM_OS/.claude/skills/brand-memory/SKILL.md

brand-memory

Skill2 starsChanged 3 months agoMITView on GitHub

Costruisce le fondamenta di un cliente — brand brief, vocabolario, buyer persona, content pillars, obiettivi KPI — e le salva come stato permanente in 10_clienti/<nome>/. Usare per "ho un cliente nuovo", "devo costruire il brand brief", "non so come parla questo cliente", "creiamo le fondamenta", o prima di produrre qualsiasi contenuto per un cliente che non ha ancora i documenti fondanti.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Brand Memory

v1.0 — Modulo 0 di SMM-OS.

Il modulo che viene prima di tutto. Produce i documenti che ogni altra skill legge: senza questi, tutto il resto lavora al buio e produce contenuto generico.

Quando si attiva

  • Cliente appena firmato, prima di qualsiasi produzione.
  • Cliente esistente per cui brand-brief.md non esiste o è ancora [DA DEFINIRE] nei punti che servono.
  • L'utente chiede un contenuto e il Brand Brief manca: si dice che manca e si parte da qui (Regola 23).

Cosa legge

  • 10_clienti/<nome>/ — se la cartella non esiste, si apre prima con cliente-kickoff.
  • Materiale grezzo che l'utente ha su quel cliente: appunti di call, sito, profili social, vecchi contenuti. Se è ancora in 01_raw/, va bene: si legge da lì.

La sequenza

Otto passi in ordine, più uno di chiusura. Ogni passo scrive un file: il successivo lo legge da lì, l'utente non incolla niente a mano.

#PassoPromptScrive
0Spoglio degli appunti — cosa il cliente ha chiesto(nessuno: si legge)richieste-cliente.md
1Brand Brief — identità, tono, vocabolario, target01brand-brief.md
2Vocabolario operativo — il filtro linguistico02vocabolario.md
3Analisi competitor — gli spazi bianchi da occupare03competitor.md
4Buyer persona — ritratto psicologico, non demografico04buyer-persona.md
5Content pillars — i territori narrativi05content-pillars.md
6Analisi pubblico — dagli insights alle indicazioni editoriali06analisi-pubblico.md
7Obiettivi social — business tradotto in KPI07obiettivi-kpi.md
8Brand voice test — la verifica su un contenuto08(nessuno: è un controllo)
9System prompt cliente — tutto compresso in una istruzione09CLAUDE.md del cliente

I passi 1, 4, 5 e 7 sono il minimo per poter produrre contenuti. I passi 3 e 6 richiedono materiale che non sempre c'è al giorno uno (competitor mappati, insights delle piattaforme): se manca, si saltano e si tornano a fare dopo, senza bloccare la sequenza.

Il passo 9 va eseguito dopo che i precedenti hanno prodotto i loro file, perché li comprime: rifarlo quando i documenti fondanti cambiano in modo sostanziale.

Passo 0 — lo spoglio degli appunti

Non ha un prompt: si legge. Prima di costruire qualsiasi documento, si passano gli appunti della call cercando tre cose che i prompt successivi non guardano, e si scrivono in richieste-cliente.md:

  1. Cosa il cliente ha chiesto esplicitamente. Ogni richiesta, anche detta di sfuggita. Per ognuna: è sensata, o lavora contro il suo stesso obiettivo? Una richiesta dannosa non si esegue in silenzio e non si ignora — si porta a relazione-cliente/03, che produce la risposta da dargli. Il caso tipico è "voglio diventare virale".
  2. Le domande che ha fatto e a cui non è stata data risposta. "Quanto ci mettiamo a vedere i risultati", "quanto costa": restano aperte finché qualcuno non risponde, e vanno nei thread aperti di memory.md del cliente.
  3. I dati mancanti o dichiarati incerti. Budget non toccato, cifre "circa", cose da verificare. Diventano la lista di cosa chiedere al cliente, ed è la stessa lista che alimenta i [DA DEFINIRE] a valle (Regola 25).

Senza questo passo le richieste del cliente cadono nel vuoto: i prompt da 01 in poi estraggono l'identità del brand, non ciò che il cliente vuole dall'SMM.

Il passo 8 va eseguito per intero

Il Brand Voice Test è il controllo qualità di tutto il sistema, ed è anche il fact-checker: verifica che ogni numero, tempo, prezzo e nome nel contenuto risalga a una fonte reale. Per farlo gli servono tutti i documenti del cliente più gli appunti grezzi — {{BRAND_BRIEF}}, {{BUYER_PERSONA}}, {{CONTENT_PILLARS}}, {{APPUNTI_CALL}}.

Eseguirlo col solo Brand Brief lo rende cieco: segnala come inventato ciò che il sistema stesso ha deciso due passi prima, e lascia passare i dati falsi ereditati dai documenti fondanti.

Come si esegue un passo

  1. Apri il file del prompt (solo quello che serve — Regola 7).
  2. Riempi le variabili {{...}} leggendo dallo stato, non chiedendo all'utente: {{BRAND_BRIEF}} è il contenuto di brand-brief.md, {{BUYER_PERSONA}} è buyer-persona.md, e così via. Si chiede all'utente solo ciò che nel sistema non c'è ancora.
  3. Esegui.
  4. Salva l'output nel file indicato in tabella, senza commenti aggiunti: il file contiene il documento, non la conversazione che l'ha prodotto.
  5. Aggiorna 10_clienti/<nome>/memory.md con cosa è stato costruito.

Regole dure

  • Non si inventa niente su un cliente reale. Ogni buco resta [DA DEFINIRE] e si segnala all'utente alla fine del passo, in una riga: quelli sono i dati da recuperare dal cliente (Regola 25).
  • Un aggettivo non è un tono di voce. Ogni caratteristica va accompagnata da una frase-esempio reale che la dimostra (Regola 26).
  • Il Brand Brief non si rifà da capo quando cambia un dettaglio: si modifica il punto che è cambiato e si rigenera il passo 9. Se lo si sostituisce interamente, il contenuto vecchio va in archive.md del cliente prima (Regola 3).
  • Se l'utente ha materiale grezzo non ancora digerito, prima il bibliotecario, poi questa skill: leggere da note ordinate produce fondamenta migliori che leggere da un dump.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.