--- name: agency-shared-references description: "References condivise per la suite agency-skills. Contiene 24 documenti con pattern UX/UI, framework copywriting, standard qualità, playbook strategici, specifiche tecniche e template. Usare quando: (1) serve consultare pattern UX/UI, (2) applicare framework copywriting, (3) seguire standard qualità, (4) citare fonti correttamente, (5) gestire risorse catalogate, (6) implementare siti web statici." --- # Agency Shared References Repository centralizzato di 22 documenti di riferimento per le 14 skills della suite agency-skills. ## Indice delle Referenze ### 🎨 Design & UX Patterns (7 documenti) **design_patterns.md** — Pattern UI riusabili per siti agency/services _Cosa contiene:_ Card grid, split layout, section header, logo wall, testimonial block, FAQ, footer actionable _Quando usarlo:_ Per strutturare sezioni di pagine web con pattern collaudati **hero_sections.md** — Formula e checklist per hero section efficaci _Cosa contiene:_ Hero checklist (5 secondi), formula H1, 6 layout tipi (value prop, problem-agitate, social proof, portfolio, CTA-only, video) _Quando usarlo:_ Per progettare la sezione above-the-fold di homepage e landing page **layout_systems.md** — Grid, spacing e ritmo verticale _Cosa contiene:_ Grid 12 colonne, scala spaziatura modulare (4/8/16/24/32/48/64), vertical rhythm, density levels _Quando usarlo:_ Per creare design system coerenti e mantenere consistenza tra pagine **navigation_patterns.md** — Information architecture e navigazione _Cosa contiene:_ Primary nav structure, mobile nav patterns, footer navigation, breadcrumbs, IA per agency sites _Quando usarlo:_ Per definire struttura di navigazione e menu di siti web **conversion_patterns.md** — CTA, forms e riduzione attrito _Cosa contiene:_ CTA hierarchy, form design best practices, friction reducers, urgency/scarcity ethics _Quando usarlo:_ Per ottimizzare pagine per conversioni (contact, signup, download) **trust_signal_patterns.md** — Pattern per costruire fiducia _Cosa contiene:_ Social proof (loghi, testimonial), numeri/risultati, authority badge, transparency signals _Quando usarlo:_ Per aumentare credibilità e ridurre rischio percepito **qa_visual.md** — Checklist QA per asset visuali _Cosa contiene:_ Readability check, contrast check, mobile preview, brand consistency, platform specs _Quando usarlo:_ Prima di pubblicare card, carousel, thumbnail o altri asset visuali --- ### ✍️ Copy & Content (6 documenti) **copy_frameworks.md** — Framework copywriting clarity-first _Cosa contiene:_ Regole generali, AIDA, PAS, FAB, 4U, Before-After-Bridge, job-to-be-done _Quando usarlo:_ Per scrivere copy di homepage, landing page, ads, email **brand_voice.md** — Linee guida tono di voce _Cosa contiene:_ Attributi tono (3-5), dimensioni voce, esempi pratici, do's/don'ts per web e social _Quando usarlo:_ Per mantenere coerenza di tono across tutti i content **content_formats.md** — Formati content per social e YouTube _Cosa contiene:_ Content pillars → formats mapping, LinkedIn posts, Instagram carousel, YouTube video structures _Quando usarlo:_ Per pianificare e produrre content per social media **case_study_structures.md** — Template per case study _Cosa contiene:_ Snapshot, challenge, solution, results, testimonial structure _Quando usarlo:_ Per documentare progetti e dimostrare competenza **audience_personas.md** — Template per ICP e personas _Cosa contiene:_ Persona fields (demografici, psicografici, bisogni, obiezioni), ICP definition _Quando usarlo:_ Per definire target audience e allineare strategia **youtube_script_framework.md** — Script structure retention-first _Cosa contiene:_ Timeline script (hook, intro, content, CTA), retention tactics, pattern interrupts _Quando usarlo:_ Per scrivere script YouTube che mantengono engagement --- ### 📊 Strategy & Research (3 documenti) **strategy_playbook.md** — Framework positioning e messaging _Cosa contiene:_ Positioning statement, messaging hierarchy, content pillars definition _Quando usarlo:_ Per definire strategia di posizionamento e messaggi chiave **research_playbook.md** — Metodo research competitor _Cosa contiene:_ Competitor analysis framework, teardown template, synthesis patterns _Quando usarlo:_ Per analizzare competitor e raccogliere reference di settore **research_citation_rules.md** — Regole citazione fonti _Cosa contiene:_ Obbligo logging, formato citazione, sources log template _Quando usarlo:_ Ogni volta che si usano fonti esterne in research o content --- ### ✅ Quality & Publishing (3 documenti) **quality_bar.md** — Standard minimo accettabile V1 _Cosa contiene:_ V1 principles, complete > perfect, tracciabilità decision log _Quando usarlo:_ Per definire criterio di "done" per deliverable **weekly_report_template.md** — Template report KPI settimanali _Cosa contiene:_ Report structure, KPI sections, highlights/lowlights, actions next week _Quando usarlo:_ Per reportistica settimanale analytics **platform_patterns.md** — Pattern specifici per piattaforma social _Cosa contiene:_ LinkedIn, Instagram, YouTube patterns (hook, format, best practices) _Quando usarlo:_ Per ottimizzare content per piattaforma specifica --- ### 💻 Technical — Web Development (3 documenti) **html_semantics.md** — Semantic HTML best practices _Cosa contiene:_ Document structure, semantic tags, accessibility (ARIA), SEO on-page _Quando usarlo:_ Per scrivere HTML accessibile e SEO-friendly **css_layout.md** — Bootstrap e CSS custom _Cosa contiene:_ Bootstrap vs custom decision, responsive breakpoints, grid implementation _Quando usarlo:_ Per stilizzare siti web responsive **js_interactivity.md** — jQuery + GSAP patterns _Cosa contiene:_ Setup librerie, DOM manipulation, animations, scroll effects, performance _Quando usarlo:_ Per aggiungere interattività e animazioni a siti web --- ### 📦 Resources & Assets (1 documento) **resource_types.md** — Classificazione risorse e use case _Cosa contiene:_ Immagini (logo, prodotto, team), video, documenti — formati, risoluzioni, use case per skill _Quando usarlo:_ Per catalogare asset e capire quali risorse servono per ogni task --- ## 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 - **Percorsi:** Tutte le skills puntano a questi file con percorsi diretti (`../agency-shared-references/references/.md`) --- _Agency Shared References v2.0 — No Symlink, Direct Paths_