5ef7b67e40
- Eliminata cartella agency-publisher/ - Aggiornato README: 14 skills (da 15), workflow publish manuale - Aggiornato agency-orchestrator: publish gate gestiti manualmente - Rimosso riferimenti da qa_visual.md e resource_types.md - Aggiunto report analisi in PUBLISHER_REMOVAL_REPORT.md Publish ora gestito manualmente con: - APPROVED: YES nel frontmatter - PUBLISH_APPROVED.md - publish_log.md per tracciabilità
6.6 KiB
| name | description |
|---|---|
| agency-shared-references | 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/<file>.md)
Agency Shared References v2.0 — No Symlink, Direct Paths