137 lines
6.6 KiB
Markdown
137 lines
6.6 KiB
Markdown
---
|
|
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 di qualità minimo accettabile
|
|
_Cosa contiene:_ 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/<file>.md`)
|
|
|
|
---
|
|
|
|
_Agency Shared References v2.0 — No Symlink, Direct Paths_
|