Initial release: agency_v3_1-skills-suite v1.0
- 12 AgentSkills generate da agency_v3_1 framework - 17 references centralizzate - Script INSTALL.sh per installazione automatica - README.md con documentazione completa Skills incluse: - agency-orchestrator (coordinamento + QA) - agency-strategy (positioning, messaging) - agency-research (competitive intelligence) - agency-creative-director (direzione visiva) - agency-design-system (tokens, components) - agency-ux-copy (sitemap, copy) - agency-seo (SEO tecnico) - agency-social (social strategy) - agency-youtube (YouTube strategy) - agency-visual-generator (asset visuali) - agency-analytics (report KPI) - agency-publisher (publish gate-based) Generated by framework-translator v2.0 Approved by: MarcoB (2026-03-09)
This commit is contained in:
AgentePotente
commit
6ac766172c
47 changed files with 4165 additions and 0 deletions
16
.gitignore
vendored
Normal file
16
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,16 @@
|
||||||
|
# Logs
|
||||||
|
*.log
|
||||||
|
|
||||||
|
# OS
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
|
||||||
|
# Editor
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
|
||||||
|
# Node (se presente)
|
||||||
|
node_modules/
|
||||||
|
package-lock.json
|
||||||
45
INSTALL.sh
Executable file
45
INSTALL.sh
Executable file
|
|
@ -0,0 +1,45 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# Installazione agency_v3_1-skills
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
SOURCE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
TARGET="$HOME/.openclaw/skills/agency_v3_1-skills"
|
||||||
|
|
||||||
|
echo "🚀 Installing agency_v3_1-skills..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Rimuovi installazione precedente se esiste
|
||||||
|
if [ -d "$TARGET" ]; then
|
||||||
|
echo "⚠️ Rimozione installazione precedente..."
|
||||||
|
rm -rf "$TARGET"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Crea directory target
|
||||||
|
mkdir -p "$(dirname "$TARGET")"
|
||||||
|
|
||||||
|
# Copia skills
|
||||||
|
echo "📦 Copia skills in $TARGET..."
|
||||||
|
cp -r "$SOURCE" "$TARGET"
|
||||||
|
|
||||||
|
# Verifica symlink
|
||||||
|
echo "🔗 Verifica symlink..."
|
||||||
|
for skill_dir in "$TARGET"/*/; do
|
||||||
|
if [ -d "$skill_dir" ] && [ "$skill_dir" != "$TARGET/references/" ]; then
|
||||||
|
if [ ! -L "$skill_dir/references" ]; then
|
||||||
|
echo " Fix symlink: $skill_dir"
|
||||||
|
rm -rf "$skill_dir/references"
|
||||||
|
ln -s ../references "$skill_dir/references"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "✅ Installation complete!"
|
||||||
|
echo ""
|
||||||
|
echo "Skills installate in: $TARGET"
|
||||||
|
echo ""
|
||||||
|
echo "Skills disponibili:"
|
||||||
|
ls -1 "$TARGET" | grep -v references | sed 's/^/ - /'
|
||||||
|
echo ""
|
||||||
|
echo "Per usare una skill, riferisciti a lei come 'agency_v3_1-skills/<nome-skill>'"
|
||||||
151
README.md
Normal file
151
README.md
Normal file
|
|
@ -0,0 +1,151 @@
|
||||||
|
# agency_v3_1-skills
|
||||||
|
|
||||||
|
Suite di AgentSkills per Agency AI OS v3.1 — trasformate da framework multi-agente a skills AgentSkills-compatibili.
|
||||||
|
|
||||||
|
## Panoramica
|
||||||
|
|
||||||
|
- **Skills:** 12
|
||||||
|
- **References:** 17
|
||||||
|
- **Lingua:** English (con note in italiano)
|
||||||
|
- **Dominio:** Digital Agency / Content Production / Multi-Agent System
|
||||||
|
|
||||||
|
## Installazione
|
||||||
|
|
||||||
|
### Metodo 1: Script Automatico
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /home/noe/.openclaw/workspace/agency_v3_1/test/agency_v3_1_v1/agency_v3_1-skills-suite
|
||||||
|
./INSTALL.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Metodo 2: Copia Manuale
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp -r /home/noe/.openclaw/workspace/agency_v3_1/test/agency_v3_1_v1/agency_v3_1-skills-suite ~/.openclaw/skills/agency_v3_1-skills
|
||||||
|
```
|
||||||
|
|
||||||
|
### Metodo 3: ClawHub (se pubblicato)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
clawhub install agency_v3_1-skills
|
||||||
|
```
|
||||||
|
|
||||||
|
## Skills Incluse
|
||||||
|
|
||||||
|
| # | Skill | Descrizione | Complessità |
|
||||||
|
|---|-------|-------------|-------------|
|
||||||
|
| 1 | **agency-orchestrator** | Coordinamento agenti, backlog, QA | Alta |
|
||||||
|
| 2 | **agency-strategy** | Positioning, messaging, content pillars | Media |
|
||||||
|
| 3 | **agency-research** | Competitive intelligence, reference library | Media |
|
||||||
|
| 4 | **agency-creative-director** | Direzione visiva, moodboard | Media |
|
||||||
|
| 5 | **agency-design-system** | Design tokens, components, layouts | Media |
|
||||||
|
| 6 | **agency-ux-copy** | Sitemap, page copy, conversion | Media |
|
||||||
|
| 7 | **agency-seo** | SEO tecnico, metadata, schema | Bassa |
|
||||||
|
| 8 | **agency-social** | Social strategy, calendario, post queue | Media |
|
||||||
|
| 9 | **agency-youtube** | YouTube strategy, script retention-first | Media |
|
||||||
|
| 10 | **agency-visual-generator** | Asset visuali (card, carousel, thumbnail) | Media |
|
||||||
|
| 11 | **agency-analytics** | Report KPI settimanali, actions | Bassa |
|
||||||
|
| 12 | **agency-publisher** | Publish gate-based (social/YouTube) | Bassa |
|
||||||
|
|
||||||
|
## References Incluse
|
||||||
|
|
||||||
|
1. `design_patterns.md` — Pattern UI riusabili
|
||||||
|
2. `hero_sections.md` — Layout hero efficaci
|
||||||
|
3. `layout_systems.md` — Grid, spacing, density
|
||||||
|
4. `navigation_patterns.md` — IA e navigazione
|
||||||
|
5. `conversion_patterns.md` — CTA e conversioni
|
||||||
|
6. `trust_signal_patterns.md` — Proof e credibilità
|
||||||
|
7. `case_study_structures.md` — Template case study
|
||||||
|
8. `copy_frameworks.md` — Framework copywriting
|
||||||
|
9. `content_formats.md` — Formati social/YouTube
|
||||||
|
10. `brand_voice.md` — Tone of voice
|
||||||
|
11. `audience_personas.md` — Template personas
|
||||||
|
12. `platform_patterns.md` — Pattern per piattaforma
|
||||||
|
13. `quality_bar.md` — Standard qualità V1
|
||||||
|
14. `publishing_gates.md` — Gate pre-publish
|
||||||
|
15. `research_citation_rules.md` — Regole citazione fonti
|
||||||
|
16. `strategy_playbook.md` — Framework positioning
|
||||||
|
17. `research_playbook.md` — Metodo research
|
||||||
|
18. `youtube_script_framework.md` — Struttura script
|
||||||
|
19. `qa_visual.md` — QA checklist visual
|
||||||
|
20. `weekly_report_template.md` — Template report
|
||||||
|
|
||||||
|
## Workflow Consigliato
|
||||||
|
|
||||||
|
1. **Onboarding:** `agency-orchestrator` → definisci MVP
|
||||||
|
2. **Research:** `agency-research` → competitor + reference
|
||||||
|
3. **Strategy:** `agency-strategy` → positioning, messaging
|
||||||
|
4. **Creative:** `agency-creative-director` → direzione visiva
|
||||||
|
5. **Design:** `agency-design-system` → design system
|
||||||
|
6. **Website:** `agency-ux-copy` + `agency-seo` → sitemap, copy, SEO
|
||||||
|
7. **Content:** `agency-social` + `agency-youtube` → calendar, script
|
||||||
|
8. **Visual:** `agency-visual-generator` → asset
|
||||||
|
9. **Publish:** `agency-publisher` → publish (post-approvazione)
|
||||||
|
10. **Analytics:** `agency-analytics` → report settimanali
|
||||||
|
|
||||||
|
## Struttura
|
||||||
|
|
||||||
|
```
|
||||||
|
agency_v3_1-skills/
|
||||||
|
├── README.md
|
||||||
|
├── INSTALL.sh
|
||||||
|
├── agency-orchestrator/
|
||||||
|
│ ├── SKILL.md
|
||||||
|
│ └── references → ../references
|
||||||
|
├── agency-strategy/
|
||||||
|
│ ├── SKILL.md
|
||||||
|
│ └── references → ../references
|
||||||
|
├── ... (altre 10 skills)
|
||||||
|
└── references/
|
||||||
|
├── design_patterns.md
|
||||||
|
├── hero_sections.md
|
||||||
|
└── ... (17 references)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Uso
|
||||||
|
|
||||||
|
Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
|
||||||
|
|
||||||
|
**Esempio:**
|
||||||
|
|
||||||
|
```
|
||||||
|
/skill agency-orchestrator
|
||||||
|
```
|
||||||
|
|
||||||
|
La skill caricherà automaticamente le references necessarie dal percorso `../references`.
|
||||||
|
|
||||||
|
## Publishing Gates
|
||||||
|
|
||||||
|
⚠️ **Importante:** Le skills `agency-publisher` e tutte le skills che producono content pubblicabile seguono gate rigorosi:
|
||||||
|
|
||||||
|
- Mai publish senza `APPROVED: YES` nel frontmatter
|
||||||
|
- Mai publish senza `PUBLISH_APPROVED.md` = YES
|
||||||
|
- QA obbligatorio prima di publish
|
||||||
|
|
||||||
|
Vedi `references/publishing_gates.md` per dettagli.
|
||||||
|
|
||||||
|
## Auto-Learning
|
||||||
|
|
||||||
|
Questo framework supporta miglioramento continuo tramite:
|
||||||
|
|
||||||
|
- `agency-orchestrator` → propone improvements
|
||||||
|
- Workflow 90/92 (autolearn) → staging → proposal → eval → approved → merge
|
||||||
|
|
||||||
|
Vedi `core/learning/` e `core/policies/knowledge_promotion.md` nel framework originale.
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
- **Lingua:** Skills in inglese (framework originale), alcune references bilingue
|
||||||
|
- **Dominio:** Agency digitali, content production, multi-agente coordination
|
||||||
|
- **Complexity:** MEDIUM-HIGH (12 skills, 17 references, workflow coordinati)
|
||||||
|
|
||||||
|
## Supporto
|
||||||
|
|
||||||
|
Per issue o domande:
|
||||||
|
- Framework originale: vedi `agency_v3_1/README.md`
|
||||||
|
- Skill generation: vedi `framework-translator/SKILL.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Generato da framework-translator il 2026-03-09_
|
||||||
|
_Framework source: agency_v3_1 v3.1_
|
||||||
223
agency-analytics/SKILL.md
Normal file
223
agency-analytics/SKILL.md
Normal file
|
|
@ -0,0 +1,223 @@
|
||||||
|
---
|
||||||
|
name: agency-analytics
|
||||||
|
description: Generare report settimanali KPI e identificare azioni per social e YouTube. Usare quando: (1) report settimanale, (2) analisi performance content, (3) pianificare azioni basate su dati. Output: Weekly report con KPI snapshot, highlights, lowlights, max 5 actions.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Analyst/KPI — Report Settimanali
|
||||||
|
|
||||||
|
Report KPI settimanali e azioni misurabili per social e YouTube.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Weekly check:** Report prestazioni settimana
|
||||||
|
- **Post-campaign:** Analisi campagna specifica
|
||||||
|
- **Monthly review:** Sintesi mensile (aggrega weekly)
|
||||||
|
- **Strategy adjust:** Identificare cosa cambiare
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `kpi_definitions` | object | KPI da tracciare |
|
||||||
|
| `dashboards_links` | array | Link a analytics (se disponibili) |
|
||||||
|
| `week_number` | string | Numero settimana (es. "2026-W10") |
|
||||||
|
| `published_content` | array | Content pubblicato nella settimana |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Raccolta Dati
|
||||||
|
|
||||||
|
**Obiettivo:** Raccogliere KPI della settimana.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica fonti dati:
|
||||||
|
- **Social:** LinkedIn Analytics, Instagram Insights, X Analytics
|
||||||
|
- **YouTube:** YouTube Studio
|
||||||
|
- **Website:** Google Analytics (se applicabile)
|
||||||
|
|
||||||
|
2. Per ogni piattaforma, raccogli:
|
||||||
|
- Views / Impressions
|
||||||
|
- Engagement (likes, comments, shares)
|
||||||
|
- Clicks / CTR
|
||||||
|
- Follower/Subscribers growth
|
||||||
|
- Top content della settimana
|
||||||
|
|
||||||
|
3. Se dati NON disponibili:
|
||||||
|
- Documenta mancanza
|
||||||
|
- Proponi setup tracking
|
||||||
|
- Usa stime basate su published log
|
||||||
|
|
||||||
|
**Template Raccolta:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Dati Settimana {WW}
|
||||||
|
|
||||||
|
## LinkedIn
|
||||||
|
- Posts published: {N}
|
||||||
|
- Total impressions: {N}
|
||||||
|
- Total engagement: {N}
|
||||||
|
- Engagement rate: {N}%
|
||||||
|
- Top post: {titolo} ({impressions})
|
||||||
|
|
||||||
|
## Instagram
|
||||||
|
- Posts published: {N}
|
||||||
|
- Reach: {N}
|
||||||
|
- Engagement: {N}
|
||||||
|
- Saves: {N}
|
||||||
|
- Top post: {titolo}
|
||||||
|
|
||||||
|
## YouTube
|
||||||
|
- Videos published: {N}
|
||||||
|
- Views: {N}
|
||||||
|
- Watch time: {N} ore
|
||||||
|
- Avg retention: {N}%
|
||||||
|
- Top video: {titolo}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: KPI Snapshot
|
||||||
|
|
||||||
|
**Obiettivo:** Sintetizzare metriche chiave.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Crea snapshot conciso (max 10 metriche totali)
|
||||||
|
2. Includi:
|
||||||
|
- Metriche di volume (views, impressions)
|
||||||
|
- Metriche di engagement (rate, clicks)
|
||||||
|
- Growth (follower, subscribers)
|
||||||
|
3. Evidenzia trend (vs settimana precedente, se disponibile)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## KPI Snapshot — Week {WW}
|
||||||
|
|
||||||
|
| Metrica | Valore | vs Week Precedente |
|
||||||
|
|---------|--------|-------------------|
|
||||||
|
| Total Impressions | 12,450 | +15% |
|
||||||
|
| Engagement Rate | 4.2% | +0.3% |
|
||||||
|
| New Followers | +34 | +12% |
|
||||||
|
| YouTube Views | 2,340 | -5% |
|
||||||
|
| Avg Retention | 45% | stabile |
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Highlights e Lowlights
|
||||||
|
|
||||||
|
**Obiettivo:** Identificare cosa ha funzionato e cosa no.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. **Highlights (2-3):**
|
||||||
|
- Top content della settimana
|
||||||
|
- Record battuti
|
||||||
|
- Insight positivi
|
||||||
|
|
||||||
|
2. **Lowlights (1-2):**
|
||||||
|
- Content underperforming
|
||||||
|
- Metriche in calo
|
||||||
|
- Problemi identificati
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
1. **Post LinkedIn "3 errori comuni"** — 5,200 impressions, 8.4% engagement rate (2x media)
|
||||||
|
2. **YouTube video "Case Study X"** — 62% retention a 30s (record)
|
||||||
|
3. **+50 followers** — crescita più alta del mese
|
||||||
|
|
||||||
|
## Lowlights
|
||||||
|
|
||||||
|
1. **Instagram carousel** — 40% reach in meno vs media (algoritmo?)
|
||||||
|
2. **YouTube CTR thumbnail** — 3.2% (target: 5%+)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Actions Next Week
|
||||||
|
|
||||||
|
**Obiettivo:** Definire max 5 azioni concrete.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Basa azioni su highlights/lowlights
|
||||||
|
2. Prioritizza impatto alto / sforzo basso
|
||||||
|
3. Specifica:
|
||||||
|
- Cosa fare
|
||||||
|
- Perché (data-driven)
|
||||||
|
- Come misurare successo
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Actions Next Week (max 5)
|
||||||
|
|
||||||
|
1. **Raddoppiare su formato "errori comuni"** — Engagement 2x media, produrre variante per Instagram
|
||||||
|
2. **Test nuove thumbnail YouTube** — CTR basso, A/B test 2 varianti
|
||||||
|
3. **Analizzare calo reach Instagram** — Check algoritmo, valuta posting times alternativi
|
||||||
|
4. **Pianificare case study Q2** — Top performing format, iniziare produzione
|
||||||
|
5. **Setup UTM tracking** — Migliorare attribution clicks → website
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 5: Weekly Report
|
||||||
|
|
||||||
|
**Obiettivo:** Compilare report finale.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa template da `references/weekly_report_template.md`
|
||||||
|
2. Compila tutte le sezioni
|
||||||
|
3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md`
|
||||||
|
4. Aggiorna backlog se azioni richiedono task
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/analytics/weekly_reports/YYYY-WW.md`
|
||||||
|
- Update suggerito a `clients/{client}/ops/backlog.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale |
|
||||||
|
| `clients/{client}/ops/backlog.md` | Markdown | Update con actions (se necessario) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [weekly_report_template.md](../../references/weekly_report_template.md) — Template report
|
||||||
|
- [quality_bar.md](../../references/quality_bar.md) — Standard V1
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessun dato disponibile:** Documenta mancanza, proponi setup tracking, usa published log come proxy
|
||||||
|
- **Dati parziali:** Riporta cosa disponibile, segnala gap
|
||||||
|
- **Settimana corta (festività):** Nota contesto, non confrontare con settimane normali
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Richiede accesso a dashboard analytics (o export manuali)
|
||||||
|
- Alcuni dati potrebbero avere delay (24-48h)
|
||||||
|
- Attribution website → social richiede UTM setup
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-analytics/references
Symbolic link
1
agency-analytics/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
228
agency-creative-director/SKILL.md
Normal file
228
agency-creative-director/SKILL.md
Normal file
|
|
@ -0,0 +1,228 @@
|
||||||
|
---
|
||||||
|
name: agency-creative-director
|
||||||
|
description: Definire direzione visiva e creative concept per progetti. Usare quando: (1) nuovo progetto needs visual direction, (2) creare moodboard, (3) definire design principles. Output: Creative direction doc, moodboard, design principles.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Creative Director — Direzione Visiva
|
||||||
|
|
||||||
|
Definisce la direzione creativa e visiva che guida il design del progetto.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo progetto:** Stabilire visual language
|
||||||
|
- **Rebrand:** Aggiornare direzione visiva
|
||||||
|
- **Design sprint:** Allineare team su concept
|
||||||
|
- **Moodboard:** Raccolta ispirazione
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `strategy_docs` | array | Positioning, messaging (da strategy) |
|
||||||
|
| `reference_library` | array | Referenze visive (da research) |
|
||||||
|
| `brand_constraints` | object | Vincoli brand (colori, font, etc.) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Review Strategia e Referenze
|
||||||
|
|
||||||
|
**Obiettivo:** Comprendere contesto e ispirazione.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Leggi `clients/{client}/strategy/positioning.md`
|
||||||
|
2. Leggi `clients/{client}/strategy/messaging.md`
|
||||||
|
3. Studia `clients/{client}/research/reference_library.md`
|
||||||
|
4. Identifica:
|
||||||
|
- Attributi brand (da positioning)
|
||||||
|
- Visual patterns ricorrenti nelle referenze
|
||||||
|
- Vincoli esistenti (brand guidelines)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Definizione Visual Language
|
||||||
|
|
||||||
|
**Obiettivo:** Specificare elementi visivi chiave.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. **Typography style:**
|
||||||
|
- Serif / Sans-serif / Display
|
||||||
|
- Mood (formale, friendly, bold, minimal)
|
||||||
|
|
||||||
|
2. **Layout density:**
|
||||||
|
- Airy (premium, spacious)
|
||||||
|
- Balanced (standard)
|
||||||
|
- Dense (data-heavy)
|
||||||
|
|
||||||
|
3. **Color roles:**
|
||||||
|
- Primary color (brand)
|
||||||
|
- Secondary colors (accents)
|
||||||
|
- Neutral palette (text, backgrounds)
|
||||||
|
|
||||||
|
4. **Imagery style:**
|
||||||
|
- Photography (editorial, authentic, stock)
|
||||||
|
- Illustration (custom, icon-based)
|
||||||
|
- Abstract/3D
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- Note in `clients/{client}/design/visual_language_notes.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Creative Direction
|
||||||
|
|
||||||
|
**Obiettivo:** Documentare direzione creativa.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Scrivi documento con:
|
||||||
|
- Concept statement (1-2 frasi)
|
||||||
|
- Visual attributes (3-5 aggettivi)
|
||||||
|
- Do's e Don'ts
|
||||||
|
- Esempi di riferimento
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Creative Direction
|
||||||
|
|
||||||
|
## Concept
|
||||||
|
{Statement che descrive l'idea visiva}
|
||||||
|
|
||||||
|
## Visual Attributes
|
||||||
|
1. {Attributo 1} — {Descrizione}
|
||||||
|
2. {Attributo 2} — {Descrizione}
|
||||||
|
3. {Attributo 3} — {Descrizione}
|
||||||
|
|
||||||
|
## Typography
|
||||||
|
{Style e rationale}
|
||||||
|
|
||||||
|
## Layout
|
||||||
|
{Density e approccio}
|
||||||
|
|
||||||
|
## Color
|
||||||
|
{Ruoli e palette direction}
|
||||||
|
|
||||||
|
## Imagery
|
||||||
|
{Style di immagini/illustrazioni}
|
||||||
|
|
||||||
|
## Do's
|
||||||
|
- {Cosa fare}
|
||||||
|
- {Cosa fare}
|
||||||
|
|
||||||
|
## Don'ts
|
||||||
|
- {Cosa evitare}
|
||||||
|
- {Cosa evitare}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/creative_direction.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Moodboard
|
||||||
|
|
||||||
|
**Obiettivo:** Raccolta visiva di ispirazione.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Raccogli 10-20 immagini che rappresentano:
|
||||||
|
- Layout ideas
|
||||||
|
- Color palettes
|
||||||
|
- Typography combinations
|
||||||
|
- Imagery style
|
||||||
|
- UI components
|
||||||
|
|
||||||
|
2. Organizza per categoria
|
||||||
|
|
||||||
|
3. Per ogni immagine, includi:
|
||||||
|
- Fonte (URL o descrizione)
|
||||||
|
- Perché è rilevante
|
||||||
|
- Cosa prendere
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/moodboard.md` (con immagini o link)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 5: Design Principles
|
||||||
|
|
||||||
|
**Obiettivo:** Linee guida per decisioni di design.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Definisci 5-7 principi guida
|
||||||
|
2. Per ogni principio:
|
||||||
|
- Nome
|
||||||
|
- Descrizione (1-2 frasi)
|
||||||
|
- Esempio applicativo
|
||||||
|
|
||||||
|
**Esempio:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Design Principles
|
||||||
|
|
||||||
|
### 1. Clarity First
|
||||||
|
Ogni elemento deve comunicare uno scopo chiaro.
|
||||||
|
Se non aggiunge valore, rimuovi.
|
||||||
|
|
||||||
|
**Esempio:** Hero con headline singola, CTA chiara, niente rumore.
|
||||||
|
|
||||||
|
### 2. Consistent Rhythm
|
||||||
|
Spacing e layout seguono una griglia modulare.
|
||||||
|
|
||||||
|
**Esempio:** Padding sezioni: 64/96/128px (scala modulare).
|
||||||
|
|
||||||
|
### 3. Proof-Driven
|
||||||
|
Ogni claim supportato da evidence visibile.
|
||||||
|
|
||||||
|
**Esempio:** Dopo services, logo wall o testimonial.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/design_principles.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/design/creative_direction.md` | Markdown | Direzione creativa |
|
||||||
|
| `clients/{client}/design/moodboard.md` | Markdown + immagini | Moodboard visiva |
|
||||||
|
| `clients/{client}/design/design_principles.md` | Markdown | Principi design |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [design_patterns.md](../../references/design_patterns.md) — Pattern UI
|
||||||
|
- [hero_sections.md](../../references/hero_sections.md) — Hero patterns
|
||||||
|
- [layout_systems.md](../../references/layout_systems.md) — Grid e spacing
|
||||||
|
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessuna referenza disponibile:** Crea moodboard da zero usando pattern generali
|
||||||
|
- **Brand constraints forti:** Adatta direzione ai vincoli esistenti
|
||||||
|
- **Cliente non tecnico:** Usa linguaggio semplice, evita gergo design
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Moodboard richiede immagini (tool esterno o screenshot)
|
||||||
|
- Direzione visiva è soggettiva: richiede approvazione cliente
|
||||||
|
- Non sostituisce design system dettagliato (compito di `agency-design-system`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-creative-director/references
Symbolic link
1
agency-creative-director/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
250
agency-design-system/SKILL.md
Normal file
250
agency-design-system/SKILL.md
Normal file
|
|
@ -0,0 +1,250 @@
|
||||||
|
---
|
||||||
|
name: agency-design-system
|
||||||
|
description: Creare design system coerente con tokens, components e page layouts. Usare quando: (1) nuovo progetto needs UI system, (2) standardizzare design, (3) creare component library. Output: Design tokens, components library, page layouts, design system doc.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Visual Designer — Design System
|
||||||
|
|
||||||
|
Traduce la direzione creativa in un design system coerente e riutilizzabile.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo progetto:** Costruire UI system da zero
|
||||||
|
- **Design system refresh:** Aggiornare tokens/components
|
||||||
|
- **Multi-page project:** Standardizzare layout
|
||||||
|
- **Handoff a developer:** Documentare componenti
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `creative_direction` | object | Da creative director |
|
||||||
|
| `design_principles` | array | Principi guida |
|
||||||
|
| `brand_assets` | object | Loghi, colori brand (se esistenti) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Design Tokens
|
||||||
|
|
||||||
|
**Obiettivo:** Definire variabili di design di base.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. **Typography:**
|
||||||
|
- Font family (primary, secondary)
|
||||||
|
- Font sizes (H1-H6, body, caption)
|
||||||
|
- Font weights
|
||||||
|
- Line heights
|
||||||
|
|
||||||
|
2. **Spacing:**
|
||||||
|
- Scala modulare (es. 4/8/16/24/32/48/64)
|
||||||
|
- Section padding (desktop/mobile)
|
||||||
|
|
||||||
|
3. **Colors:**
|
||||||
|
- Primary (brand)
|
||||||
|
- Secondary (accents)
|
||||||
|
- Neutrals (text, backgrounds)
|
||||||
|
- Semantic (success, warning, error)
|
||||||
|
|
||||||
|
4. **Breakpoints:**
|
||||||
|
- Mobile (<768px)
|
||||||
|
- Tablet (768-1024px)
|
||||||
|
- Desktop (>1024px)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Design Tokens
|
||||||
|
|
||||||
|
## Typography
|
||||||
|
|
||||||
|
### Font Families
|
||||||
|
- Primary: {font}
|
||||||
|
- Secondary: {font}
|
||||||
|
|
||||||
|
### Font Sizes
|
||||||
|
- H1: 48px / 3rem
|
||||||
|
- H2: 36px / 2.25rem
|
||||||
|
- H3: 24px / 1.5rem
|
||||||
|
- Body: 16px / 1rem
|
||||||
|
- Caption: 14px / 0.875rem
|
||||||
|
|
||||||
|
## Spacing
|
||||||
|
- 4px, 8px, 16px, 24px, 32px, 48px, 64px
|
||||||
|
|
||||||
|
## Colors
|
||||||
|
- Primary: {hex}
|
||||||
|
- Secondary: {hex}
|
||||||
|
- Text: {hex}
|
||||||
|
- Background: {hex}
|
||||||
|
|
||||||
|
## Breakpoints
|
||||||
|
- Mobile: <768px
|
||||||
|
- Tablet: 768-1024px
|
||||||
|
- Desktop: >1024px
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/tokens.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: UI Components
|
||||||
|
|
||||||
|
**Obiettivo:** Creare library componenti riutilizzabili.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica componenti necessari:
|
||||||
|
- Buttons (primary, secondary, tertiary)
|
||||||
|
- Cards (service, testimonial, feature)
|
||||||
|
- Forms (input, textarea, select)
|
||||||
|
- Navigation (header, footer, mobile menu)
|
||||||
|
- Content blocks (hero, features, FAQ, CTA)
|
||||||
|
|
||||||
|
2. Per ogni componente, documenta:
|
||||||
|
- Nome
|
||||||
|
- Scopo
|
||||||
|
- Varianti (se applicabile)
|
||||||
|
- States (hover, active, disabled)
|
||||||
|
- Accessibility notes
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Button
|
||||||
|
|
||||||
|
**Scopo:** CTA e azioni primarie
|
||||||
|
|
||||||
|
### Varianti
|
||||||
|
- Primary (filled)
|
||||||
|
- Secondary (outline)
|
||||||
|
- Tertiary (text-only)
|
||||||
|
|
||||||
|
### States
|
||||||
|
- Default
|
||||||
|
- Hover
|
||||||
|
- Active
|
||||||
|
- Disabled
|
||||||
|
|
||||||
|
### Accessibility
|
||||||
|
- Min height 44px
|
||||||
|
- Contrast ratio 4.5:1
|
||||||
|
- Focus visible
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/components.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Page Layouts
|
||||||
|
|
||||||
|
**Obiettivo:** Definire strutture pagina tipo.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica page type necessari:
|
||||||
|
- Homepage
|
||||||
|
- Service page
|
||||||
|
- About page
|
||||||
|
- Contact page
|
||||||
|
- Case study page
|
||||||
|
- Blog post
|
||||||
|
|
||||||
|
2. Per ogni layout, documenta:
|
||||||
|
- Sezione header (hero)
|
||||||
|
- Sezioni content (ordine)
|
||||||
|
- Sezione footer
|
||||||
|
- Pattern usati (da references)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Homepage Layout
|
||||||
|
|
||||||
|
1. **Hero section**
|
||||||
|
- Headline
|
||||||
|
- Sub copy
|
||||||
|
- CTA primaria
|
||||||
|
- Proof chips
|
||||||
|
|
||||||
|
2. **Logo wall** (trust)
|
||||||
|
|
||||||
|
3. **Services overview** (card grid)
|
||||||
|
|
||||||
|
4. **Case study teaser** (split layout)
|
||||||
|
|
||||||
|
5. **Testimonial** (hero testimonial)
|
||||||
|
|
||||||
|
6. **CTA finale + footer**
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/page_layouts.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Design System Documentation
|
||||||
|
|
||||||
|
**Obiettivo:** Consolidare tutto in documento unico.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Crea documento che include:
|
||||||
|
- Introduzione (scopo del design system)
|
||||||
|
- Design principles (da creative director)
|
||||||
|
- Tokens
|
||||||
|
- Components
|
||||||
|
- Layouts
|
||||||
|
- Usage guidelines
|
||||||
|
|
||||||
|
2. Includi esempi visivi (se possibile)
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/design/design_system.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/design/tokens.md` | Markdown | Design tokens |
|
||||||
|
| `clients/{client}/design/components.md` | Markdown | Component library |
|
||||||
|
| `clients/{client}/design/page_layouts.md` | Markdown | Page layouts |
|
||||||
|
| `clients/{client}/design/design_system.md` | Markdown | Design system completo |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [layout_systems.md](../../references/layout_systems.md) — Grid e spacing
|
||||||
|
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
|
||||||
|
- [design_patterns.md](../../references/design_patterns.md) — UI patterns
|
||||||
|
- [qa_visual.md](../../references/qa_visual.md) — QA checklist
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Brand esistente:** Adatta tokens ai colori/font esistenti
|
||||||
|
- **Progetto piccolo:** Semplifica (tokens essenziali + 5-6 components base)
|
||||||
|
- **Nessun designer:** Usa pattern standard da references
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Componenti complessi richiedono tool di design (Figma, Sketch)
|
||||||
|
- Design system completo richiede iterazione con feedback
|
||||||
|
- Handoff a developer richiede specifiche tecniche aggiuntive
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-design-system/references
Symbolic link
1
agency-design-system/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
166
agency-orchestrator/SKILL.md
Normal file
166
agency-orchestrator/SKILL.md
Normal file
|
|
@ -0,0 +1,166 @@
|
||||||
|
---
|
||||||
|
name: agency-orchestrator
|
||||||
|
description: Coordinare agenti, gestire backlog e decisioni, e garantire qualità per workflow multi-agente. Usare quando: (1) avviare nuovo progetto/cliente, (2) coordinare output di più agenti, (3) gestire backlog e decisioni, (4) eseguire QA trasversale. Output: Backlog aggiornato, decision log, QA notes, stato workflow.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Orchestrator — Coordinamento Multi-Agente
|
||||||
|
|
||||||
|
Coordina agenti e mantiene stato (backlog/decisioni/QA) per arrivare a V1 rapidamente e iterare.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo progetto:** Avviare onboarding cliente e definire MVP
|
||||||
|
- **Coordinamento:** Consolidare output di più agenti (strategy, design, content)
|
||||||
|
- **Backlog management:** Prioritizzare task P0/P1/P2
|
||||||
|
- **QA trasversale:** Verificare qualità deliverable prima di publish
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client (es. `clients/demo_co/`) |
|
||||||
|
| `workflow_id` | string | ID workflow da eseguire (es. `20_website`) |
|
||||||
|
| `agents_needed` | array | Lista agenti richiesti |
|
||||||
|
| `deadline` | string | Opzionale, deadline progetto |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Definizione MVP e Backlog
|
||||||
|
|
||||||
|
**Obiettivo:** Chiarire output minimi e prioritizzare.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Leggi `core/policies/quality_bar.md` per standard V1
|
||||||
|
2. Definisci output MVP (P0) vs Next (P1/P2)
|
||||||
|
3. Crea/aggiorna `clients/{client}/ops/backlog.md`
|
||||||
|
4. Registra assunzioni in `clients/{client}/ops/decisions.md`
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- V1 funzionante > perfezione
|
||||||
|
- Non bloccare per input mancanti: fai assunzioni e continua
|
||||||
|
- Documenta tutte le assunzioni nel decision log
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Coordinamento Agenti
|
||||||
|
|
||||||
|
**Obiettivo:** Assegnare task e monitorare progresso.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Per ogni agente necessario:
|
||||||
|
- Verifica input disponibili
|
||||||
|
- Assegna task con DoD chiaro
|
||||||
|
- Imposta deadline interna
|
||||||
|
2. Monitora stato avanzamento
|
||||||
|
3. Risolvi conflitti o dipendenze bloccanti
|
||||||
|
|
||||||
|
**Agenti tipici:**
|
||||||
|
- `agency-strategy` → positioning, messaging
|
||||||
|
- `agency-research` → competitor, reference
|
||||||
|
- `agency-creative-director` → direzione visiva
|
||||||
|
- `agency-ux-copy` → sitemap, page copy
|
||||||
|
- `agency-design-system` → design system
|
||||||
|
- `agency-social` / `agency-youtube` → content
|
||||||
|
- `agency-visual-generator` → asset
|
||||||
|
- `agency-publisher` → publish (post-approvazione)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Consolidamento e QA
|
||||||
|
|
||||||
|
**Obiettivo:** Verificare coerenza output e qualità.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Raccogli output da tutti gli agenti
|
||||||
|
2. Verifica coerenza cross-deliverable
|
||||||
|
3. Esegui QA checklist (vedi `references/quality_bar.md`)
|
||||||
|
4. Crea `clients/{client}/ops/qa_notes.md` con issue + fix
|
||||||
|
5. Aggiorna backlog con task di fix
|
||||||
|
|
||||||
|
**QA Checklist:**
|
||||||
|
- [ ] Output in path corretto
|
||||||
|
- [ ] Frontmatter presente e valido
|
||||||
|
- [ ] Fonti loggate (se richiesto)
|
||||||
|
- [ ] QA specifico compilato (es. qa_website.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Publish Gate
|
||||||
|
|
||||||
|
**Obiettivo:** Gestire approvazione pre-publish.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Verifica `references/publishing_gates.md`
|
||||||
|
2. Imposta `APPROVED: YES` nei file content (post-review)
|
||||||
|
3. Crea `PUBLISH_APPROVED.md` se pronto
|
||||||
|
4. Triggera `agency-publisher` solo se gate superato
|
||||||
|
|
||||||
|
**Regola:** Mai publish senza `APPROVED: YES` esplicito.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/ops/backlog.md` | Markdown | Task P0/P1/P2 |
|
||||||
|
| `clients/{client}/ops/decisions.md` | Markdown | Decisioni e assunzioni |
|
||||||
|
| `clients/{client}/ops/qa_notes.md` | Markdown | Issue QA + fix proposti |
|
||||||
|
| `clients/{client}/ops/run_log.md` | Markdown | Log operativo (opzionale) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Esempio Output
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Backlog — Demo Co
|
||||||
|
|
||||||
|
## P0 (MVP)
|
||||||
|
- [ ] Homepage copy V1
|
||||||
|
- [ ] Services page copy V1
|
||||||
|
- [ ] Contact page copy V1
|
||||||
|
|
||||||
|
## P1 (Next)
|
||||||
|
- [ ] About page
|
||||||
|
- [ ] Case study template
|
||||||
|
|
||||||
|
## P2 (Later)
|
||||||
|
- [ ] Blog setup
|
||||||
|
- [ ] SEO advanced
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [quality_bar.md](../../references/quality_bar.md) — Standard V1
|
||||||
|
- [publishing_gates.md](../../references/publishing_gates.md) — Gate pre-publish
|
||||||
|
- [research_citation_rules.md](../../references/research_citation_rules.md) — Citazione fonti
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Input mancanti:** Fai assunzioni ragionevoli, documenta in decision log, procedi
|
||||||
|
- **Conflitti tra agenti:** Orchestratore decide in base a priorità MVP
|
||||||
|
- **QA fallisce:** Crea task di fix nel backlog, non bloccare tutto il workflow
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Questa skill non esegue direttamente il lavoro degli agenti specialistici
|
||||||
|
- Richiede che gli altri agenti siano disponibili/eseguibili
|
||||||
|
- Publish richiede integrazione webhook configurata
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-orchestrator/references
Symbolic link
1
agency-orchestrator/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
225
agency-publisher/SKILL.md
Normal file
225
agency-publisher/SKILL.md
Normal file
|
|
@ -0,0 +1,225 @@
|
||||||
|
---
|
||||||
|
name: agency-publisher
|
||||||
|
description: Pubblicare o programmare post social e video YouTube tramite webhook, solo dopo approvazione. Usare quando: (1) content approvato ready per publish, (2) scheduling programmato, (3) aggiornare publish log. Output: Content pubblicato, publish log aggiornato, status file aggiornato.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Publisher — Publish Gate-Based
|
||||||
|
|
||||||
|
Pubblica (o programma) content su social e YouTube solo dopo approvazione esplicita.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Social publish:** Post approvato ready
|
||||||
|
- **YouTube publish:** Video metadata approvati
|
||||||
|
- **Scheduling:** Programmare publish futuro
|
||||||
|
- **Publish log:** Aggiornare storico
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `content_files` | array | File content da pubblicare |
|
||||||
|
| `platform` | string | "social" / "youtube" |
|
||||||
|
| `publish_mode` | string | "immediate" / "scheduled" |
|
||||||
|
| `scheduled_for` | string | Data/ora (se scheduled) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Verify Approval Gate
|
||||||
|
|
||||||
|
**Obiettivo:** Verificare che content sia approvato.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Per ogni content file, verifica:
|
||||||
|
- Frontmatter contiene `status: approved`
|
||||||
|
- Frontmatter contiene `APPROVED: YES`
|
||||||
|
- `PUBLISH_APPROVED.md` del cliente contiene `YES`
|
||||||
|
|
||||||
|
2. Se gate NON superato:
|
||||||
|
- **STOP:** Non procedere
|
||||||
|
- Notifica utente che approvazione manca
|
||||||
|
|
||||||
|
3. Se gate superato:
|
||||||
|
- Procedi a Fase 2
|
||||||
|
|
||||||
|
**Checklist:**
|
||||||
|
- [ ] `status: approved` nel frontmatter
|
||||||
|
- [ ] `APPROVED: YES` presente
|
||||||
|
- [ ] `PUBLISH_APPROVED.md` = YES
|
||||||
|
- [ ] QA compilato e passato
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Preparazione Payload
|
||||||
|
|
||||||
|
**Obiettivo:** Creare payload per webhook.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Estrai dati dal content file:
|
||||||
|
- **Social:** Text, asset_path, platform, hashtags
|
||||||
|
- **YouTube:** Title, description, thumbnail_path, tags, scheduled_for
|
||||||
|
|
||||||
|
2. Genera `idempotency_key`:
|
||||||
|
- Formula: `{client}_{platform}_{post_id}_{version}`
|
||||||
|
- Esempio: `demo_co_linkedin_post_001_v1`
|
||||||
|
|
||||||
|
3. Compila payload:
|
||||||
|
|
||||||
|
**Payload Social:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"client": "{client_name}",
|
||||||
|
"platform": "linkedin",
|
||||||
|
"text": "{post_copy}",
|
||||||
|
"asset_paths": ["{path_to_image}"],
|
||||||
|
"scheduled_for": "2026-03-10T09:00:00Z",
|
||||||
|
"idempotency_key": "demo_co_linkedin_post_001_v1",
|
||||||
|
"hashtags": ["#tag1", "#tag2"],
|
||||||
|
"metadata": {
|
||||||
|
"post_id": "post_001",
|
||||||
|
"pillar": "Education"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Payload YouTube:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"client": "{client_name}",
|
||||||
|
"platform": "youtube",
|
||||||
|
"title": "{video_title}",
|
||||||
|
"description": "{video_description}",
|
||||||
|
"thumbnail_path": "{path_to_thumbnail}",
|
||||||
|
"tags": ["tag1", "tag2"],
|
||||||
|
"scheduled_for": "2026-03-10T14:00:00Z",
|
||||||
|
"idempotency_key": "demo_co_youtube_ep_001_v1",
|
||||||
|
"metadata": {
|
||||||
|
"episode": "001",
|
||||||
|
"duration": "8:45"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Webhook Call
|
||||||
|
|
||||||
|
**Obiettivo:** Inviare payload a webhook di publish.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica webhook endpoint (configurato in `core/skills/publish_webhook.md` o variabile ambiente)
|
||||||
|
|
||||||
|
2. Invia POST request con:
|
||||||
|
- Headers: `Content-Type: application/json`
|
||||||
|
- Body: Payload JSON
|
||||||
|
|
||||||
|
3. Gestisci risposta:
|
||||||
|
- **Success (2xx):** Estrai `remote_id` e `post_url`
|
||||||
|
- **Error (4xx/5xx):** Logga errore, non aggiornare status
|
||||||
|
|
||||||
|
4. Implementa retry logic (opzionale):
|
||||||
|
- Max 3 retry
|
||||||
|
- Backoff: 30s, 60s, 120s
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Update Content File
|
||||||
|
|
||||||
|
**Obiettivo:** Aggiornare file con status publish.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Aggiungi/aggiorna frontmatter:
|
||||||
|
```yaml
|
||||||
|
status: published # o "scheduled"
|
||||||
|
published_at: 2026-03-09T10:30:00Z
|
||||||
|
post_url: https://linkedin.com/post/xyz123
|
||||||
|
remote_id: xyz123
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Se scheduled:
|
||||||
|
```yaml
|
||||||
|
status: scheduled
|
||||||
|
scheduled_for: 2026-03-10T09:00:00Z
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 5: Update Publish Log
|
||||||
|
|
||||||
|
**Obiettivo:** Tracciare publish in log centrale.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Apri/crea `clients/{client}/ops/publish_log.md`
|
||||||
|
|
||||||
|
2. Aggiungi entry:
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Publish Log — {Client}
|
||||||
|
|
||||||
|
| Data | Platform | Content ID | Status | URL | Note |
|
||||||
|
|------|----------|------------|--------|-----|------|
|
||||||
|
| 2026-03-09 | LinkedIn | post_001 | Published | https://... | Engagement buono |
|
||||||
|
| 2026-03-09 | YouTube | ep_001 | Scheduled | - | Publish: 2026-03-10 14:00 |
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Per YouTube, aggiorna anche `clients/{client}/youtube/published_log.md`
|
||||||
|
4. Per Social, aggiorna `clients/{client}/social/published_log.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/ops/publish_log.md` | Markdown | Log centrale publish |
|
||||||
|
| `clients/{client}/social/published_log.md` | Markdown | Log social (opzionale) |
|
||||||
|
| `clients/{client}/youtube/published_log.md` | Markdown | Log YouTube (opzionale) |
|
||||||
|
| Content files aggiornati | Markdown | `status: published/scheduled` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [publishing_gates.md](../../references/publishing_gates.md) — Gate rules
|
||||||
|
- [quality_bar.md](../../references/quality_bar.md) — Standard qualità
|
||||||
|
- [publish_webhook.md](../../skills/publish_webhook.md) — Webhook config
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Webhook fallisce:** Logga errore, riprova (max 3 volte), notifica utente
|
||||||
|
- **Doppio publish:** Idempotency_key previene duplicati
|
||||||
|
- **Scheduled in futuro:** Imposta status "scheduled", aggiorna log
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Richiede webhook integration configurata (n8n/Make/Zapier)
|
||||||
|
- YouTube video upload (file) out-of-scope senza integrazione specifica
|
||||||
|
- Alcuni platform hanno rate limits (rispettare)
|
||||||
|
|
||||||
|
**Sicurezza:**
|
||||||
|
|
||||||
|
- Mai pubblicare senza `APPROVED: YES`
|
||||||
|
- Idempotency_key previene publish accidentali multipli
|
||||||
|
- Logga tutto per audit trail
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-publisher/references
Symbolic link
1
agency-publisher/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
259
agency-research/SKILL.md
Normal file
259
agency-research/SKILL.md
Normal file
|
|
@ -0,0 +1,259 @@
|
||||||
|
---
|
||||||
|
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_
|
||||||
1
agency-research/references
Symbolic link
1
agency-research/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
245
agency-seo/SKILL.md
Normal file
245
agency-seo/SKILL.md
Normal file
|
|
@ -0,0 +1,245 @@
|
||||||
|
---
|
||||||
|
name: agency-seo
|
||||||
|
description: Gestire SEO tecnico per siti web: keyword research, metadata, schema markup. Usare quando: (1) nuovo sito needs SEO setup, (2) ottimizzare pagine esistenti, (3) implementare schema markup. Output: Keyword list, meta library, schema notes, SEO changelog.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Dev/SEO — SEO Tecnico
|
||||||
|
|
||||||
|
SEO tecnico, metadata e schema markup per visibilità search.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo sito:** Setup SEO fondamentale
|
||||||
|
- **SEO audit:** Ottimizzare pagine esistenti
|
||||||
|
- **Schema markup:** Implementare structured data
|
||||||
|
- **Ongoing:** Mantenere changelog SEO
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `website_pages` | array | Lista pagine da ottimizzare |
|
||||||
|
| `copy_docs` | array | Copy pagine (da ux-copy) |
|
||||||
|
| `keyword_seed` | array | Keyword iniziali (opzionale) |
|
||||||
|
| `competitors` | array | Competitor per benchmark (opzionale) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Keyword Seed List
|
||||||
|
|
||||||
|
**Obiettivo:** Creare lista keyword di base.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Se keyword seed fornite: espandi con varianti
|
||||||
|
2. Se non fornite: crea lista ragionata basata su:
|
||||||
|
- Offering del cliente
|
||||||
|
- Audience personas
|
||||||
|
- Competitor (se noti)
|
||||||
|
|
||||||
|
3. Categorizza keyword:
|
||||||
|
- **Primary:** 1-2 per pagina principale
|
||||||
|
- **Secondary:** 2-3 per pagina
|
||||||
|
- **Long-tail:** Per blog/content
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Keyword Seed List
|
||||||
|
|
||||||
|
## Homepage
|
||||||
|
- Primary: "agency {settore}", "servizi {niche}"
|
||||||
|
- Secondary: "consulenza {settore}", "agenzia {città}"
|
||||||
|
|
||||||
|
## Services
|
||||||
|
- Primary: "servizi {settore}", "{servizio} prezzo"
|
||||||
|
- Secondary: "miglior {servizio}", "{servizio} professionale"
|
||||||
|
|
||||||
|
## About
|
||||||
|
- Primary: "chi siamo {settore}", "{brand} recensioni"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/website/seo/keywords.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Meta Library
|
||||||
|
|
||||||
|
**Obiettivo:** Creare title e meta description per ogni pagina.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Per ogni pagina in sitemap:
|
||||||
|
|
||||||
|
**Title tag:**
|
||||||
|
- 50-60 caratteri
|
||||||
|
- Keyword primaria all'inizio
|
||||||
|
- Brand name alla fine
|
||||||
|
- Formula: `{Primary Keyword} | {Brand Name}`
|
||||||
|
|
||||||
|
**Meta description:**
|
||||||
|
- 150-160 caratteri
|
||||||
|
- Include keyword primaria
|
||||||
|
- Copy compelling con CTA implicita
|
||||||
|
- Formula: `{Beneficio} + {Proof} + {CTA}`
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Meta Library
|
||||||
|
|
||||||
|
## Homepage
|
||||||
|
- **Title:** Agency {Settore} per {Audience} | {Brand}
|
||||||
|
- **Meta:** Aiutiamo {audience} a ottenere {outcome} con {approccio}.
|
||||||
|
{Proof}. Prenota una call gratuita.
|
||||||
|
|
||||||
|
## Services
|
||||||
|
- **Title:** Servizi di {Settore} | {Brand}
|
||||||
|
- **Meta:** {Servizio 1}, {Servizio 2}, {Servizio 3}.
|
||||||
|
Risultati concreti per {audience}. Richiedi preventivo.
|
||||||
|
|
||||||
|
## About
|
||||||
|
- **Title:** Chi Siamo | {Brand} - {Settore}
|
||||||
|
- **Meta:** {Anni} anni di esperienza in {settore}.
|
||||||
|
Scopri il nostro approccio e il team.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/website/seo/meta_library.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Schema Markup Notes
|
||||||
|
|
||||||
|
**Obiettivo:** Pianificare structured data per rich snippets.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica schema types rilevanti:
|
||||||
|
- **Organization** (homepage/about)
|
||||||
|
- **LocalBusiness** (se business locale)
|
||||||
|
- **Service** (service pages)
|
||||||
|
- **FAQPage** (se FAQ presenti)
|
||||||
|
- **Article/BlogPosting** (blog posts)
|
||||||
|
|
||||||
|
2. Per ogni pagina, specifica:
|
||||||
|
- Schema type
|
||||||
|
- Proprietà richieste
|
||||||
|
- Valori da inserire
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Schema Notes
|
||||||
|
|
||||||
|
## Homepage — Organization Schema
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"@context": "https://schema.org",
|
||||||
|
"@type": "Organization",
|
||||||
|
"name": "{Brand Name}",
|
||||||
|
"url": "{website_url}",
|
||||||
|
"logo": "{logo_url}",
|
||||||
|
"description": "{meta description}",
|
||||||
|
"sameAs": [
|
||||||
|
"{social_link_1}",
|
||||||
|
"{social_link_2}"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Services — Service Schema
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"@context": "https://schema.org",
|
||||||
|
"@type": "Service",
|
||||||
|
"serviceType": "{Servizio}",
|
||||||
|
"provider": {
|
||||||
|
"@type": "Organization",
|
||||||
|
"name": "{Brand}"
|
||||||
|
},
|
||||||
|
"areaServed": {
|
||||||
|
"@type": "Country",
|
||||||
|
"name": "Italia"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/website/seo/schema_notes.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: SEO Changelog
|
||||||
|
|
||||||
|
**Obiettivo:** Tracciare cambiamenti SEO nel tempo.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Crea log con:
|
||||||
|
- Data
|
||||||
|
- Pagina modificata
|
||||||
|
- Tipo di cambiamento
|
||||||
|
- Motivazione
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# SEO Changelog
|
||||||
|
|
||||||
|
| Data | Pagina | Cambiamento | Motivazione |
|
||||||
|
|------|--------|-------------|-------------|
|
||||||
|
| 2026-03-09 | Homepage | Update title + meta | Ottimizzazione keyword |
|
||||||
|
| 2026-03-09 | Services | Aggiunto schema Service | Rich snippets |
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/website/changelog.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/website/seo/keywords.md` | Markdown | Keyword seed list |
|
||||||
|
| `clients/{client}/website/seo/meta_library.md` | Markdown | Title e meta per pagine |
|
||||||
|
| `clients/{client}/website/seo/schema_notes.md` | Markdown | Schema markup plans |
|
||||||
|
| `clients/{client}/website/changelog.md` | Markdown | SEO changelog |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [seo_fundamentals.md](../../references/seo_fundamentals.md) — Fondamentali SEO
|
||||||
|
- [metadata_rules.md](../../references/metadata_rules.md) — Regole meta tag
|
||||||
|
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessun dato keyword:** Crea seed list basata su offering e buon senso
|
||||||
|
- **Sito esistente:** Esegui audit prima di cambiare (usa tool SEO se disponibili)
|
||||||
|
- **Multi-lingua:** Piano SEO separato per ogni lingua
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Keyword research approfondita richiede tool dedicati (Ahrefs, SEMrush)
|
||||||
|
- Implementazione tecnica richiede accesso al codice
|
||||||
|
- Risultati SEO richiedono tempo (3-6 mesi minimi)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-seo/references
Symbolic link
1
agency-seo/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
218
agency-social/SKILL.md
Normal file
218
agency-social/SKILL.md
Normal file
|
|
@ -0,0 +1,218 @@
|
||||||
|
---
|
||||||
|
name: agency-social
|
||||||
|
description: Creare social strategy, calendario editoriale e post queue per LinkedIn, Instagram, X. Usare quando: (1) nuovo cliente needs social presence, (2) pianificare content calendar, (3) creare post queue. Output: Social strategy, calendario 4 settimane, 10+ post in queue.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Social Editor — Social Strategy e Content
|
||||||
|
|
||||||
|
Social strategy, calendario editoriale e post queue con visual brief.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo cliente:** Impostare presenza social
|
||||||
|
- **Content planning:** Pianificare 4+ settimane
|
||||||
|
- **Post production:** Creare queue di post pronti
|
||||||
|
- **Strategy refresh:** Aggiornare approccio social
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `content_pillars` | array | Da strategy |
|
||||||
|
| `brand_voice` | object | Tone of voice |
|
||||||
|
| `platforms` | array | Piattaforme target (LinkedIn, Instagram, X) |
|
||||||
|
| `posting_frequency` | object | Frequenza per piattaforma |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Social Strategy
|
||||||
|
|
||||||
|
**Obiettivo:** Definire approccio per piattaforma.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Per ogni piattaforma, definisci:
|
||||||
|
- **Scopo:** Perché essere presenti
|
||||||
|
- **Audience:** Chi seguiamo/raggiungiamo
|
||||||
|
- **Formati:** Cosa pubblichiamo
|
||||||
|
- **Frequenza:** Quanto spesso
|
||||||
|
- **KPI:** Come misuriamo successo
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Social Strategy
|
||||||
|
|
||||||
|
## LinkedIn
|
||||||
|
- **Scopo:** Thought leadership, B2B lead gen
|
||||||
|
- **Audience:** Founders, PM, decision maker B2B
|
||||||
|
- **Formati:** Text post, carousel, article
|
||||||
|
- **Frequenza:** 3x settimana
|
||||||
|
- **KPI:** Engagement rate, DM inbound, profile views
|
||||||
|
|
||||||
|
## Instagram
|
||||||
|
- **Scopo:** Brand awareness, visual storytelling
|
||||||
|
- **Audience:** {Target}
|
||||||
|
- **Formati:** Reel, carousel, stories
|
||||||
|
- **Frequenza:** 4x settimana
|
||||||
|
- **KPI:** Reach, saves, shares
|
||||||
|
|
||||||
|
## X / Twitter
|
||||||
|
- **Scopo:** Real-time engagement, network building
|
||||||
|
- **Audience:** {Target}
|
||||||
|
- **Formati:** Thread, single tweet
|
||||||
|
- **Frequenza:** 5x settimana
|
||||||
|
- **KPI:** Replies, retweets, profile clicks
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/social/social_strategy.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Calendario Editoriale
|
||||||
|
|
||||||
|
**Obiettivo:** Pianificare 4 settimane di content.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa content pillars da strategy
|
||||||
|
2. Mappa pillar a formati per piattaforma
|
||||||
|
3. Crea calendario 4 settimane:
|
||||||
|
- Data
|
||||||
|
- Piattaforma
|
||||||
|
- Formato
|
||||||
|
- Pillar
|
||||||
|
- Hook/Topic
|
||||||
|
- Status (draft/scheduled/published)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Social Calendar — 4 Settimane
|
||||||
|
|
||||||
|
## Settimana 1
|
||||||
|
| Data | Platform | Formato | Pillar | Topic | Status |
|
||||||
|
|------|----------|---------|--------|-------|--------|
|
||||||
|
| Lun | LinkedIn | Text | Education | "3 errori comuni in {settore}" | Draft |
|
||||||
|
| Mar | Instagram | Carousel | Case Study | "Prima/Dopo: {cliente}" | Draft |
|
||||||
|
| Mer | X | Thread | Insights | "Come {risultato} in 5 step" | Draft |
|
||||||
|
| ... | ... | ... | ... | ... | ... |
|
||||||
|
|
||||||
|
## Settimana 2
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/social/calendar.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Post Queue
|
||||||
|
|
||||||
|
**Obiettivo:** Creare 10+ post pronti per la queue.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Per ogni post, compila spec:
|
||||||
|
|
||||||
|
**Template Post:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Post 001
|
||||||
|
|
||||||
|
**Platform:** LinkedIn
|
||||||
|
**Format:** Text post
|
||||||
|
**Pillar:** Education
|
||||||
|
**Status:** Draft
|
||||||
|
|
||||||
|
## Content
|
||||||
|
|
||||||
|
**Hook:**
|
||||||
|
{Prima riga che cattura attenzione}
|
||||||
|
|
||||||
|
**Body:**
|
||||||
|
{Contenuto principale, 3-5 punti o paragrafi brevi}
|
||||||
|
|
||||||
|
**CTA:**
|
||||||
|
{Call to action: commenta, DM, link in bio}
|
||||||
|
|
||||||
|
## Visual Brief
|
||||||
|
|
||||||
|
**Tipo:** Nessuno / Immagine singola / Carousel
|
||||||
|
**Descrizione:** {Cosa mostrare}
|
||||||
|
**Testo su immagine:** {Copy se applicabile}
|
||||||
|
|
||||||
|
## Metadata
|
||||||
|
|
||||||
|
**Hashtag:** #tag1 #tag2 #tag3
|
||||||
|
**Tag:** @{company}, @{person}
|
||||||
|
**Scheduled:** {Data/ora se programmato}
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Crea minimo 10 post (mix di pillar e formati)
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/social/posts/post_001.md` ... `post_010.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Published Log (Opzionale)
|
||||||
|
|
||||||
|
**Obiettivo:** Tracciare post pubblicati.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Dopo publish, aggiorna log:
|
||||||
|
- Data publish
|
||||||
|
- Piattaforma
|
||||||
|
- Post ID
|
||||||
|
- Performance (se disponibili)
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/social/published_log.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/social/social_strategy.md` | Markdown | Strategy per piattaforma |
|
||||||
|
| `clients/{client}/social/calendar.md` | Markdown | Calendario 4 settimane |
|
||||||
|
| `clients/{client}/social/posts/*.md` | Markdown | 10+ post in queue |
|
||||||
|
| `clients/{client}/social/published_log.md` | Markdown | Log publish (opzionale) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [content_formats.md](../../references/content_formats.md) — Formati social
|
||||||
|
- [platform_patterns.md](../../references/platform_patterns.md) — Pattern per piattaforma
|
||||||
|
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
|
||||||
|
- [social_post_spec.md](../../templates/social_post_spec.md) — Template post
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessun visual asset:** Usa visual brief per `agency-visual-generator`
|
||||||
|
- **Cliente non fornisce feedback:** Procedi con assunzioni documentate
|
||||||
|
- **Platform nuove:** Adatta strategy (es. TikTok richiede video)
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Publishing richiede approvazione (vedi `publishing_gates.md`)
|
||||||
|
- Performance tracking richiede accesso analytics
|
||||||
|
- Post queue va aggiornata regolarmente
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-social/references
Symbolic link
1
agency-social/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
206
agency-strategy/SKILL.md
Normal file
206
agency-strategy/SKILL.md
Normal file
|
|
@ -0,0 +1,206 @@
|
||||||
|
---
|
||||||
|
name: agency-strategy
|
||||||
|
description: Definire positioning, messaging e content pillars per un brand o progetto. Usare quando: (1) nuovo cliente/progetto, (2) refresh strategico, (3) definire content strategy, (4) creare messaging house. Output: Positioning statement, messaging house, content pillars, go-to-market plan.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Strategy Lead — Positioning e Messaging
|
||||||
|
|
||||||
|
Definisce la direzione strategica di un brand: positioning, messaging e content pillars.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo cliente:** Creare strategia da zero
|
||||||
|
- **Rebrand:** Aggiornare positioning esistente
|
||||||
|
- **Content strategy:** Definire pilastri content
|
||||||
|
- **Go-to-market:** Pianificare lancio
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client (es. `clients/demo_co/`) |
|
||||||
|
| `company_profile` | object | Profilo azienda (da knowledge o input) |
|
||||||
|
| `audience_data` | object | Dati audience (personas, ICP) |
|
||||||
|
| `competitor_insights` | array | Insight da research competitor |
|
||||||
|
| `offerings` | array | Lista offerte/servizi |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Analisi Contesto
|
||||||
|
|
||||||
|
**Obiettivo:** Comprendere azienda, audience e mercato.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Leggi `clients/{client}/knowledge/company_profile.md`
|
||||||
|
2. Leggi `clients/{client}/knowledge/audience.md` (o crea da template)
|
||||||
|
3. Leggi `clients/{client}/research/competitor_teardowns.md` (se esiste)
|
||||||
|
4. Identifica:
|
||||||
|
- Problema principale che l'azienda risolve
|
||||||
|
- Audience primaria e secondaria
|
||||||
|
- Differentiatori vs competitor
|
||||||
|
|
||||||
|
**Output intermedi:**
|
||||||
|
- Note di analisi in `clients/{client}/strategy/analysis_notes.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Positioning
|
||||||
|
|
||||||
|
**Obiettivo:** Definire positioning chiaro e differenziante.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa formula da `references/strategy_playbook.md`:
|
||||||
|
> "For [audience] who want [outcome], we provide [solution] unlike [alternative] because [proof]."
|
||||||
|
|
||||||
|
2. Compila ogni elemento:
|
||||||
|
- **Audience:** Chi è il target primario?
|
||||||
|
- **Outcome:** Che risultato vogliono?
|
||||||
|
- **Solution:** Cosa offri?
|
||||||
|
- **Alternative:** Quali alternative esistono?
|
||||||
|
- **Proof:** Perché fidarsi?
|
||||||
|
|
||||||
|
3. Scrivi positioning statement finale (1-2 frasi)
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/strategy/positioning.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Messaging House
|
||||||
|
|
||||||
|
**Obiettivo:** Strutturare messaggi chiave.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. **Core message:** Primary promise del brand (1 frase)
|
||||||
|
2. **Supporting messages:** 3-5 argomenti chiave
|
||||||
|
3. **Proof points:** Evidence (numeri, risultati, testimonial)
|
||||||
|
4. **CTA:** Azione desiderata (contact, signup, purchase)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Messaging House
|
||||||
|
|
||||||
|
## Core Message
|
||||||
|
{Promise principale}
|
||||||
|
|
||||||
|
## Supporting Messages
|
||||||
|
1. {Argomento 1}
|
||||||
|
2. {Argomento 2}
|
||||||
|
3. {Argomento 3}
|
||||||
|
|
||||||
|
## Proof Points
|
||||||
|
- {Proof 1}
|
||||||
|
- {Proof 2}
|
||||||
|
- {Proof 3}
|
||||||
|
|
||||||
|
## CTA
|
||||||
|
{Azione desiderata}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/strategy/messaging.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Content Pillars
|
||||||
|
|
||||||
|
**Obiettivo:** Definire 4-6 topic per content strategy.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Identifica 4-6 pillar rilevanti per audience e offering
|
||||||
|
2. Per ogni pillar, definisci:
|
||||||
|
- Nome
|
||||||
|
- Descrizione (1 frase)
|
||||||
|
- Format suggeriti (da `references/content_formats.md`)
|
||||||
|
|
||||||
|
**Esempio:**
|
||||||
|
|
||||||
|
| Pillar | Descrizione | Format |
|
||||||
|
|--------|-------------|--------|
|
||||||
|
| Education | Insegnare concetti chiave | Tutorial, guide, checklist |
|
||||||
|
| Insights | Opinioni e trend | Opinion post, teardown |
|
||||||
|
| Case Studies | Dimostrare risultati | Mini-case, before/after |
|
||||||
|
| Behind the Scenes | Mostrare processo | Process snippet, team |
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/strategy/content_pillars.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 5: Go-to-Market Plan (Opzionale)
|
||||||
|
|
||||||
|
**Obiettivo:** Pianificare lancio o refresh.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Definisci fasi (pre-lancio, lancio, post-lancio)
|
||||||
|
2. Per ogni fase:
|
||||||
|
- Canali da usare
|
||||||
|
- Content da produrre
|
||||||
|
- Timeline
|
||||||
|
3. Identifica KPI di successo
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/strategy/go_to_market.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/strategy/positioning.md` | Markdown | Positioning statement |
|
||||||
|
| `clients/{client}/strategy/messaging.md` | Markdown | Messaging house |
|
||||||
|
| `clients/{client}/strategy/content_pillars.md` | Markdown | 4-6 content pillars |
|
||||||
|
| `clients/{client}/strategy/go_to_market.md` | Markdown | GTM plan (opzionale) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Esempio Output
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Positioning — Demo Co
|
||||||
|
|
||||||
|
For **founders e PM B2B** che vogliono **comunicare valore in modo chiaro**,
|
||||||
|
forniamo **strategy, design e content** a differenza di **agency generaliste**
|
||||||
|
perché **specializzati in clarity-first e conversioni**.
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [strategy_playbook.md](../../references/strategy_playbook.md) — Framework positioning
|
||||||
|
- [copy_frameworks.md](../../references/copy_frameworks.md) — Framework copy
|
||||||
|
- [content_formats.md](../../references/content_formats.md) — Formati content
|
||||||
|
- [audience_personas.md](../../references/audience_personas.md) — Template personas
|
||||||
|
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessun dato audience:** Crea personas da interviste o assumi basandoti su offering
|
||||||
|
- **Competitor sconosciuti:** Esegui research veloce o usa knowledge generale
|
||||||
|
- **Offering complesso:** Semplifica in 3 categorie max (entry/core/premium)
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Richiede input base su azienda e audience
|
||||||
|
- Research competitor approfondito richiede `agency-research`
|
||||||
|
- Go-to-market plan richiede dati di canale e budget
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-strategy/references
Symbolic link
1
agency-strategy/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
253
agency-ux-copy/SKILL.md
Normal file
253
agency-ux-copy/SKILL.md
Normal file
|
|
@ -0,0 +1,253 @@
|
||||||
|
---
|
||||||
|
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 |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `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:**
|
||||||
|
- `clients/{client}/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 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:**
|
||||||
|
- `clients/{client}/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 `references/copy_frameworks.md`:**
|
||||||
|
- PAS (Problem-Agitate-Solve)
|
||||||
|
- AIDA (Attention-Interest-Desire-Action)
|
||||||
|
- Before-After-Bridge
|
||||||
|
|
||||||
|
4. **Applica `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 `clients/{client}/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:**
|
||||||
|
- `clients/{client}/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:**
|
||||||
|
- `clients/{client}/website/qa/qa_website.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/website/sitemap.md` | Markdown | Architettura sito |
|
||||||
|
| `clients/{client}/website/pages/*.md` | Markdown | Copy pagine |
|
||||||
|
| `clients/{client}/website/seo/meta.md` | Markdown | SEO metadata |
|
||||||
|
| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [copy_frameworks.md](../../references/copy_frameworks.md) — Framework copy
|
||||||
|
- [conversion_patterns.md](../../references/conversion_patterns.md) — CTA e conversioni
|
||||||
|
- [hero_sections.md](../../references/hero_sections.md) — Hero patterns
|
||||||
|
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
|
||||||
|
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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_
|
||||||
1
agency-ux-copy/references
Symbolic link
1
agency-ux-copy/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
247
agency-visual-generator/SKILL.md
Normal file
247
agency-visual-generator/SKILL.md
Normal file
|
|
@ -0,0 +1,247 @@
|
||||||
|
---
|
||||||
|
name: agency-visual-generator
|
||||||
|
description: Generare asset visuali (card, carousel, thumbnail) per social e YouTube basati su content approvato e style guide. Usare quando: (1) post social needs visual, (2) YouTube thumbnail, (3) carousel Instagram/LinkedIn. Output: Asset PNG/webp in cartella client, QA visual compilato.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency Visual Generator — Asset Visuali
|
||||||
|
|
||||||
|
Genera asset visuali platform-ready basati su content approvato e style guide.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Social post:** Creare visual per post in queue
|
||||||
|
- **YouTube:** Thumbnail per video
|
||||||
|
- **Carousel:** Instagram/LinkedIn multi-slide
|
||||||
|
- **Brand assets:** Immagini coordinate per cliente
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `content_files` | array | Post o script che richiedono visual |
|
||||||
|
| `style_guide` | object | Style guide cliente (colori, font) |
|
||||||
|
| `asset_type` | string | "card" / "carousel" / "thumbnail" |
|
||||||
|
| `platform` | string | "linkedin" / "instagram" / "youtube" |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: Analisi Richiesta
|
||||||
|
|
||||||
|
**Obiettivo:** Capire che asset serve.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Leggi content file (post o script)
|
||||||
|
2. Identifica:
|
||||||
|
- Piattaforma target
|
||||||
|
- Tipo asset (card, carousel, thumbnail)
|
||||||
|
- Copy da includere (hook, CTA)
|
||||||
|
- Visual brief (se presente)
|
||||||
|
|
||||||
|
3. Verifica aspect ratio richiesto:
|
||||||
|
- **LinkedIn card:** 1200x627px (1.91:1)
|
||||||
|
- **Instagram carousel:** 1080x1350px (4:5)
|
||||||
|
- **YouTube thumbnail:** 1280x720px (16:9)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Style Guide Check
|
||||||
|
|
||||||
|
**Obiettivo:** Caricare o creare style guide.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Cerca `clients/{client}/design/style_guide.md` o `clients/{client}/assets/brand/style_guide.md`
|
||||||
|
|
||||||
|
2. Se esiste:
|
||||||
|
- Carica colori (hex)
|
||||||
|
- Carica font (family, weights)
|
||||||
|
- Carica logo (se disponibile)
|
||||||
|
|
||||||
|
3. Se NON esiste:
|
||||||
|
- Crea draft style guide in `clients/{client}/assets/brand/style_guide.md`
|
||||||
|
- Chiedi approvazione prima di procedere
|
||||||
|
|
||||||
|
**Template Style Guide:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Style Guide — {Client}
|
||||||
|
|
||||||
|
## Colors
|
||||||
|
- Primary: {hex}
|
||||||
|
- Secondary: {hex}
|
||||||
|
- Text: {hex}
|
||||||
|
- Background: {hex}
|
||||||
|
|
||||||
|
## Fonts
|
||||||
|
- Primary: {font-family}
|
||||||
|
- Secondary: {font-family}
|
||||||
|
|
||||||
|
## Logo
|
||||||
|
- URL: {logo_url}
|
||||||
|
- Usage: {note}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Compilazione JSON Template
|
||||||
|
|
||||||
|
**Obiettivo:** Preparare prompt per generazione.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Carica template appropriato da `core/templates/visual/`:
|
||||||
|
- `linkedin_card.json`
|
||||||
|
- `instagram_carousel.json`
|
||||||
|
- `youtube_thumbnail.json`
|
||||||
|
|
||||||
|
2. Compila campi:
|
||||||
|
- `text` (headline, sub, CTA)
|
||||||
|
- `colors` (da style guide)
|
||||||
|
- `fonts` (da style guide)
|
||||||
|
- `logo` (se disponibile)
|
||||||
|
- `imagery` (descrizione visual)
|
||||||
|
|
||||||
|
**Esempio YouTube Thumbnail JSON:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"format": "youtube_thumbnail",
|
||||||
|
"dimensions": { "width": 1280, "height": 720 },
|
||||||
|
"text": {
|
||||||
|
"headline": "3 Errori Comuni",
|
||||||
|
"sub": "Che Tutti Fanno in {Settore}",
|
||||||
|
"cta": "GUARDA ORA"
|
||||||
|
},
|
||||||
|
"colors": {
|
||||||
|
"background": "#1a1a2e",
|
||||||
|
"text": "#ffffff",
|
||||||
|
"accent": "#e94560"
|
||||||
|
},
|
||||||
|
"fonts": {
|
||||||
|
"headline": "Inter Bold 72px",
|
||||||
|
"sub": "Inter Regular 36px"
|
||||||
|
},
|
||||||
|
"imagery": "Foto persona sorpresa, lato destro, sfondo sfocato"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Generazione Immagine
|
||||||
|
|
||||||
|
**Obiettivo:** Generare asset con tool configured.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa tool di generazione immagini (OpenClaw integration o servizio esterno)
|
||||||
|
2. Passa JSON template come prompt strutturato
|
||||||
|
3. Genera immagine PNG/webp
|
||||||
|
4. Salva in:
|
||||||
|
- `clients/{client}/assets/social/{post_id}.png`
|
||||||
|
- `clients/{client}/assets/youtube/thumbnails/{ep_id}.png`
|
||||||
|
- `clients/{client}/assets/social/carousels/{id}/slide_01.png`, etc.
|
||||||
|
|
||||||
|
5. Aggiorna content file con `asset_path`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 5: Visual QA
|
||||||
|
|
||||||
|
**Obiettivo:** Verificare qualità asset.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa checklist da `references/qa_visual.md`:
|
||||||
|
|
||||||
|
**Readability:**
|
||||||
|
- [ ] Text readable at mobile size (320px)
|
||||||
|
- [ ] Strong contrast text/background
|
||||||
|
- [ ] Headline <= 8 words
|
||||||
|
|
||||||
|
**Brand:**
|
||||||
|
- [ ] Colors match style guide
|
||||||
|
- [ ] Fonts match style guide
|
||||||
|
- [ ] No off-brand elements
|
||||||
|
|
||||||
|
**Message:**
|
||||||
|
- [ ] One clear idea per image
|
||||||
|
- [ ] Visual supports hook/CTA
|
||||||
|
- [ ] No misleading visuals
|
||||||
|
|
||||||
|
**Technical:**
|
||||||
|
- [ ] Correct aspect ratio
|
||||||
|
- [ ] No artifacts / broken text
|
||||||
|
- [ ] Safe margins for UI overlays
|
||||||
|
|
||||||
|
2. Registra risultato in `clients/{client}/assets/qa/qa_visual.md`
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# QA Visual — {Asset Name}
|
||||||
|
|
||||||
|
**Data:** 2026-03-09
|
||||||
|
**Asset:** {path}
|
||||||
|
|
||||||
|
## Checklist
|
||||||
|
|
||||||
|
| Categoria | Check | Risultato |
|
||||||
|
|-----------|-------|-----------|
|
||||||
|
| Readability | Text mobile-size | ✅ Pass |
|
||||||
|
| Readability | Contrast | ✅ Pass |
|
||||||
|
| Brand | Colors | ✅ Pass |
|
||||||
|
| Brand | Fonts | ⚠️ Fallback usato |
|
||||||
|
| Message | One idea | ✅ Pass |
|
||||||
|
| Technical | Aspect ratio | ✅ Pass |
|
||||||
|
|
||||||
|
## Esito
|
||||||
|
|
||||||
|
**Status:** APPROVED / NEEDS_FIX
|
||||||
|
|
||||||
|
**Note:** {Eventuali fix richiesti}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/assets/social/*.png` | PNG/webp | Card social |
|
||||||
|
| `clients/{client}/assets/social/carousels/*/slide_*.png` | PNG | Carousel slides |
|
||||||
|
| `clients/{client}/assets/youtube/thumbnails/*.png` | PNG | YouTube thumbnail |
|
||||||
|
| `clients/{client}/assets/qa/qa_visual.md` | Markdown | QA checklist |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [qa_visual.md](../../references/qa_visual.md) — QA checklist
|
||||||
|
- [platform_patterns.md](../../references/platform_patterns.md) — Pattern per piattaforma
|
||||||
|
- [publishing_gates.md](../../references/publishing_gates.md) — Gate pre-publish
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessuno style guide:** Crea draft e chiedi approvazione
|
||||||
|
- **Testo troppo lungo:** Adatta copy (max 8 parole headline)
|
||||||
|
- **Logo mancante:** Procedi senza, segnala nel QA
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Richiede integrazione tool generazione immagini
|
||||||
|
- Quality varia in base a prompt e tool
|
||||||
|
- Iterazioni possono essere necessarie per perfezionare
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-visual-generator/references
Symbolic link
1
agency-visual-generator/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
246
agency-youtube/SKILL.md
Normal file
246
agency-youtube/SKILL.md
Normal file
|
|
@ -0,0 +1,246 @@
|
||||||
|
---
|
||||||
|
name: agency-youtube
|
||||||
|
description: Creare YouTube strategy, calendario e script retention-first. Usare quando: (1) nuovo canale YouTube, (2) pianificare content video, (3) scrivere script. Output: YouTube strategy, calendario, 2+ script completi con thumbnail brief.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Agency YouTube Producer — Strategy e Script
|
||||||
|
|
||||||
|
Strategia YouTube, calendario e script orientati a retention.
|
||||||
|
|
||||||
|
## Quando Usare
|
||||||
|
|
||||||
|
- **Nuovo canale:** Impostare strategy da zero
|
||||||
|
- **Content planning:** Pianificare episodi
|
||||||
|
- **Script writing:** Scrivere script retention-first
|
||||||
|
- **Channel refresh:** Aggiornare approccio
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Input
|
||||||
|
|
||||||
|
| Input | Tipo | Validazione |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| `client_path` | string | Percorso client |
|
||||||
|
| `content_pillars` | array | Da strategy |
|
||||||
|
| `brand_voice` | object | Tone of voice |
|
||||||
|
| `target_audience` | object | Audience YouTube |
|
||||||
|
| `video_frequency` | string | Frequenza upload (es. "1x settimana") |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Processo
|
||||||
|
|
||||||
|
### Fase 1: YouTube Strategy
|
||||||
|
|
||||||
|
**Obiettivo:** Definire approccio al canale.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. **Channel positioning:**
|
||||||
|
- Scopo del canale
|
||||||
|
- Audience target
|
||||||
|
- Value proposition unica
|
||||||
|
|
||||||
|
2. **Format/Serie:**
|
||||||
|
- Identifica 2-4 format ricorrenti
|
||||||
|
- Per ogni formato: nome, descrizione, frequenza
|
||||||
|
|
||||||
|
3. **KPI:**
|
||||||
|
- Views
|
||||||
|
- Watch time / retention
|
||||||
|
- Subscribers
|
||||||
|
- Engagement (comments, likes)
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# YouTube Strategy
|
||||||
|
|
||||||
|
## Channel Positioning
|
||||||
|
- **Scopo:** {Perché esiste il canale}
|
||||||
|
- **Audience:** {Chi guarderà i video}
|
||||||
|
- **Value Prop:** {Perché guardare questo canale}
|
||||||
|
|
||||||
|
## Format / Serie
|
||||||
|
|
||||||
|
### Format 1: {Nome}
|
||||||
|
- **Descrizione:** {Cosa è}
|
||||||
|
- **Frequenza:** {Ogni quanto}
|
||||||
|
- **Durata target:** {Minuti}
|
||||||
|
|
||||||
|
### Format 2: {Nome}
|
||||||
|
...
|
||||||
|
|
||||||
|
## KPI Target
|
||||||
|
- Views/episodio: {target}
|
||||||
|
- Retention media: {target}%
|
||||||
|
- Subscriber growth: {target}/mese
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/youtube/youtube_strategy.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 2: Calendario Episodi
|
||||||
|
|
||||||
|
**Obiettivo:** Pianificare 4-8 episodi.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Crea calendario con:
|
||||||
|
- Episodio #
|
||||||
|
- Titolo working
|
||||||
|
- Formato
|
||||||
|
- Pillar
|
||||||
|
- Status (idea/script/filmed/edited/published)
|
||||||
|
- Data target publish
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# YouTube Calendar
|
||||||
|
|
||||||
|
| Ep # | Titolo | Formato | Pillar | Status | Data Target |
|
||||||
|
|------|--------|---------|--------|--------|-------------|
|
||||||
|
| 001 | "3 errori comuni in {settore}" | Tutorial | Education | Script | 2026-03-15 |
|
||||||
|
| 002 | "Case Study: {Cliente}" | Case Study | Proof | Idea | 2026-03-22 |
|
||||||
|
| 003 | "Come {risultato} in 5 step" | Tutorial | Education | Script | 2026-03-29 |
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/youtube/calendar.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 3: Script Writing
|
||||||
|
|
||||||
|
**Obiettivo:** Scrivere 2+ script completi retention-first.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Usa struttura da `references/youtube_script_framework.md`:
|
||||||
|
- 0-10s: Hook (promise + curiosity)
|
||||||
|
- 10-25s: Credibility (why listen)
|
||||||
|
- 25-60s: Problem definition
|
||||||
|
- Main: 3-5 chapters con open loops
|
||||||
|
- End: Summary + CTA
|
||||||
|
|
||||||
|
2. Per ogni script, compila:
|
||||||
|
|
||||||
|
**Template:**
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Episode 001 — {Titolo}
|
||||||
|
|
||||||
|
**Format:** {Tutorial/Teardown/Case Study}
|
||||||
|
**Durata target:** {minuti}
|
||||||
|
**Status:** Draft
|
||||||
|
|
||||||
|
## Hook (0-10s)
|
||||||
|
{Promise + curiosity. Esempio: "In questo video ti mostro come X in Y tempo. La maggior parte sbaglia Z..."}
|
||||||
|
|
||||||
|
## Credibility (10-25s)
|
||||||
|
{Perché ascoltarti. Esempio: "Ho aiutato 50+ clienti a fare X..."}
|
||||||
|
|
||||||
|
## Problem (25-60s)
|
||||||
|
{Definisci problema relatable. Esempio: "Se sei qui, probabilmente stai lottando con..."}
|
||||||
|
|
||||||
|
## Chapter 1: {Titolo}
|
||||||
|
- Punto chiave 1
|
||||||
|
- Esempio concreto
|
||||||
|
- Mini-recap
|
||||||
|
|
||||||
|
## Chapter 2: {Titolo}
|
||||||
|
...
|
||||||
|
|
||||||
|
## Chapter 3: {Titolo}
|
||||||
|
...
|
||||||
|
|
||||||
|
## Summary + CTA
|
||||||
|
- Recap punti chiave
|
||||||
|
- CTA: "Iscriviti", "Commenta", "Guarda il prossimo video"
|
||||||
|
|
||||||
|
## Thumbnail Brief
|
||||||
|
|
||||||
|
**Titolo su thumbnail:** {3-5 parole max}
|
||||||
|
**Visual:** {Cosa mostrare}
|
||||||
|
**Colori:** {Palette}
|
||||||
|
|
||||||
|
## Metadata
|
||||||
|
|
||||||
|
**Titolo video (3 opzioni):**
|
||||||
|
1. {Opzione 1}
|
||||||
|
2. {Opzione 2}
|
||||||
|
3. {Opzione 3}
|
||||||
|
|
||||||
|
**Descrizione:**
|
||||||
|
{Copy descrizione YouTube con link e timestamp}
|
||||||
|
|
||||||
|
**Tags:** {tag1, tag2, tag3}
|
||||||
|
|
||||||
|
**Chapters:**
|
||||||
|
0:00 Intro
|
||||||
|
0:45 Chapter 1
|
||||||
|
2:30 Chapter 2
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/youtube/scripts/ep_001.md`, `ep_002.md`, etc.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 4: Published Log (Opzionale)
|
||||||
|
|
||||||
|
**Obiettivo:** Tracciare video pubblicati.
|
||||||
|
|
||||||
|
**Azioni:**
|
||||||
|
|
||||||
|
1. Dopo publish, aggiorna:
|
||||||
|
- Data publish
|
||||||
|
- Video URL
|
||||||
|
- Performance (views, retention, etc.)
|
||||||
|
|
||||||
|
**Output:**
|
||||||
|
- `clients/{client}/youtube/published_log.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
| File | Formato | Descrizione |
|
||||||
|
|------|---------|-------------|
|
||||||
|
| `clients/{client}/youtube/youtube_strategy.md` | Markdown | Strategy canale |
|
||||||
|
| `clients/{client}/youtube/calendar.md` | Markdown | Calendario episodi |
|
||||||
|
| `clients/{client}/youtube/scripts/*.md` | Markdown | 2+ script completi |
|
||||||
|
| `clients/{client}/youtube/published_log.md` | Markdown | Log publish (opzionale) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [youtube_script_framework.md](../../references/youtube_script_framework.md) — Struttura script
|
||||||
|
- [content_formats.md](../../references/content_formats.md) — Formati YouTube
|
||||||
|
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
|
||||||
|
- [youtube_script.md](../../templates/youtube_script.md) — Template script
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
**Edge Cases:**
|
||||||
|
|
||||||
|
- **Nessun dato audience:** Usa personas da strategy o assumi basandoti su content pillars
|
||||||
|
- **Cliente non vuole video:** Focus su script per voiceover + B-roll
|
||||||
|
- **Thumbnail:** Usa brief per `agency-visual-generator`
|
||||||
|
|
||||||
|
**Limitazioni:**
|
||||||
|
|
||||||
|
- Upload video richiede tool esterno o integrazione YouTube API
|
||||||
|
- Performance tracking richiede YouTube Studio access
|
||||||
|
- Script efficaci richiedono pratica e testing
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Skill generata da framework-translator_
|
||||||
1
agency-youtube/references
Symbolic link
1
agency-youtube/references
Symbolic link
|
|
@ -0,0 +1 @@
|
||||||
|
../references
|
||||||
35
references/audience_personas.md
Normal file
35
references/audience_personas.md
Normal file
|
|
@ -0,0 +1,35 @@
|
||||||
|
# Audience Personas
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-strategy, agency-research_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Template per definire ICP e personas.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Persona Template
|
||||||
|
|
||||||
|
| Campo | Descrizione |
|
||||||
|
|-------|-----------|
|
||||||
|
| **Nome** | Nome fittizio della persona |
|
||||||
|
| **Ruolo/Contesto** | Lavoro, settore, situazione |
|
||||||
|
| **Obiettivi** | Cosa vuole raggiungere |
|
||||||
|
| **Pain Points** | Problemi, frustrazioni |
|
||||||
|
| **Trigger di Acquisto** | Cosa li spinge a cercare soluzioni |
|
||||||
|
| **Obiezioni** | Dubbi, barriere all'acquisto |
|
||||||
|
| **Canali** | Dove si informano (social, search, etc.) |
|
||||||
|
| **Linguaggio** | Parole che usano (verbatim) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Note
|
||||||
|
|
||||||
|
- Compilare 2-4 personas per cliente
|
||||||
|
- Usare linguaggio reale (da interviste, recensioni, social)
|
||||||
|
- Aggiornare dopo research competitor
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
49
references/brand_voice.md
Normal file
49
references/brand_voice.md
Normal file
|
|
@ -0,0 +1,49 @@
|
||||||
|
# Brand Voice
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-strategy, agency-social, agency-youtube_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Linee guida tono di voce per web e social.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Attributi (scegline 3-5)
|
||||||
|
|
||||||
|
- Professionale ma umano
|
||||||
|
- Diretto
|
||||||
|
- Ottimista realistico
|
||||||
|
- Tecnico solo quando serve
|
||||||
|
- Ironico (leggero)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dos & Don'ts
|
||||||
|
|
||||||
|
### Do
|
||||||
|
- Frasi brevi, verbi attivi
|
||||||
|
- Spiegazioni con esempi
|
||||||
|
- CTA chiare
|
||||||
|
|
||||||
|
### Don't
|
||||||
|
- Superlativi vuoti ("il migliore")
|
||||||
|
- Fuffa motivazionale
|
||||||
|
- Troppo slang se non coerente
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Micro-linee Guida
|
||||||
|
|
||||||
|
**Emoji:**
|
||||||
|
- (Sì/No) + regole specifiche
|
||||||
|
|
||||||
|
**Uso del "tu" vs "voi":**
|
||||||
|
- Definire preferenza
|
||||||
|
|
||||||
|
**Punteggiatura:**
|
||||||
|
- Es. niente !!!
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
57
references/case_study_structures.md
Normal file
57
references/case_study_structures.md
Normal file
|
|
@ -0,0 +1,57 @@
|
||||||
|
# Case Study Structures
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-strategy, agency-ux-copy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Template per case study che dimostrano competenza e riducono rischio percepito.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Case Study Skeleton (Consigliato)
|
||||||
|
|
||||||
|
### 1) Snapshot
|
||||||
|
- Cliente / settore
|
||||||
|
- Obiettivo
|
||||||
|
- Servizi
|
||||||
|
- Risultato chiave (1-3 metriche)
|
||||||
|
|
||||||
|
### 2) Problema
|
||||||
|
- Contesto
|
||||||
|
- Vincoli
|
||||||
|
- Perché era difficile
|
||||||
|
|
||||||
|
### 3) Approccio
|
||||||
|
- Strategia
|
||||||
|
- Decisioni chiave (3-5)
|
||||||
|
|
||||||
|
### 4) Soluzione
|
||||||
|
- Cosa è stato creato
|
||||||
|
- Highlights
|
||||||
|
|
||||||
|
### 5) Risultati
|
||||||
|
- Metriche (se disponibili)
|
||||||
|
- Output qualitativi (es. "riduzione frizione")
|
||||||
|
|
||||||
|
### 6) Learnings
|
||||||
|
- Cosa rifaresti
|
||||||
|
- Cosa evitare
|
||||||
|
|
||||||
|
### 7) CTA
|
||||||
|
- "Vuoi un progetto simile?"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Se Non Hai Metriche
|
||||||
|
|
||||||
|
**Usa:**
|
||||||
|
- Outcomes qualitativi
|
||||||
|
- Deliverable concreti
|
||||||
|
- Quote cliente
|
||||||
|
|
||||||
|
**Indica:** "Metriche non disponibili" (trasparenza).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
75
references/content_formats.md
Normal file
75
references/content_formats.md
Normal file
|
|
@ -0,0 +1,75 @@
|
||||||
|
# Content Formats
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-social, agency-youtube_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Formati content per social e YouTube, organizzati per rubriche.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Content Pillars → Formats
|
||||||
|
|
||||||
|
Ogni pillar dovrebbe produrre 3-5 format ricorrenti (rubriche).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Social Formats (Agency)
|
||||||
|
|
||||||
|
### 1) Breakdown (analisi di un sito/campagna)
|
||||||
|
- Hook: "3 cose che funzionano / non funzionano"
|
||||||
|
- Bullets
|
||||||
|
- Takeaway
|
||||||
|
|
||||||
|
### 2) Mini-case (prima/dopo)
|
||||||
|
- Contesto
|
||||||
|
- Intervento
|
||||||
|
- Risultato (anche qualitativo)
|
||||||
|
|
||||||
|
### 3) Opinion / POV
|
||||||
|
- Tesi chiara
|
||||||
|
- 2-3 argomenti
|
||||||
|
- CTA: commenta / DM
|
||||||
|
|
||||||
|
### 4) Process Snippet
|
||||||
|
- Come lavorate
|
||||||
|
- Step e strumenti
|
||||||
|
|
||||||
|
### 5) Toolkit / Checklist
|
||||||
|
- Template
|
||||||
|
- Lista rapida
|
||||||
|
|
||||||
|
**Regola:** 1 CTA semplice per post.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## YouTube Formats
|
||||||
|
|
||||||
|
### A) Tutorial (How-to)
|
||||||
|
- Promise in hook
|
||||||
|
- Step-by-step
|
||||||
|
- Recap + CTA
|
||||||
|
|
||||||
|
### B) Teardown (competitor/site review)
|
||||||
|
- Framework
|
||||||
|
- Score
|
||||||
|
- Recommendations
|
||||||
|
|
||||||
|
### C) Case Study Narrative
|
||||||
|
- Problema
|
||||||
|
- Viaggio
|
||||||
|
- Risultato
|
||||||
|
- Lezioni
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## YouTube Retention Tips
|
||||||
|
|
||||||
|
- Hook <10s
|
||||||
|
- Pattern interrupts ogni 20-40s (grafica, esempio, cambio ritmo)
|
||||||
|
- Chapters chiari
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
73
references/conversion_patterns.md
Normal file
73
references/conversion_patterns.md
Normal file
|
|
@ -0,0 +1,73 @@
|
||||||
|
# Conversion Patterns
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-ux-copy, agency-strategy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
CTA, forms e friction reduction per conversioni.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CTA Hierarchy
|
||||||
|
|
||||||
|
- 1 CTA primaria per pagina
|
||||||
|
- 1 CTA secondaria (link-style)
|
||||||
|
- Ripetere CTA primaria 2-3 volte (hero, mid, footer)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contact Section Patterns
|
||||||
|
|
||||||
|
### A) Simple Form
|
||||||
|
- Nome, email, messaggio (max 3-4 campi)
|
||||||
|
|
||||||
|
### B) Calendly / Booking
|
||||||
|
- Utile per agency; includere alternative (email) per chi non vuole booking
|
||||||
|
|
||||||
|
### C) Project Brief Form
|
||||||
|
- Solo se necessario; meglio a step
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Meno campi = più conversione (di solito)
|
||||||
|
- Indicare tempi di risposta (es. 24-48h)
|
||||||
|
- Privacy microcopy vicino al submit
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Lead Magnet (Optional)
|
||||||
|
|
||||||
|
**Quando usarlo:**
|
||||||
|
- Se vuoi "consideration" lunga
|
||||||
|
|
||||||
|
**Esempi:**
|
||||||
|
- Checklist
|
||||||
|
- Mini guida
|
||||||
|
- Template
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Friction Reducers (Microcopy)
|
||||||
|
|
||||||
|
- "Nessuno spam. Rispondiamo entro 48h."
|
||||||
|
- "Puoi anche scriverci a..."
|
||||||
|
- "Budget indicativo? Va bene anche una range."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Conversion Blocks
|
||||||
|
|
||||||
|
- "Process" (3-5 step)
|
||||||
|
- "What you get" (deliverables)
|
||||||
|
- "FAQ" (obiezioni)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anti-pattern
|
||||||
|
|
||||||
|
- CTA vaghe ("Scopri di più" ovunque)
|
||||||
|
- Form lunghissimi senza motivazione
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
71
references/copy_frameworks.md
Normal file
71
references/copy_frameworks.md
Normal file
|
|
@ -0,0 +1,71 @@
|
||||||
|
# Copy Frameworks
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-strategy, agency-ux-copy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Framework copywriting clarity-first per web e social.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Regole Generali
|
||||||
|
|
||||||
|
- Parole semplici > gergo
|
||||||
|
- Frasi corte quando possibile
|
||||||
|
- Evitare claim assoluti non verificabili
|
||||||
|
- Scrivere per "scan" (titoli, bullets, bold con parsimonia)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## PAS (Problem-Agitate-Solve)
|
||||||
|
|
||||||
|
**Struttura:**
|
||||||
|
- **Problem:** descrivi il problema del cliente
|
||||||
|
- **Agitate:** conseguenze se non risolto
|
||||||
|
- **Solve:** come lo risolvi
|
||||||
|
|
||||||
|
**Ottimo per:**
|
||||||
|
- Hero sub-copy
|
||||||
|
- Section intro
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## AIDA (Attention-Interest-Desire-Action)
|
||||||
|
|
||||||
|
**Ottimo per:**
|
||||||
|
- Landing page
|
||||||
|
- Sales section
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Before-After-Bridge
|
||||||
|
|
||||||
|
**Struttura:**
|
||||||
|
- **Before:** situazione attuale
|
||||||
|
- **After:** situazione desiderata
|
||||||
|
- **Bridge:** come ci arrivi (process)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Microcopy (Forms/Buttons)
|
||||||
|
|
||||||
|
**Button:**
|
||||||
|
- Usare verbi chiari ("Prenota call", "Richiedi info")
|
||||||
|
|
||||||
|
**Error:**
|
||||||
|
- Spiegare cosa fare
|
||||||
|
|
||||||
|
**Privacy:**
|
||||||
|
- Rassicurare
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tone Guardrails
|
||||||
|
|
||||||
|
- Preferire assertività tranquilla (non hype)
|
||||||
|
- Evitare frasi "AI-ish" (troppo generiche)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
110
references/design_patterns.md
Normal file
110
references/design_patterns.md
Normal file
|
|
@ -0,0 +1,110 @@
|
||||||
|
# Design Patterns
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-creative-director, agency-design-system, agency-ux-copy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern UI riusabili per siti agency/services. Strutture, non stile.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Card Grid (Services / Features)
|
||||||
|
|
||||||
|
**Quando usarlo:**
|
||||||
|
- Overview servizi
|
||||||
|
- Differentiatori
|
||||||
|
- Step del processo
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Max 6 card desktop, 3-4 mobile
|
||||||
|
- Titolo breve + payoff 1 riga + micro-CTA
|
||||||
|
- Icone solo se aggiungono semantica (non decorative)
|
||||||
|
|
||||||
|
**Varianti:**
|
||||||
|
- Icon + title + 2 bullets
|
||||||
|
- Number + title + paragraph (per process)
|
||||||
|
- Split card (testo + mini proof)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Split Layout (Text + Visual)
|
||||||
|
|
||||||
|
**Quando usarlo:**
|
||||||
|
- Spiegare un concetto o metodo
|
||||||
|
- Mostrare case study teaser
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Testo a sinistra per lingue LTR (scansione naturale)
|
||||||
|
- 1 solo focus visual (non collage)
|
||||||
|
- Includere 1 proof nello stesso blocco (numero, logo, quote)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Section Header (Headline + Support)
|
||||||
|
|
||||||
|
**Pattern:**
|
||||||
|
- Overline (categoria)
|
||||||
|
- Headline (promessa)
|
||||||
|
- Supporting copy (beneficio concreto)
|
||||||
|
- Optional: inline CTA
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Headline: 6-12 parole
|
||||||
|
- Supporting: 1-2 frasi, senza gergo
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Logo Wall (Credibility)
|
||||||
|
|
||||||
|
**Quando usarlo:**
|
||||||
|
- Subito dopo hero o dopo services
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Max 12 loghi visibili (se più, carousel o "view all")
|
||||||
|
- Testo di contesto (es. "Trusted by" o "We worked with")
|
||||||
|
- Evitare loghi non autorizzati
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Testimonial Block
|
||||||
|
|
||||||
|
**Varianti:**
|
||||||
|
- Quote singola "hero testimonial"
|
||||||
|
- Grid di 3 testimonial
|
||||||
|
- Testimonial + risultato (numero)
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Migliore se contiene un risultato specifico
|
||||||
|
- Includere nome/ruolo/azienda quando possibile
|
||||||
|
- Se anonimo: spiegare perché (settore sensibile)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## FAQ (Objections)
|
||||||
|
|
||||||
|
**Quando usarlo:**
|
||||||
|
- Prima della CTA finale
|
||||||
|
- Su services e contact
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- 5-8 domande
|
||||||
|
- Domande reali (prezzo, tempi, processo, revisioni)
|
||||||
|
- Risposte brevi e pratiche
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Footer (Actionable)
|
||||||
|
|
||||||
|
**Include:**
|
||||||
|
- CTA compatta
|
||||||
|
- Contatti chiari
|
||||||
|
- Link legali
|
||||||
|
- Social (se utili)
|
||||||
|
|
||||||
|
**Regola:**
|
||||||
|
- Footer deve "chiudere" il funnel, non solo link.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
84
references/hero_sections.md
Normal file
84
references/hero_sections.md
Normal file
|
|
@ -0,0 +1,84 @@
|
||||||
|
# Hero Sections
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-creative-director, agency-ux-copy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern e formule per hero section efficaci. Deve rispondere in 5 secondi.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Hero Checklist (5 secondi)
|
||||||
|
|
||||||
|
L'hero deve rispondere a:
|
||||||
|
1. Cosa fai
|
||||||
|
2. Per chi
|
||||||
|
3. Che risultato dai
|
||||||
|
4. Perché fidarsi
|
||||||
|
5. Qual è la prossima azione
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Hero Formula (Services / Agency)
|
||||||
|
|
||||||
|
**Headline:** Outcome + Audience
|
||||||
|
**Sub:** Come lo fai (meccanismo) + proof
|
||||||
|
**CTA primaria:** "Prenota call" / "Richiedi preventivo" / "Vedi lavori"
|
||||||
|
**CTA secondaria:** "Guarda casi studio" / "Scarica guida"
|
||||||
|
|
||||||
|
**Esempi (struttura, non testo finale):**
|
||||||
|
- "Brand e siti che convertono per [audience]"
|
||||||
|
- "Strategia, design e contenuti per crescere con coerenza"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Hero Layouts
|
||||||
|
|
||||||
|
### A) Split (text + visual)
|
||||||
|
- Consigliato per studi: pulito, conversion-friendly
|
||||||
|
|
||||||
|
### B) Centered minimal
|
||||||
|
- Consigliato se il messaggio è fortissimo e semplice
|
||||||
|
|
||||||
|
### C) Proof-first
|
||||||
|
- Headline + 3 proof chip (numeri/risultati) + CTA
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Proof Chips (sotto CTA)
|
||||||
|
|
||||||
|
Esempi:
|
||||||
|
- "+120 progetti"
|
||||||
|
- "Da 7 anni"
|
||||||
|
- "Tempo medio: 4-6 settimane"
|
||||||
|
- "Specializzati in [niche]"
|
||||||
|
|
||||||
|
**Regola:** Meglio 1-3 chip concreti che 6 generici.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Hero Visuals
|
||||||
|
|
||||||
|
**Scelte consigliate:**
|
||||||
|
- Fotografia editoriale (autentica)
|
||||||
|
- Mockup selettivo (1-2, non griglia infinita)
|
||||||
|
- Abstract/3D coerente (non stock casuale)
|
||||||
|
|
||||||
|
**Anti-pattern:**
|
||||||
|
- "Team smiling in office" stock
|
||||||
|
- Collage confusi
|
||||||
|
- Troppo testo dentro l'immagine
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Above-the-Fold Checklist
|
||||||
|
|
||||||
|
- [ ] Value prop chiara
|
||||||
|
- [ ] CTA visibile
|
||||||
|
- [ ] Proof presente
|
||||||
|
- [ ] Nessun rumore (nav troppo densa, troppi link)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
68
references/layout_systems.md
Normal file
68
references/layout_systems.md
Normal file
|
|
@ -0,0 +1,68 @@
|
||||||
|
# Layout Systems
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-design-system, agency-creative-director_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Grid, spacing, density per coerenza e ritmo verticale.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Grid (Web)
|
||||||
|
|
||||||
|
**Desktop:** 12 colonne (o 2/3/4 macro colonne)
|
||||||
|
**Tablet:** 8 colonne
|
||||||
|
**Mobile:** 4 colonne (stack verticale)
|
||||||
|
|
||||||
|
**Regola pratica:**
|
||||||
|
- Usa una "content column" leggibile (non full-width testo)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Container Widths
|
||||||
|
|
||||||
|
**Linee guida:**
|
||||||
|
- Max content width: 1100-1200px
|
||||||
|
- Reading width per paragrafi: 60-80 caratteri
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Spacing System
|
||||||
|
|
||||||
|
**Scala modulare preferita:** 4/8/16/24/32/48/64
|
||||||
|
|
||||||
|
**Sezioni:**
|
||||||
|
- Padding top/bottom minimo: 64-96px desktop, 40-64px mobile
|
||||||
|
- Separare sezioni con whitespace, non linee ovunque
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Density Modes
|
||||||
|
|
||||||
|
| Mode | Descrizione | Uso |
|
||||||
|
|------|-----------|-----|
|
||||||
|
| Airy | Più spazio, premium feel | Brand luxury, high-end |
|
||||||
|
| Balanced | Equilibrio | Maggior parte dei casi |
|
||||||
|
| Dense | Compatto | Pagine data-heavy |
|
||||||
|
|
||||||
|
**Regola:** Scegli 1 density mode dominante e mantienilo.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Vertical Rhythm
|
||||||
|
|
||||||
|
- Headline → supporting → content → CTA: sempre con spacing prevedibile
|
||||||
|
- Evitare "salti" casuali
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsive Heuristics
|
||||||
|
|
||||||
|
- Non "ridurre" tutto: spesso serve "stackare" e cambiare ordine
|
||||||
|
- CTA sempre tappabile e visibile
|
||||||
|
- Immagini: evitare crop che elimina il soggetto
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
60
references/navigation_patterns.md
Normal file
60
references/navigation_patterns.md
Normal file
|
|
@ -0,0 +1,60 @@
|
||||||
|
# Navigation Patterns
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-ux-copy, agency-design-system_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern di navigazione e information architecture per siti agency/services.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Primary Navigation (Agency/Services)
|
||||||
|
|
||||||
|
**Consigliato:**
|
||||||
|
- Services
|
||||||
|
- Work / Case studies
|
||||||
|
- About
|
||||||
|
- Resources (optional)
|
||||||
|
- Contact
|
||||||
|
|
||||||
|
**Regole:**
|
||||||
|
- Max 5 voci primarie
|
||||||
|
- 1 CTA button in nav (es. "Prenota call")
|
||||||
|
- Evitare mega-menu se non necessario
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Services IA
|
||||||
|
|
||||||
|
**Opzione A) Service overview + pagine dettagli**
|
||||||
|
- Usa se l'offerta è complessa
|
||||||
|
|
||||||
|
**Opzione B) Packages + outcomes**
|
||||||
|
- Usa se l'offerta è productizzata
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Work / Case Studies IA
|
||||||
|
|
||||||
|
- Index con filtri leggeri (industry/service)
|
||||||
|
- Scheda case: problema → approccio → soluzione → risultato
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mobile Nav
|
||||||
|
|
||||||
|
- Menu semplice, max 1 livello
|
||||||
|
- CTA sempre visibile (sticky o nel menu in alto)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anti-pattern
|
||||||
|
|
||||||
|
- 9 voci in nav
|
||||||
|
- Dropdown profondi
|
||||||
|
- CTA nascosta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
47
references/platform_patterns.md
Normal file
47
references/platform_patterns.md
Normal file
|
|
@ -0,0 +1,47 @@
|
||||||
|
# Platform Patterns
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-social, agency-visual-generator_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern specifici per piattaforma social.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## LinkedIn
|
||||||
|
|
||||||
|
- Hook + valore + proof
|
||||||
|
- Tone: professionale, concreto
|
||||||
|
- CTA: "dimmi nei commenti" / "DM"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Instagram
|
||||||
|
|
||||||
|
**Carousel:**
|
||||||
|
- 1 idea + step + recap
|
||||||
|
|
||||||
|
**Reel:**
|
||||||
|
- Hook → 3 punti → CTA "salva"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## X / Twitter
|
||||||
|
|
||||||
|
**Thread:**
|
||||||
|
- Promessa → punti numerati → chiusura
|
||||||
|
|
||||||
|
**Single Tweet:**
|
||||||
|
- Insight + esempio
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## TikTok
|
||||||
|
|
||||||
|
- Hook visivo + testo
|
||||||
|
- Ritmo alto, tagli rapidi
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
40
references/publishing_gates.md
Normal file
40
references/publishing_gates.md
Normal file
|
|
@ -0,0 +1,40 @@
|
||||||
|
# Publishing Gates
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-orchestrator, agency-publisher_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Gate di approvazione pre-publish per website, social, YouTube.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Regole di Publish
|
||||||
|
|
||||||
|
Publishing allowed only when:
|
||||||
|
|
||||||
|
1. **PUBLISH_APPROVED.md** contiene `YES`
|
||||||
|
2. **Content file** contiene `APPROVED: YES` nel frontmatter
|
||||||
|
3. **Logs** sono aggiornati dopo publishing
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Flusso
|
||||||
|
|
||||||
|
```
|
||||||
|
Draft → Review → Approved → Published
|
||||||
|
```
|
||||||
|
|
||||||
|
- Mai publish senza `APPROVED: YES`
|
||||||
|
- Aggiornare publish log dopo ogni publish
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Eccezioni
|
||||||
|
|
||||||
|
- Nessuna eccezione: gate è obbligatorio
|
||||||
|
- In caso di urgenza: approvazione esplicita richiesta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
51
references/qa_visual.md
Normal file
51
references/qa_visual.md
Normal file
|
|
@ -0,0 +1,51 @@
|
||||||
|
# QA Visual Checklist
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-visual-generator, agency-publisher_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Checklist per review asset visuali generati (card, carousel, thumbnail).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Readability
|
||||||
|
|
||||||
|
- [ ] Text readable at mobile size (simulate 320px wide)
|
||||||
|
- [ ] Strong contrast between text and background
|
||||||
|
- [ ] Headline <= 8 words (unless carousel)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Brand
|
||||||
|
|
||||||
|
- [ ] Colors match the client style guide
|
||||||
|
- [ ] Fonts match the client style guide (or fallback defined)
|
||||||
|
- [ ] No off-brand icons/illustrations
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Message
|
||||||
|
|
||||||
|
- [ ] One clear idea per image
|
||||||
|
- [ ] Visual supports the hook/CTA, not competing with it
|
||||||
|
- [ ] No misleading visuals
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Technical
|
||||||
|
|
||||||
|
- [ ] Correct aspect ratio for platform
|
||||||
|
- [ ] No obvious artifacts / broken text
|
||||||
|
- [ ] Safe margins for UI overlays
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
- **If pass:** mark asset as `approved`
|
||||||
|
- **If fail:** write fixes in `clients/{client}/backlog/tasks.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
41
references/quality_bar.md
Normal file
41
references/quality_bar.md
Normal file
|
|
@ -0,0 +1,41 @@
|
||||||
|
# Quality Bar
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-orchestrator, tutte le skills_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Standard minimo accettabile per deliverable V1.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## V1 Principles
|
||||||
|
|
||||||
|
- **Completa > Perfetta**
|
||||||
|
- **Tracciabile** (decision log + sources log)
|
||||||
|
- **Ripetibile** (template + checklist)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pass/Fail Checklist (Generale)
|
||||||
|
|
||||||
|
### Pass se:
|
||||||
|
- Output in path corretto
|
||||||
|
- Frontmatter presente e valido
|
||||||
|
- Fonti loggate quando richiesto
|
||||||
|
- QA checklist compilata
|
||||||
|
|
||||||
|
### Fail se:
|
||||||
|
- Output mancante o in path sbagliato
|
||||||
|
- Citazioni senza sources log
|
||||||
|
- Tentativo di publish senza `approved`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Applicazione
|
||||||
|
|
||||||
|
Ogni skill deve verificare questi criteri prima di considerare un task completo.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
46
references/research_citation_rules.md
Normal file
46
references/research_citation_rules.md
Normal file
|
|
@ -0,0 +1,46 @@
|
||||||
|
# Research Citation Rules
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-research_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Regole per citazione e logging fonti esterne.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Obbligo
|
||||||
|
|
||||||
|
Tutte le fonti esterne devono essere loggate e referenziate.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Web Research
|
||||||
|
|
||||||
|
Consentita **solo** su domini in whitelist:
|
||||||
|
- Vedi `web_whitelist.yaml`
|
||||||
|
- Vedi `web_sourcing_standard.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Formato
|
||||||
|
|
||||||
|
- Usa ID `SRC-###`
|
||||||
|
- Per client: `clients/{client}/research/sources.md`
|
||||||
|
- Per libreria OS: `core/knowledge/sources/SRC-###.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contenuto Minimo
|
||||||
|
|
||||||
|
Ogni source log deve includere:
|
||||||
|
- Data accesso
|
||||||
|
- Titolo
|
||||||
|
- Publisher/autore
|
||||||
|
- URL
|
||||||
|
- Affidabilità + motivazione
|
||||||
|
- Note / estratti brevi
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
50
references/research_playbook.md
Normal file
50
references/research_playbook.md
Normal file
|
|
@ -0,0 +1,50 @@
|
||||||
|
# Research Playbook
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-research_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Metodo per research competitor e reference.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Competitor Research
|
||||||
|
|
||||||
|
**Analizzare almeno 3 competitor.**
|
||||||
|
|
||||||
|
**Studiare:**
|
||||||
|
- Positioning
|
||||||
|
- Messaging
|
||||||
|
- Offer structure
|
||||||
|
- Conversion mechanics
|
||||||
|
- Trust signals
|
||||||
|
- UX structure
|
||||||
|
- Visual language
|
||||||
|
|
||||||
|
**Deliver insights:**
|
||||||
|
- Copy (cosa copiare)
|
||||||
|
- Avoid (cosa evitare)
|
||||||
|
- Opportunity (opportunità)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Reference Research
|
||||||
|
|
||||||
|
**Look outside the industry for inspiration.**
|
||||||
|
|
||||||
|
**Raccogliere esempi di:**
|
||||||
|
- Hero sections
|
||||||
|
- Layout structures
|
||||||
|
- Navigation patterns
|
||||||
|
- Case study formats
|
||||||
|
- Animation and motion
|
||||||
|
|
||||||
|
**Per ogni reference document:**
|
||||||
|
- Why it works
|
||||||
|
- What to borrow
|
||||||
|
- Possible risks
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
74
references/strategy_playbook.md
Normal file
74
references/strategy_playbook.md
Normal file
|
|
@ -0,0 +1,74 @@
|
||||||
|
# Strategy Playbook
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-strategy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Framework per positioning, messaging e direzione strategica.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Positioning
|
||||||
|
|
||||||
|
**Definire:**
|
||||||
|
- Audience
|
||||||
|
- Problem
|
||||||
|
- Desired outcome
|
||||||
|
- Unique value
|
||||||
|
- Proof
|
||||||
|
|
||||||
|
**Formula:**
|
||||||
|
> "For [audience] who want [outcome], we provide [solution] unlike [alternative] because [proof]."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Messaging
|
||||||
|
|
||||||
|
### Message House
|
||||||
|
|
||||||
|
**Core message:**
|
||||||
|
- Primary promise of the brand
|
||||||
|
|
||||||
|
**Supporting messages:**
|
||||||
|
- 3-5 key arguments supporting the promise
|
||||||
|
|
||||||
|
**Proof points:**
|
||||||
|
- Evidence such as results, numbers, testimonials
|
||||||
|
|
||||||
|
**CTA:**
|
||||||
|
- Desired action (contact, signup, purchase)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Offer Architecture
|
||||||
|
|
||||||
|
Organizza offerte in:
|
||||||
|
|
||||||
|
| Tipo | Descrizione |
|
||||||
|
|------|-----------|
|
||||||
|
| **Entry offer** | Punto di ingresso, basso impegno |
|
||||||
|
| **Core offer** | Offerta principale |
|
||||||
|
| **Premium offer** | High-ticket, completo |
|
||||||
|
|
||||||
|
**Ogni offerta include:**
|
||||||
|
- Outcome
|
||||||
|
- Process
|
||||||
|
- Proof
|
||||||
|
- CTA
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Content Pillars
|
||||||
|
|
||||||
|
Definire 4-6 topic che il brand comunica consistentemente.
|
||||||
|
|
||||||
|
**Esempio:**
|
||||||
|
- Education
|
||||||
|
- Insights
|
||||||
|
- Case studies
|
||||||
|
- Behind the scenes
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
60
references/trust_signal_patterns.md
Normal file
60
references/trust_signal_patterns.md
Normal file
|
|
@ -0,0 +1,60 @@
|
||||||
|
# Trust Signal Patterns
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-ux-copy, agency-strategy_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern per costruire fiducia con prova, chiarezza e coerenza.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tipi di Trust Signals
|
||||||
|
|
||||||
|
### 1) Social Proof
|
||||||
|
- Loghi clienti
|
||||||
|
- Testimonial
|
||||||
|
- Recensioni
|
||||||
|
|
||||||
|
### 2) Proof of Work
|
||||||
|
- Case studies
|
||||||
|
- Portfolio
|
||||||
|
- Process artifacts (wireframe, strategy doc)
|
||||||
|
|
||||||
|
### 3) Authority
|
||||||
|
- Awards
|
||||||
|
- Talk / podcast
|
||||||
|
- Partnerships
|
||||||
|
- Certifications
|
||||||
|
|
||||||
|
### 4) Transparency
|
||||||
|
- Process
|
||||||
|
- Timeline
|
||||||
|
- Pricing posture (anche "starting from")
|
||||||
|
- What's included / excluded
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Placement
|
||||||
|
|
||||||
|
- Vicino a CTA (subito sopra o sotto)
|
||||||
|
- Dopo services overview
|
||||||
|
- Nelle pagine service
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Trust Copy Patterns
|
||||||
|
|
||||||
|
- "Abbiamo aiutato [audience] a ottenere [outcome] con [approach]."
|
||||||
|
- "Approccio: [3 step] — Risultati: [metric]."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anti-pattern
|
||||||
|
|
||||||
|
- Claim generici senza prova ("best agency", "top quality")
|
||||||
|
- Numeri senza contesto
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
52
references/weekly_report_template.md
Normal file
52
references/weekly_report_template.md
Normal file
|
|
@ -0,0 +1,52 @@
|
||||||
|
# Weekly Report Template
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-analytics_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Template per report settimanali KPI.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Template
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Weekly Report - Week {WW}
|
||||||
|
|
||||||
|
## KPI Snapshot
|
||||||
|
|
||||||
|
{Inserire metriche chiave}
|
||||||
|
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
{Cosa ha funzionato}
|
||||||
|
|
||||||
|
## Lowlights
|
||||||
|
|
||||||
|
{Cosa non ha funzionato}
|
||||||
|
|
||||||
|
## Top Content
|
||||||
|
|
||||||
|
{Contenuti migliori}
|
||||||
|
|
||||||
|
## Actions Next Week (max 5)
|
||||||
|
|
||||||
|
1. {Action 1}
|
||||||
|
2. {Action 2}
|
||||||
|
3. {Action 3}
|
||||||
|
4. {Action 4}
|
||||||
|
5. {Action 5}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Regole
|
||||||
|
|
||||||
|
- Max 5 actions per settimana
|
||||||
|
- KPI snapshot deve essere conciso
|
||||||
|
- Focus su insight concreti, non narrative lunghe
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
32
references/youtube_script_framework.md
Normal file
32
references/youtube_script_framework.md
Normal file
|
|
@ -0,0 +1,32 @@
|
||||||
|
# YouTube Script Framework
|
||||||
|
|
||||||
|
_Framework: agency_v3_1 | Estratto: 2026-03-09_
|
||||||
|
_Usato da: agency-youtube_
|
||||||
|
|
||||||
|
## Sommario
|
||||||
|
|
||||||
|
Pattern per script YouTube retention-first.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Struttura Script
|
||||||
|
|
||||||
|
| Tempo | Sezione | Descrizione |
|
||||||
|
|-------|---------|-------------|
|
||||||
|
| 0-10s | Hook | Promise + curiosity |
|
||||||
|
| 10-25s | Credibility | Why you should listen |
|
||||||
|
| 25-60s | Problem | Define the problem (relatable) |
|
||||||
|
| Main | 3-5 Chapters | Con open loops |
|
||||||
|
| End | Summary + CTA | Recap e call to action |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Regole
|
||||||
|
|
||||||
|
- Open a loop ogni 60-90s
|
||||||
|
- Usare esempi, non teoria
|
||||||
|
- Hook deve essere <10s
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_Reference generato da framework-translator_
|
||||||
Loading…
Add table
Add a link
Reference in a new issue