- Sostituite 135 occorrenze di clients/{client}/ con {project}/
- Aggiornati parametri: client_path → project_path in 11 skills
- README.md aggiornato con nuova convenzione {project}/
- Struttura cartelle ora agnostica: compatibile con clients/, projects/, o qualsiasi cartella
- Maggiore flessibilità per diversi sistemi e workflow
Vantaggi:
✅ Compatibile con qualsiasi struttura cartelle
✅ Non impone convenzione 'clients/'
✅ Utile per progetti interni, campagne, o clienti
✅ Più generale e riutilizzabile
5.2 KiB
5.2 KiB
| name | description |
|---|---|
| agency-research | 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 |
|---|---|---|
project_path |
string | Percorso progetto (cartella di lavoro) |
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:
- Per ogni competitor, compila teardown usando template:
## 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}
- Logga fonti in
sources_log.mdcon IDSRC-###
Output:
{project}/research/competitor_teardowns.md
Fase 2: Opportunity Map
Obiettivo: Sintetizzare insight in opportunità prioritarie.
Azioni:
- Analizza teardown e identifica pattern
- Categorizza opportunità:
- Copy: Cosa adottare
- Avoid: Cosa evitare
- Opportunity: Gap nel mercato
- Prioritizza P0/P1/P2
Template:
# 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:
{project}/research/opportunity_map.md
Fase 3: Reference Research
Obiettivo: Raccogliere 10-15 referenze di qualità.
Azioni:
-
Cerca referenze outside-industry per:
- Hero sections
- Layout structures
- Navigation patterns
- Case study formats
- Animation/motion
-
Per ogni reference, compila:
## Reference: {Nome/Sito}
**URL:** {link}
**Why it works:**
{Spiegazione}
**What to borrow:**
{Elementi applicabili}
**Possible risks:**
{Avvertenze}
- Logga fonti con ID
SRC-###
Output:
{project}/research/reference_library.md
Fase 4: Pattern Catalog
Obiettivo: Catalogare pattern riutilizzabili.
Azioni:
- Estrai pattern dalle referenze
- Organizza per categoria:
- Hero patterns
- Layout patterns
- Navigation patterns
- Content patterns
- Per ogni pattern, includi:
- Nome
- Descrizione
- Quando usarlo
- Esempio (screenshot o link)
Output:
{project}/research/pattern_catalog.md
Fase 5: Sources Log
Obiettivo: Tracciare tutte le fonti usate.
Azioni:
- Per ogni fonte esterna, registra:
- ID
SRC-### - Data accesso
- Titolo
- Autore/Publisher
- URL
- Affidabilità (1-5) + motivazione
- Note/estratti
- ID
Template:
## SRC-001
- **Data:** 2026-03-09
- **Titolo:** {Titolo pagina}
- **Autore:** {Autore}
- **URL:** {link}
- **Affidabilità:** 4/5 — {Motivo}
- **Note:** {Estratti o osservazioni}
Output:
{project}/research/sources_log.md
Output
| File | Formato | Descrizione |
|---|---|---|
{project}/research/competitor_teardowns.md |
Markdown | Teardown 3+ competitor |
{project}/research/opportunity_map.md |
Markdown | Insight prioritizzati |
{project}/research/reference_library.md |
Markdown | 10-15 referenze |
{project}/research/pattern_catalog.md |
Markdown | Pattern catalog |
{project}/research/sources_log.md |
Markdown | Log fonti |
References
- research_playbook.md — Metodo research
- research_citation_rules.md — Regole citazione
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