Initial release: agency_v3_1-skills-suite v1.0
- 12 AgentSkills generate da agency_v3_1 framework - 17 references centralizzate - Script INSTALL.sh per installazione automatica - README.md con documentazione completa Skills incluse: - agency-orchestrator (coordinamento + QA) - agency-strategy (positioning, messaging) - agency-research (competitive intelligence) - agency-creative-director (direzione visiva) - agency-design-system (tokens, components) - agency-ux-copy (sitemap, copy) - agency-seo (SEO tecnico) - agency-social (social strategy) - agency-youtube (YouTube strategy) - agency-visual-generator (asset visuali) - agency-analytics (report KPI) - agency-publisher (publish gate-based) Generated by framework-translator v2.0 Approved by: MarcoB (2026-03-09)
This commit is contained in:
AgentePotente
commit
6ac766172c
47 changed files with 4165 additions and 0 deletions
35
references/audience_personas.md
Normal file
35
references/audience_personas.md
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
# Audience Personas
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-strategy, agency-research_
|
||||
|
||||
## Sommario
|
||||
|
||||
Template per definire ICP e personas.
|
||||
|
||||
---
|
||||
|
||||
## Persona Template
|
||||
|
||||
| Campo | Descrizione |
|
||||
|-------|-----------|
|
||||
| **Nome** | Nome fittizio della persona |
|
||||
| **Ruolo/Contesto** | Lavoro, settore, situazione |
|
||||
| **Obiettivi** | Cosa vuole raggiungere |
|
||||
| **Pain Points** | Problemi, frustrazioni |
|
||||
| **Trigger di Acquisto** | Cosa li spinge a cercare soluzioni |
|
||||
| **Obiezioni** | Dubbi, barriere all'acquisto |
|
||||
| **Canali** | Dove si informano (social, search, etc.) |
|
||||
| **Linguaggio** | Parole che usano (verbatim) |
|
||||
|
||||
---
|
||||
|
||||
## Note
|
||||
|
||||
- Compilare 2-4 personas per cliente
|
||||
- Usare linguaggio reale (da interviste, recensioni, social)
|
||||
- Aggiornare dopo research competitor
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
49
references/brand_voice.md
Normal file
49
references/brand_voice.md
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
# Brand Voice
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-strategy, agency-social, agency-youtube_
|
||||
|
||||
## Sommario
|
||||
|
||||
Linee guida tono di voce per web e social.
|
||||
|
||||
---
|
||||
|
||||
## Attributi (scegline 3-5)
|
||||
|
||||
- Professionale ma umano
|
||||
- Diretto
|
||||
- Ottimista realistico
|
||||
- Tecnico solo quando serve
|
||||
- Ironico (leggero)
|
||||
|
||||
---
|
||||
|
||||
## Dos & Don'ts
|
||||
|
||||
### Do
|
||||
- Frasi brevi, verbi attivi
|
||||
- Spiegazioni con esempi
|
||||
- CTA chiare
|
||||
|
||||
### Don't
|
||||
- Superlativi vuoti ("il migliore")
|
||||
- Fuffa motivazionale
|
||||
- Troppo slang se non coerente
|
||||
|
||||
---
|
||||
|
||||
## Micro-linee Guida
|
||||
|
||||
**Emoji:**
|
||||
- (Sì/No) + regole specifiche
|
||||
|
||||
**Uso del "tu" vs "voi":**
|
||||
- Definire preferenza
|
||||
|
||||
**Punteggiatura:**
|
||||
- Es. niente !!!
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
57
references/case_study_structures.md
Normal file
57
references/case_study_structures.md
Normal file
|
|
@ -0,0 +1,57 @@
|
|||
# Case Study Structures
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-strategy, agency-ux-copy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Template per case study che dimostrano competenza e riducono rischio percepito.
|
||||
|
||||
---
|
||||
|
||||
## Case Study Skeleton (Consigliato)
|
||||
|
||||
### 1) Snapshot
|
||||
- Cliente / settore
|
||||
- Obiettivo
|
||||
- Servizi
|
||||
- Risultato chiave (1-3 metriche)
|
||||
|
||||
### 2) Problema
|
||||
- Contesto
|
||||
- Vincoli
|
||||
- Perché era difficile
|
||||
|
||||
### 3) Approccio
|
||||
- Strategia
|
||||
- Decisioni chiave (3-5)
|
||||
|
||||
### 4) Soluzione
|
||||
- Cosa è stato creato
|
||||
- Highlights
|
||||
|
||||
### 5) Risultati
|
||||
- Metriche (se disponibili)
|
||||
- Output qualitativi (es. "riduzione frizione")
|
||||
|
||||
### 6) Learnings
|
||||
- Cosa rifaresti
|
||||
- Cosa evitare
|
||||
|
||||
### 7) CTA
|
||||
- "Vuoi un progetto simile?"
|
||||
|
||||
---
|
||||
|
||||
## Se Non Hai Metriche
|
||||
|
||||
**Usa:**
|
||||
- Outcomes qualitativi
|
||||
- Deliverable concreti
|
||||
- Quote cliente
|
||||
|
||||
**Indica:** "Metriche non disponibili" (trasparenza).
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
75
references/content_formats.md
Normal file
75
references/content_formats.md
Normal file
|
|
@ -0,0 +1,75 @@
|
|||
# Content Formats
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-social, agency-youtube_
|
||||
|
||||
## Sommario
|
||||
|
||||
Formati content per social e YouTube, organizzati per rubriche.
|
||||
|
||||
---
|
||||
|
||||
## Content Pillars → Formats
|
||||
|
||||
Ogni pillar dovrebbe produrre 3-5 format ricorrenti (rubriche).
|
||||
|
||||
---
|
||||
|
||||
## Social Formats (Agency)
|
||||
|
||||
### 1) Breakdown (analisi di un sito/campagna)
|
||||
- Hook: "3 cose che funzionano / non funzionano"
|
||||
- Bullets
|
||||
- Takeaway
|
||||
|
||||
### 2) Mini-case (prima/dopo)
|
||||
- Contesto
|
||||
- Intervento
|
||||
- Risultato (anche qualitativo)
|
||||
|
||||
### 3) Opinion / POV
|
||||
- Tesi chiara
|
||||
- 2-3 argomenti
|
||||
- CTA: commenta / DM
|
||||
|
||||
### 4) Process Snippet
|
||||
- Come lavorate
|
||||
- Step e strumenti
|
||||
|
||||
### 5) Toolkit / Checklist
|
||||
- Template
|
||||
- Lista rapida
|
||||
|
||||
**Regola:** 1 CTA semplice per post.
|
||||
|
||||
---
|
||||
|
||||
## YouTube Formats
|
||||
|
||||
### A) Tutorial (How-to)
|
||||
- Promise in hook
|
||||
- Step-by-step
|
||||
- Recap + CTA
|
||||
|
||||
### B) Teardown (competitor/site review)
|
||||
- Framework
|
||||
- Score
|
||||
- Recommendations
|
||||
|
||||
### C) Case Study Narrative
|
||||
- Problema
|
||||
- Viaggio
|
||||
- Risultato
|
||||
- Lezioni
|
||||
|
||||
---
|
||||
|
||||
## YouTube Retention Tips
|
||||
|
||||
- Hook <10s
|
||||
- Pattern interrupts ogni 20-40s (grafica, esempio, cambio ritmo)
|
||||
- Chapters chiari
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
73
references/conversion_patterns.md
Normal file
73
references/conversion_patterns.md
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
# Conversion Patterns
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-ux-copy, agency-strategy_
|
||||
|
||||
## Sommario
|
||||
|
||||
CTA, forms e friction reduction per conversioni.
|
||||
|
||||
---
|
||||
|
||||
## CTA Hierarchy
|
||||
|
||||
- 1 CTA primaria per pagina
|
||||
- 1 CTA secondaria (link-style)
|
||||
- Ripetere CTA primaria 2-3 volte (hero, mid, footer)
|
||||
|
||||
---
|
||||
|
||||
## Contact Section Patterns
|
||||
|
||||
### A) Simple Form
|
||||
- Nome, email, messaggio (max 3-4 campi)
|
||||
|
||||
### B) Calendly / Booking
|
||||
- Utile per agency; includere alternative (email) per chi non vuole booking
|
||||
|
||||
### C) Project Brief Form
|
||||
- Solo se necessario; meglio a step
|
||||
|
||||
**Regole:**
|
||||
- Meno campi = più conversione (di solito)
|
||||
- Indicare tempi di risposta (es. 24-48h)
|
||||
- Privacy microcopy vicino al submit
|
||||
|
||||
---
|
||||
|
||||
## Lead Magnet (Optional)
|
||||
|
||||
**Quando usarlo:**
|
||||
- Se vuoi "consideration" lunga
|
||||
|
||||
**Esempi:**
|
||||
- Checklist
|
||||
- Mini guida
|
||||
- Template
|
||||
|
||||
---
|
||||
|
||||
## Friction Reducers (Microcopy)
|
||||
|
||||
- "Nessuno spam. Rispondiamo entro 48h."
|
||||
- "Puoi anche scriverci a..."
|
||||
- "Budget indicativo? Va bene anche una range."
|
||||
|
||||
---
|
||||
|
||||
## Conversion Blocks
|
||||
|
||||
- "Process" (3-5 step)
|
||||
- "What you get" (deliverables)
|
||||
- "FAQ" (obiezioni)
|
||||
|
||||
---
|
||||
|
||||
## Anti-pattern
|
||||
|
||||
- CTA vaghe ("Scopri di più" ovunque)
|
||||
- Form lunghissimi senza motivazione
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
71
references/copy_frameworks.md
Normal file
71
references/copy_frameworks.md
Normal file
|
|
@ -0,0 +1,71 @@
|
|||
# Copy Frameworks
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-strategy, agency-ux-copy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Framework copywriting clarity-first per web e social.
|
||||
|
||||
---
|
||||
|
||||
## Regole Generali
|
||||
|
||||
- Parole semplici > gergo
|
||||
- Frasi corte quando possibile
|
||||
- Evitare claim assoluti non verificabili
|
||||
- Scrivere per "scan" (titoli, bullets, bold con parsimonia)
|
||||
|
||||
---
|
||||
|
||||
## PAS (Problem-Agitate-Solve)
|
||||
|
||||
**Struttura:**
|
||||
- **Problem:** descrivi il problema del cliente
|
||||
- **Agitate:** conseguenze se non risolto
|
||||
- **Solve:** come lo risolvi
|
||||
|
||||
**Ottimo per:**
|
||||
- Hero sub-copy
|
||||
- Section intro
|
||||
|
||||
---
|
||||
|
||||
## AIDA (Attention-Interest-Desire-Action)
|
||||
|
||||
**Ottimo per:**
|
||||
- Landing page
|
||||
- Sales section
|
||||
|
||||
---
|
||||
|
||||
## Before-After-Bridge
|
||||
|
||||
**Struttura:**
|
||||
- **Before:** situazione attuale
|
||||
- **After:** situazione desiderata
|
||||
- **Bridge:** come ci arrivi (process)
|
||||
|
||||
---
|
||||
|
||||
## Microcopy (Forms/Buttons)
|
||||
|
||||
**Button:**
|
||||
- Usare verbi chiari ("Prenota call", "Richiedi info")
|
||||
|
||||
**Error:**
|
||||
- Spiegare cosa fare
|
||||
|
||||
**Privacy:**
|
||||
- Rassicurare
|
||||
|
||||
---
|
||||
|
||||
## Tone Guardrails
|
||||
|
||||
- Preferire assertività tranquilla (non hype)
|
||||
- Evitare frasi "AI-ish" (troppo generiche)
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
110
references/design_patterns.md
Normal file
110
references/design_patterns.md
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
# Design Patterns
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-creative-director, agency-design-system, agency-ux-copy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern UI riusabili per siti agency/services. Strutture, non stile.
|
||||
|
||||
---
|
||||
|
||||
## Card Grid (Services / Features)
|
||||
|
||||
**Quando usarlo:**
|
||||
- Overview servizi
|
||||
- Differentiatori
|
||||
- Step del processo
|
||||
|
||||
**Regole:**
|
||||
- Max 6 card desktop, 3-4 mobile
|
||||
- Titolo breve + payoff 1 riga + micro-CTA
|
||||
- Icone solo se aggiungono semantica (non decorative)
|
||||
|
||||
**Varianti:**
|
||||
- Icon + title + 2 bullets
|
||||
- Number + title + paragraph (per process)
|
||||
- Split card (testo + mini proof)
|
||||
|
||||
---
|
||||
|
||||
## Split Layout (Text + Visual)
|
||||
|
||||
**Quando usarlo:**
|
||||
- Spiegare un concetto o metodo
|
||||
- Mostrare case study teaser
|
||||
|
||||
**Regole:**
|
||||
- Testo a sinistra per lingue LTR (scansione naturale)
|
||||
- 1 solo focus visual (non collage)
|
||||
- Includere 1 proof nello stesso blocco (numero, logo, quote)
|
||||
|
||||
---
|
||||
|
||||
## Section Header (Headline + Support)
|
||||
|
||||
**Pattern:**
|
||||
- Overline (categoria)
|
||||
- Headline (promessa)
|
||||
- Supporting copy (beneficio concreto)
|
||||
- Optional: inline CTA
|
||||
|
||||
**Regole:**
|
||||
- Headline: 6-12 parole
|
||||
- Supporting: 1-2 frasi, senza gergo
|
||||
|
||||
---
|
||||
|
||||
## Logo Wall (Credibility)
|
||||
|
||||
**Quando usarlo:**
|
||||
- Subito dopo hero o dopo services
|
||||
|
||||
**Regole:**
|
||||
- Max 12 loghi visibili (se più, carousel o "view all")
|
||||
- Testo di contesto (es. "Trusted by" o "We worked with")
|
||||
- Evitare loghi non autorizzati
|
||||
|
||||
---
|
||||
|
||||
## Testimonial Block
|
||||
|
||||
**Varianti:**
|
||||
- Quote singola "hero testimonial"
|
||||
- Grid di 3 testimonial
|
||||
- Testimonial + risultato (numero)
|
||||
|
||||
**Regole:**
|
||||
- Migliore se contiene un risultato specifico
|
||||
- Includere nome/ruolo/azienda quando possibile
|
||||
- Se anonimo: spiegare perché (settore sensibile)
|
||||
|
||||
---
|
||||
|
||||
## FAQ (Objections)
|
||||
|
||||
**Quando usarlo:**
|
||||
- Prima della CTA finale
|
||||
- Su services e contact
|
||||
|
||||
**Regole:**
|
||||
- 5-8 domande
|
||||
- Domande reali (prezzo, tempi, processo, revisioni)
|
||||
- Risposte brevi e pratiche
|
||||
|
||||
---
|
||||
|
||||
## Footer (Actionable)
|
||||
|
||||
**Include:**
|
||||
- CTA compatta
|
||||
- Contatti chiari
|
||||
- Link legali
|
||||
- Social (se utili)
|
||||
|
||||
**Regola:**
|
||||
- Footer deve "chiudere" il funnel, non solo link.
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
84
references/hero_sections.md
Normal file
84
references/hero_sections.md
Normal file
|
|
@ -0,0 +1,84 @@
|
|||
# Hero Sections
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-creative-director, agency-ux-copy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern e formule per hero section efficaci. Deve rispondere in 5 secondi.
|
||||
|
||||
---
|
||||
|
||||
## Hero Checklist (5 secondi)
|
||||
|
||||
L'hero deve rispondere a:
|
||||
1. Cosa fai
|
||||
2. Per chi
|
||||
3. Che risultato dai
|
||||
4. Perché fidarsi
|
||||
5. Qual è la prossima azione
|
||||
|
||||
---
|
||||
|
||||
## Hero Formula (Services / Agency)
|
||||
|
||||
**Headline:** Outcome + Audience
|
||||
**Sub:** Come lo fai (meccanismo) + proof
|
||||
**CTA primaria:** "Prenota call" / "Richiedi preventivo" / "Vedi lavori"
|
||||
**CTA secondaria:** "Guarda casi studio" / "Scarica guida"
|
||||
|
||||
**Esempi (struttura, non testo finale):**
|
||||
- "Brand e siti che convertono per [audience]"
|
||||
- "Strategia, design e contenuti per crescere con coerenza"
|
||||
|
||||
---
|
||||
|
||||
## Hero Layouts
|
||||
|
||||
### A) Split (text + visual)
|
||||
- Consigliato per studi: pulito, conversion-friendly
|
||||
|
||||
### B) Centered minimal
|
||||
- Consigliato se il messaggio è fortissimo e semplice
|
||||
|
||||
### C) Proof-first
|
||||
- Headline + 3 proof chip (numeri/risultati) + CTA
|
||||
|
||||
---
|
||||
|
||||
## Proof Chips (sotto CTA)
|
||||
|
||||
Esempi:
|
||||
- "+120 progetti"
|
||||
- "Da 7 anni"
|
||||
- "Tempo medio: 4-6 settimane"
|
||||
- "Specializzati in [niche]"
|
||||
|
||||
**Regola:** Meglio 1-3 chip concreti che 6 generici.
|
||||
|
||||
---
|
||||
|
||||
## Hero Visuals
|
||||
|
||||
**Scelte consigliate:**
|
||||
- Fotografia editoriale (autentica)
|
||||
- Mockup selettivo (1-2, non griglia infinita)
|
||||
- Abstract/3D coerente (non stock casuale)
|
||||
|
||||
**Anti-pattern:**
|
||||
- "Team smiling in office" stock
|
||||
- Collage confusi
|
||||
- Troppo testo dentro l'immagine
|
||||
|
||||
---
|
||||
|
||||
## Above-the-Fold Checklist
|
||||
|
||||
- [ ] Value prop chiara
|
||||
- [ ] CTA visibile
|
||||
- [ ] Proof presente
|
||||
- [ ] Nessun rumore (nav troppo densa, troppi link)
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
68
references/layout_systems.md
Normal file
68
references/layout_systems.md
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
# Layout Systems
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-design-system, agency-creative-director_
|
||||
|
||||
## Sommario
|
||||
|
||||
Grid, spacing, density per coerenza e ritmo verticale.
|
||||
|
||||
---
|
||||
|
||||
## Grid (Web)
|
||||
|
||||
**Desktop:** 12 colonne (o 2/3/4 macro colonne)
|
||||
**Tablet:** 8 colonne
|
||||
**Mobile:** 4 colonne (stack verticale)
|
||||
|
||||
**Regola pratica:**
|
||||
- Usa una "content column" leggibile (non full-width testo)
|
||||
|
||||
---
|
||||
|
||||
## Container Widths
|
||||
|
||||
**Linee guida:**
|
||||
- Max content width: 1100-1200px
|
||||
- Reading width per paragrafi: 60-80 caratteri
|
||||
|
||||
---
|
||||
|
||||
## Spacing System
|
||||
|
||||
**Scala modulare preferita:** 4/8/16/24/32/48/64
|
||||
|
||||
**Sezioni:**
|
||||
- Padding top/bottom minimo: 64-96px desktop, 40-64px mobile
|
||||
- Separare sezioni con whitespace, non linee ovunque
|
||||
|
||||
---
|
||||
|
||||
## Density Modes
|
||||
|
||||
| Mode | Descrizione | Uso |
|
||||
|------|-----------|-----|
|
||||
| Airy | Più spazio, premium feel | Brand luxury, high-end |
|
||||
| Balanced | Equilibrio | Maggior parte dei casi |
|
||||
| Dense | Compatto | Pagine data-heavy |
|
||||
|
||||
**Regola:** Scegli 1 density mode dominante e mantienilo.
|
||||
|
||||
---
|
||||
|
||||
## Vertical Rhythm
|
||||
|
||||
- Headline → supporting → content → CTA: sempre con spacing prevedibile
|
||||
- Evitare "salti" casuali
|
||||
|
||||
---
|
||||
|
||||
## Responsive Heuristics
|
||||
|
||||
- Non "ridurre" tutto: spesso serve "stackare" e cambiare ordine
|
||||
- CTA sempre tappabile e visibile
|
||||
- Immagini: evitare crop che elimina il soggetto
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
60
references/navigation_patterns.md
Normal file
60
references/navigation_patterns.md
Normal file
|
|
@ -0,0 +1,60 @@
|
|||
# Navigation Patterns
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-ux-copy, agency-design-system_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern di navigazione e information architecture per siti agency/services.
|
||||
|
||||
---
|
||||
|
||||
## Primary Navigation (Agency/Services)
|
||||
|
||||
**Consigliato:**
|
||||
- Services
|
||||
- Work / Case studies
|
||||
- About
|
||||
- Resources (optional)
|
||||
- Contact
|
||||
|
||||
**Regole:**
|
||||
- Max 5 voci primarie
|
||||
- 1 CTA button in nav (es. "Prenota call")
|
||||
- Evitare mega-menu se non necessario
|
||||
|
||||
---
|
||||
|
||||
## Services IA
|
||||
|
||||
**Opzione A) Service overview + pagine dettagli**
|
||||
- Usa se l'offerta è complessa
|
||||
|
||||
**Opzione B) Packages + outcomes**
|
||||
- Usa se l'offerta è productizzata
|
||||
|
||||
---
|
||||
|
||||
## Work / Case Studies IA
|
||||
|
||||
- Index con filtri leggeri (industry/service)
|
||||
- Scheda case: problema → approccio → soluzione → risultato
|
||||
|
||||
---
|
||||
|
||||
## Mobile Nav
|
||||
|
||||
- Menu semplice, max 1 livello
|
||||
- CTA sempre visibile (sticky o nel menu in alto)
|
||||
|
||||
---
|
||||
|
||||
## Anti-pattern
|
||||
|
||||
- 9 voci in nav
|
||||
- Dropdown profondi
|
||||
- CTA nascosta
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
47
references/platform_patterns.md
Normal file
47
references/platform_patterns.md
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
# Platform Patterns
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-social, agency-visual-generator_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern specifici per piattaforma social.
|
||||
|
||||
---
|
||||
|
||||
## LinkedIn
|
||||
|
||||
- Hook + valore + proof
|
||||
- Tone: professionale, concreto
|
||||
- CTA: "dimmi nei commenti" / "DM"
|
||||
|
||||
---
|
||||
|
||||
## Instagram
|
||||
|
||||
**Carousel:**
|
||||
- 1 idea + step + recap
|
||||
|
||||
**Reel:**
|
||||
- Hook → 3 punti → CTA "salva"
|
||||
|
||||
---
|
||||
|
||||
## X / Twitter
|
||||
|
||||
**Thread:**
|
||||
- Promessa → punti numerati → chiusura
|
||||
|
||||
**Single Tweet:**
|
||||
- Insight + esempio
|
||||
|
||||
---
|
||||
|
||||
## TikTok
|
||||
|
||||
- Hook visivo + testo
|
||||
- Ritmo alto, tagli rapidi
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
40
references/publishing_gates.md
Normal file
40
references/publishing_gates.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
# Publishing Gates
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-orchestrator, agency-publisher_
|
||||
|
||||
## Sommario
|
||||
|
||||
Gate di approvazione pre-publish per website, social, YouTube.
|
||||
|
||||
---
|
||||
|
||||
## Regole di Publish
|
||||
|
||||
Publishing allowed only when:
|
||||
|
||||
1. **PUBLISH_APPROVED.md** contiene `YES`
|
||||
2. **Content file** contiene `APPROVED: YES` nel frontmatter
|
||||
3. **Logs** sono aggiornati dopo publishing
|
||||
|
||||
---
|
||||
|
||||
## Flusso
|
||||
|
||||
```
|
||||
Draft → Review → Approved → Published
|
||||
```
|
||||
|
||||
- Mai publish senza `APPROVED: YES`
|
||||
- Aggiornare publish log dopo ogni publish
|
||||
|
||||
---
|
||||
|
||||
## Eccezioni
|
||||
|
||||
- Nessuna eccezione: gate è obbligatorio
|
||||
- In caso di urgenza: approvazione esplicita richiesta
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
51
references/qa_visual.md
Normal file
51
references/qa_visual.md
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
# QA Visual Checklist
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-visual-generator, agency-publisher_
|
||||
|
||||
## Sommario
|
||||
|
||||
Checklist per review asset visuali generati (card, carousel, thumbnail).
|
||||
|
||||
---
|
||||
|
||||
## Readability
|
||||
|
||||
- [ ] Text readable at mobile size (simulate 320px wide)
|
||||
- [ ] Strong contrast between text and background
|
||||
- [ ] Headline <= 8 words (unless carousel)
|
||||
|
||||
---
|
||||
|
||||
## Brand
|
||||
|
||||
- [ ] Colors match the client style guide
|
||||
- [ ] Fonts match the client style guide (or fallback defined)
|
||||
- [ ] No off-brand icons/illustrations
|
||||
|
||||
---
|
||||
|
||||
## Message
|
||||
|
||||
- [ ] One clear idea per image
|
||||
- [ ] Visual supports the hook/CTA, not competing with it
|
||||
- [ ] No misleading visuals
|
||||
|
||||
---
|
||||
|
||||
## Technical
|
||||
|
||||
- [ ] Correct aspect ratio for platform
|
||||
- [ ] No obvious artifacts / broken text
|
||||
- [ ] Safe margins for UI overlays
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
- **If pass:** mark asset as `approved`
|
||||
- **If fail:** write fixes in `clients/{client}/backlog/tasks.md`
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
41
references/quality_bar.md
Normal file
41
references/quality_bar.md
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
# Quality Bar
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-orchestrator, tutte le skills_
|
||||
|
||||
## Sommario
|
||||
|
||||
Standard minimo accettabile per deliverable V1.
|
||||
|
||||
---
|
||||
|
||||
## V1 Principles
|
||||
|
||||
- **Completa > Perfetta**
|
||||
- **Tracciabile** (decision log + sources log)
|
||||
- **Ripetibile** (template + checklist)
|
||||
|
||||
---
|
||||
|
||||
## Pass/Fail Checklist (Generale)
|
||||
|
||||
### Pass se:
|
||||
- Output in path corretto
|
||||
- Frontmatter presente e valido
|
||||
- Fonti loggate quando richiesto
|
||||
- QA checklist compilata
|
||||
|
||||
### Fail se:
|
||||
- Output mancante o in path sbagliato
|
||||
- Citazioni senza sources log
|
||||
- Tentativo di publish senza `approved`
|
||||
|
||||
---
|
||||
|
||||
## Applicazione
|
||||
|
||||
Ogni skill deve verificare questi criteri prima di considerare un task completo.
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
46
references/research_citation_rules.md
Normal file
46
references/research_citation_rules.md
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
# Research Citation Rules
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-research_
|
||||
|
||||
## Sommario
|
||||
|
||||
Regole per citazione e logging fonti esterne.
|
||||
|
||||
---
|
||||
|
||||
## Obbligo
|
||||
|
||||
Tutte le fonti esterne devono essere loggate e referenziate.
|
||||
|
||||
---
|
||||
|
||||
## Web Research
|
||||
|
||||
Consentita **solo** su domini in whitelist:
|
||||
- Vedi `web_whitelist.yaml`
|
||||
- Vedi `web_sourcing_standard.md`
|
||||
|
||||
---
|
||||
|
||||
## Formato
|
||||
|
||||
- Usa ID `SRC-###`
|
||||
- Per client: `clients/{client}/research/sources.md`
|
||||
- Per libreria OS: `core/knowledge/sources/SRC-###.md`
|
||||
|
||||
---
|
||||
|
||||
## Contenuto Minimo
|
||||
|
||||
Ogni source log deve includere:
|
||||
- Data accesso
|
||||
- Titolo
|
||||
- Publisher/autore
|
||||
- URL
|
||||
- Affidabilità + motivazione
|
||||
- Note / estratti brevi
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
50
references/research_playbook.md
Normal file
50
references/research_playbook.md
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
# Research Playbook
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-research_
|
||||
|
||||
## Sommario
|
||||
|
||||
Metodo per research competitor e reference.
|
||||
|
||||
---
|
||||
|
||||
## Competitor Research
|
||||
|
||||
**Analizzare almeno 3 competitor.**
|
||||
|
||||
**Studiare:**
|
||||
- Positioning
|
||||
- Messaging
|
||||
- Offer structure
|
||||
- Conversion mechanics
|
||||
- Trust signals
|
||||
- UX structure
|
||||
- Visual language
|
||||
|
||||
**Deliver insights:**
|
||||
- Copy (cosa copiare)
|
||||
- Avoid (cosa evitare)
|
||||
- Opportunity (opportunità)
|
||||
|
||||
---
|
||||
|
||||
## Reference Research
|
||||
|
||||
**Look outside the industry for inspiration.**
|
||||
|
||||
**Raccogliere esempi di:**
|
||||
- Hero sections
|
||||
- Layout structures
|
||||
- Navigation patterns
|
||||
- Case study formats
|
||||
- Animation and motion
|
||||
|
||||
**Per ogni reference document:**
|
||||
- Why it works
|
||||
- What to borrow
|
||||
- Possible risks
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
74
references/strategy_playbook.md
Normal file
74
references/strategy_playbook.md
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
# Strategy Playbook
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-strategy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Framework per positioning, messaging e direzione strategica.
|
||||
|
||||
---
|
||||
|
||||
## Positioning
|
||||
|
||||
**Definire:**
|
||||
- Audience
|
||||
- Problem
|
||||
- Desired outcome
|
||||
- Unique value
|
||||
- Proof
|
||||
|
||||
**Formula:**
|
||||
> "For [audience] who want [outcome], we provide [solution] unlike [alternative] because [proof]."
|
||||
|
||||
---
|
||||
|
||||
## Messaging
|
||||
|
||||
### Message House
|
||||
|
||||
**Core message:**
|
||||
- Primary promise of the brand
|
||||
|
||||
**Supporting messages:**
|
||||
- 3-5 key arguments supporting the promise
|
||||
|
||||
**Proof points:**
|
||||
- Evidence such as results, numbers, testimonials
|
||||
|
||||
**CTA:**
|
||||
- Desired action (contact, signup, purchase)
|
||||
|
||||
---
|
||||
|
||||
## Offer Architecture
|
||||
|
||||
Organizza offerte in:
|
||||
|
||||
| Tipo | Descrizione |
|
||||
|------|-----------|
|
||||
| **Entry offer** | Punto di ingresso, basso impegno |
|
||||
| **Core offer** | Offerta principale |
|
||||
| **Premium offer** | High-ticket, completo |
|
||||
|
||||
**Ogni offerta include:**
|
||||
- Outcome
|
||||
- Process
|
||||
- Proof
|
||||
- CTA
|
||||
|
||||
---
|
||||
|
||||
## Content Pillars
|
||||
|
||||
Definire 4-6 topic che il brand comunica consistentemente.
|
||||
|
||||
**Esempio:**
|
||||
- Education
|
||||
- Insights
|
||||
- Case studies
|
||||
- Behind the scenes
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
60
references/trust_signal_patterns.md
Normal file
60
references/trust_signal_patterns.md
Normal file
|
|
@ -0,0 +1,60 @@
|
|||
# Trust Signal Patterns
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-ux-copy, agency-strategy_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern per costruire fiducia con prova, chiarezza e coerenza.
|
||||
|
||||
---
|
||||
|
||||
## Tipi di Trust Signals
|
||||
|
||||
### 1) Social Proof
|
||||
- Loghi clienti
|
||||
- Testimonial
|
||||
- Recensioni
|
||||
|
||||
### 2) Proof of Work
|
||||
- Case studies
|
||||
- Portfolio
|
||||
- Process artifacts (wireframe, strategy doc)
|
||||
|
||||
### 3) Authority
|
||||
- Awards
|
||||
- Talk / podcast
|
||||
- Partnerships
|
||||
- Certifications
|
||||
|
||||
### 4) Transparency
|
||||
- Process
|
||||
- Timeline
|
||||
- Pricing posture (anche "starting from")
|
||||
- What's included / excluded
|
||||
|
||||
---
|
||||
|
||||
## Placement
|
||||
|
||||
- Vicino a CTA (subito sopra o sotto)
|
||||
- Dopo services overview
|
||||
- Nelle pagine service
|
||||
|
||||
---
|
||||
|
||||
## Trust Copy Patterns
|
||||
|
||||
- "Abbiamo aiutato [audience] a ottenere [outcome] con [approach]."
|
||||
- "Approccio: [3 step] — Risultati: [metric]."
|
||||
|
||||
---
|
||||
|
||||
## Anti-pattern
|
||||
|
||||
- Claim generici senza prova ("best agency", "top quality")
|
||||
- Numeri senza contesto
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
52
references/weekly_report_template.md
Normal file
52
references/weekly_report_template.md
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
# Weekly Report Template
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-analytics_
|
||||
|
||||
## Sommario
|
||||
|
||||
Template per report settimanali KPI.
|
||||
|
||||
---
|
||||
|
||||
## Template
|
||||
|
||||
```markdown
|
||||
# Weekly Report - Week {WW}
|
||||
|
||||
## KPI Snapshot
|
||||
|
||||
{Inserire metriche chiave}
|
||||
|
||||
## Highlights
|
||||
|
||||
{Cosa ha funzionato}
|
||||
|
||||
## Lowlights
|
||||
|
||||
{Cosa non ha funzionato}
|
||||
|
||||
## Top Content
|
||||
|
||||
{Contenuti migliori}
|
||||
|
||||
## Actions Next Week (max 5)
|
||||
|
||||
1. {Action 1}
|
||||
2. {Action 2}
|
||||
3. {Action 3}
|
||||
4. {Action 4}
|
||||
5. {Action 5}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Regole
|
||||
|
||||
- Max 5 actions per settimana
|
||||
- KPI snapshot deve essere conciso
|
||||
- Focus su insight concreti, non narrative lunghe
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
32
references/youtube_script_framework.md
Normal file
32
references/youtube_script_framework.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# YouTube Script Framework
|
||||
|
||||
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||
_Usato da: agency-youtube_
|
||||
|
||||
## Sommario
|
||||
|
||||
Pattern per script YouTube retention-first.
|
||||
|
||||
---
|
||||
|
||||
## Struttura Script
|
||||
|
||||
| Tempo | Sezione | Descrizione |
|
||||
|-------|---------|-------------|
|
||||
| 0-10s | Hook | Promise + curiosity |
|
||||
| 10-25s | Credibility | Why you should listen |
|
||||
| 25-60s | Problem | Define the problem (relatable) |
|
||||
| Main | 3-5 Chapters | Con open loops |
|
||||
| End | Summary + CTA | Recap e call to action |
|
||||
|
||||
---
|
||||
|
||||
## Regole
|
||||
|
||||
- Open a loop ogni 60-90s
|
||||
- Usare esempi, non teoria
|
||||
- Hook deve essere <10s
|
||||
|
||||
---
|
||||
|
||||
_Reference generato da framework-translator_
|
||||
Loading…
Add table
Add a link
Reference in a new issue