agency-skills-suite/agency-research/SKILL.md

---
name: agency-research
description: Eseguire research competitivo e reference per identificare opportunità e pattern. Usare quando: (1) nuovo cliente (competitor analysis), (2) bisogno di referenze visive, (3) identificare best practice di settore. Output: Competitor teardowns, opportunity map, reference library, pattern catalog, sources log.
---

# Agency Research — Competitive Intelligence e Reference

Analisi sistematica competitor e raccolta referenze con insight applicabili.

## Quando Usare

- **Nuovo cliente:** Comprendere landscape competitivo
- **Design sprint:** Trovare referenze visive
- **Strategy refresh:** Identificare opportunità
- **Content planning:** Studiare format vincenti

---

## Input

| Input | Tipo | Validazione |
|-------|------|-------------|
| `client_path` | string | Percorso client |
| `competitors` | array | Lista competitor (min 3) |
| `research_type` | string | "competitor" / "reference" / "both" |
| `focus_areas` | array | Aree di focus (es. positioning, visual, UX) |

---

## Processo

### Fase 1: Competitor Research

**Obiettivo:** Analizzare 3+ competitor sistematicamente.

**Azioni:**

1. Per ogni competitor, compila teardown usando template:

```markdown
## Competitor: {Nome}

### Positioning
- Audience:
- Promise:
- Differentiator:

### Messaging
- Headline hero:
- Supporting messages:
- Tone of voice:

### Offer Structure
- Entry offer:
- Core offer:
- Premium offer:

### Conversion Mechanics
- CTA primarie:
- Lead magnet:
- Friction reducers:

### Trust Signals
- Social proof:
- Proof of work:
- Authority:

### UX Structure
- Navigation:
- Page flow:
- Notable patterns:

### Visual Language
- Style:
- Colori:
- Typography:

### Copy (da prendere)
- {Elementi efficaci}

### Avoid
- {Errori o debolezze}

### Opportunity
- {Opportunità per cliente}
```

2. Logga fonti in `sources_log.md` con ID `SRC-###`

**Output:**
- `clients/{client}/research/competitor_teardowns.md`

---

### Fase 2: Opportunity Map

**Obiettivo:** Sintetizzare insight in opportunità prioritarie.

**Azioni:**

1. Analizza teardown e identifica pattern
2. Categorizza opportunità:
   - **Copy:** Cosa adottare
   - **Avoid:** Cosa evitare
   - **Opportunity:** Gap nel mercato
3. Prioritizza P0/P1/P2

**Template:**

```markdown
# Opportunity Map

## Copy (da prendere)
- P0: {Insight ad alto impatto}
- P1: {Insight utile}
- P2: {Nice to have}

## Avoid
- {Errori competitor da non ripetere}

## Opportunity
- {Gap o opportunità non sfruttate}
```

**Output:**
- `clients/{client}/research/opportunity_map.md`

---

### Fase 3: Reference Research

**Obiettivo:** Raccogliere 10-15 referenze di qualità.

**Azioni:**

1. Cerca referenze outside-industry per:
   - Hero sections
   - Layout structures
   - Navigation patterns
   - Case study formats
   - Animation/motion

2. Per ogni reference, compila:

```markdown
## Reference: {Nome/Sito}

**URL:** {link}

**Why it works:**
{Spiegazione}

**What to borrow:**
{Elementi applicabili}

**Possible risks:**
{Avvertenze}
```

3. Logga fonti con ID `SRC-###`

**Output:**
- `clients/{client}/research/reference_library.md`

---

### Fase 4: Pattern Catalog

**Obiettivo:** Catalogare pattern riutilizzabili.

**Azioni:**

1. Estrai pattern dalle referenze
2. Organizza per categoria:
   - Hero patterns
   - Layout patterns
   - Navigation patterns
   - Content patterns
3. Per ogni pattern, includi:
   - Nome
   - Descrizione
   - Quando usarlo
   - Esempio (screenshot o link)

**Output:**
- `clients/{client}/research/pattern_catalog.md`

---

### Fase 5: Sources Log

**Obiettivo:** Tracciare tutte le fonti usate.

**Azioni:**

1. Per ogni fonte esterna, registra:
   - ID `SRC-###`
   - Data accesso
   - Titolo
   - Autore/Publisher
   - URL
   - Affidabilità (1-5) + motivazione
   - Note/estratti

**Template:**
```markdown
## SRC-001

- **Data:** 2026-03-09
- **Titolo:** {Titolo pagina}
- **Autore:** {Autore}
- **URL:** {link}
- **Affidabilità:** 4/5 — {Motivo}
- **Note:** {Estratti o osservazioni}
```

**Output:**
- `clients/{client}/research/sources_log.md`

---

## Output

| File | Formato | Descrizione |
|------|---------|-------------|
| `clients/{client}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor |
| `clients/{client}/research/opportunity_map.md` | Markdown | Insight prioritizzati |
| `clients/{client}/research/reference_library.md` | Markdown | 10-15 referenze |
| `clients/{client}/research/pattern_catalog.md` | Markdown | Pattern catalog |
| `clients/{client}/research/sources_log.md` | Markdown | Log fonti |

---

## References

- [research_playbook.md](../../references/research_playbook.md) — Metodo research
- [research_citation_rules.md](../../references/research_citation_rules.md) — Regole citazione
- [competitor_teardown.md](../../templates/competitor_teardown.md) — Template teardown
- [reference_entry.md](../../templates/reference_entry.md) — Template reference

---

## Note

**Edge Cases:**

- **Competitor sconosciuti:** Chiedi al cliente o cerca per keyword di settore
- **Nessuna fonte disponibile:** Usa knowledge generale e segnala limitazione
- **Web research necessaria:** Usa solo domini whitelist (vedi policy)

**Limitazioni:**

- Web research richiede whitelist e logging obbligatorio
- Referenze visive possono richiedere screenshot (tool esterno)
- Analisi approfondita richiede tempo (min 2-3h per 3 competitor)

---

_Skill generata da framework-translator_