---
name: agency-ux-copy
description: "Progettare sitemap e scrivere copy per pagine web conversion-oriented. Usare quando: (1) nuovo sito web, (2) rewrite copy esistente, (3) ottimizzare conversioni. Output: Sitemap, page structures, copy V1, SEO notes."
---

# Agency UX Copy Architect — Sitemap e Copy

Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.

## Quando Usare

- **Nuovo sito:** Creare sitemap e copy da zero
- **Website refresh:** Riscrivere copy esistente
- **Landing page:** Pagina campaign specifica
- **Conversion optimization:** Migliorare CTA e flow

---

## Input

| Input | Tipo | Validazione |
|-------|------|-------------|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
| `strategy_docs` | array | Positioning, messaging, content pillars |
| `design_layouts` | array | Page layouts (da design system) |
| `seo_keywords` | array | Keyword seed (se disponibili) |
| `page_list` | array | Pagine richieste (opzionale) |

---

## Processo

### Fase 1: Sitemap

**Obiettivo:** Definire architettura informazione.

**Azioni:**

1. Identifica pagine necessarie:
   - Obbligatorie: Home, About, Services, Contact
   - Opzionali: Case Studies, Blog, Resources

2. Per ogni pagina, definisci:
   - Nome
   - Scopo/Intent
   - CTA primaria
   - Note SEO

**Template:**

```markdown
# Sitemap

## Homepage
- **Intent:** Presentare value prop e guidare a CTA
- **CTA:** "Prenota call"
- **SEO:** Keyword primaria + secondary

## Services
- **Intent:** Descrivere offerte
- **CTA:** "Richiedi preventivo"
- **SEO:** "servizi {settore}"

## About
- **Intent:** Costruire trust
- **CTA:** "Conosci il team"
- **SEO:** "chi siamo {settore}"

## Contact
- **Intent:** Facilitare contatto
- **CTA:** "Invia messaggio"
- **SEO:** "contatti {settore}"
```

**Output:**
- `{project}/website/sitemap.md`

---

### Fase 2: Page Skeletons

**Obiettivo:** Creare struttura per ogni pagina.

**Azioni:**

1. Per ogni pagina in sitemap, definisci:
   - H1 (headline principale)
   - H2/H3 (sezioni)
   - Hero section (headline, sub, CTA)
   - Content sections (ordine logico)
   - CTA sections (mid-page, footer)
   - FAQ (se applicabile)

2. Usa pattern da agency-shared-references/references:
   - `hero_sections.md` per hero
   - `conversion_patterns.md` per CTA
   - `design_patterns.md` per layout

**Template:**

```markdown
# Homepage

## Hero
- H1: {Headline}
- Sub: {Supporting copy}
- CTA: {Testo CTA}
- Proof: {Proof chips}

## Section 1: Services Overview
- H2: {Titolo}
- Content: {Card grid con 3-6 servizi}

## Section 2: Proof
- H2: {Titolo}
- Content: {Logo wall o testimonial}

## Section 3: CTA Finale
- H2: {Titolo}
- CTA: {Testo CTA}
```

**Output:**
- `{project}/website/pages/{page_name}.md`

---

### Fase 3: Copywriting

**Obiettivo:** Scrivere copy per ogni sezione.

**Azioni:**

1. **Hero copy:**
   - Headline: 6-12 parole, outcome-focused
   - Sub: 1-2 frasi, meccanismo + proof
   - CTA: Verbo chiaro ("Prenota", "Richiedi")

2. **Section copy:**
   - Intro: 1-2 frasi
   - Bullets: 3-5 punti chiave
   - Microcopy: Label, button text

3. **Usa framework da `../agency-shared-references/references/copy_frameworks.md`:**
   - PAS (Problem-Agitate-Solve)
   - AIDA (Attention-Interest-Desire-Action)
   - Before-After-Bridge

4. **Applica `../agency-shared-references/references/conversion_patterns.md`:**
   - 1 CTA primaria per pagina
   - Ripeti CTA 2-3 volte
   - Friction reducers vicino a form

**Regole copy:**
- Parole semplici, niente gergo
- Frasi corte
- Focus su benefici, non features
- Proof ovunque possibile

**Output:**
- Copy completo in `{project}/website/pages/*.md`

---

### Fase 4: SEO Metadata

**Obiettivo:** Ottimizzare on-page SEO.

**Azioni:**

1. Per ogni pagina, compila:
   - Title tag (50-60 caratteri)
   - Meta description (150-160 caratteri)
   - H1 (unico per pagina)
   - Keyword primaria
   - Internal linking notes

**Template:**

```markdown
## SEO Metadata — Homepage

- **Title:** {Keyword primaria} | {Brand Name}
- **Meta description:** {Copy con keyword, 150-160 char}
- **H1:** {Headline hero}
- **Keyword primaria:** {keyword}
- **Internal links:** → Services, → Case Studies, → Contact
```

**Output:**
- `{project}/website/seo/meta.md`

---

### Fase 5: QA Copy

**Obiettivo:** Verificare qualità copy.

**Azioni:**

1. Leggi tutto il copy ad alta voce
2. Verifica:
   - Chiarezza (niente ambiguità)
   - Coerenza tono (brand voice)
   - CTA chiare e visibili
   - Proof presente
   - Niente gergo o fuffa

3. Compila QA checklist

**Output:**
- `{project}/website/qa/qa_website.md`

---

## Output

| File | Formato | Descrizione |
|------|---------|-------------|
| `{project}/website/sitemap.md` | Markdown | Architettura sito |
| `{project}/website/pages/*.md` | Markdown | Copy pagine |
| `{project}/website/seo/meta.md` | Markdown | SEO metadata |
| `{project}/website/qa/qa_website.md` | Markdown | QA checklist |

---

## References

### UX/Design Patterns (Shared)
- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) — Framework copy
- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) — CTA e conversioni
- [hero_sections.md](../agency-shared-references/references/hero_sections.md) — Hero patterns
- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — IA patterns
- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
- [design_patterns.md](../agency-shared-references/references/design_patterns.md) — UI patterns (card grid, split layout, testimonial, FAQ)

### Handoff a Developer
**Dopo aver completato copy, passare a:**
- **agency-web-developer** — Implementa HTML/CSS/JS dal copy
- [html_semantics.md](../agency-shared-references/references/html_semantics.md) — Come il copy diventa struttura HTML
- [css_layout.md](../agency-shared-references/references/css_layout.md) — Come i layout diventano CSS

**Nota:** Questa skill produce sitemap + copy. Per implementazione codice, usare agency-web-developer.

---

## Note

**Edge Cases:**

- **Nessuna keyword SEO:** Crea seed list ragionata basata su offering
- **Cliente non fornisce info:** Usa assunzioni documentate in decision log
- **Copy esistente da rewrite:** Mantieni struttura, migliora chiarezza e CTA

**Limitazioni:**

- Copywriting efficace richiede comprensione profonda del cliente
- SEO avanzata richiede keyword research dedicata
- Test A/B richiede implementazione tecnica

---

_Skill generata da framework-translator_