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

name	description
agency-orchestrator	Coordinare agenti, gestire decisioni e qualità per i 5 workflow della suite. Usare quando: (1) avviare nuovo progetto/cliente, (2) attivare uno dei workflow (Analisi, Posizionamento Strategico, Sito Web Aziendale, Landing Page di Prodotto, Strategia Social), (3) coordinare output di più agenti, (4) gestire decisioni, (5) eseguire QA trasversale. Output: Decision log, QA notes, stato progetto.

Agency Orchestrator — Coordinamento Multi-Agente

Coordina agenti e mantiene stato (decisioni/QA) per eseguire i workflow della suite in modo efficiente.

Quando Usare

• Nuovo progetto: Avviare onboarding cliente e definire workflow
• Coordinamento: Consolidare output di più agenti (strategy, design, content)
• Gestione progetto: Monitorare avanzamento workflow
• QA trasversale: Verificare qualità deliverable prima di publish

---

I 5 Workflow della Suite

Questa skill coordina 5 workflow principali:

Workflow	Descrizione	Skills Coinvolte
Analisi	Research competitivo e audit completo	agency-research, agency-analytics
Posizionamento Strategico	Positioning, messaging, content pillars	agency-strategy, agency-creative-director
Sito Web Aziendale	Sito completo da sitemap a publish	agency-ux-copy, agency-design-system, agency-web-developer, agency-seo
Landing Page di Prodotto	Landing page conversion-focused	agency-ux-copy, agency-design-system, agency-web-developer
Strategia Social	Piano editoriale e content calendar	agency-social, agency-youtube, agency-visual-generator

---

Input — Questionario di Onboarding Cliente

Raccogliere queste informazioni prima di avviare il workflow end-to-end:

1. Informazioni Base Cliente

Campo	Tipo	Esempio	Note
Nome cliente/azienda	string	"Demo Co SRL"	Ragione sociale o nome progetto
Settore/Industry	string	"E-commerce fashion B2B"	Categoria principale
Sito web attuale	URL	https://democo.it	Se esiste, per analisi
Social esistenti	array	Instagram, LinkedIn	Piattaforme attive
Contatto principale	string	marco@democo.it	Email o telefono

2. Obiettivi e Aspettative

Campo	Tipo	Esempio	Note
Obiettivo primario	string	"Aumentare lead qualificati"	Cosa vuole ottenere
Obiettivi secondari	array	Brand awareness, SEO	Altri goal
Timeline attesa	string	"V1 entro 4 settimane"	Deadline o milestone
Budget indicativo	string	"€5-10K"	Range budget (opzionale)

3. Audience e Mercato

Campo	Tipo	Esempio	Note
Target primario	string	"Founder PMI 35-55 anni"	ICP principale
Target secondario	string	"PM B2B tech"	Audience secondaria
Competitor diretti	array	Competitor A, Competitor B	2-5 competitor
Differentiatori	array	"Servizio 24/7, prezzi chiari"	Punti di forza unici

4. Offerta e Servizi

Campo	Tipo	Esempio	Note
Servizi principali	array	Consulenza, Formazione, Supporto	Core offerings
Prodotti flagships	array	"Corso X, Tool Y"	Prodotti principali
Pricing model	string	"Subscription €99/mese"	Come monetizza

5. Preferenze e Vincoli

Campo	Tipo	Esempio	Note
Tone of voice	string	"Professionale ma amichevole"	Stile comunicazione
Brand colors	array	"#FF5733, #003366"	Colori brand (se noti)
Vincoli/Note	string	"No stock photo, solo foto reali"	Restrizioni o preferenze

6. Workflow e Agenti Richiesti

Campo	Tipo	Esempio	Note
Workflow da eseguire	string	Sito Web Aziendale, Strategia Social	Uno dei 5 workflow (vedi tabella sopra)
Agenti necessari	array	strategy, design, ux-copy, web-developer	Skills da attivare
Priorità	string	"Veloce" o "Dettagliato"	Approccio preferito

---

Processo

Fase 1: Setup Progetto e Avvio Workflow

Obiettivo: Creare struttura cartelle cliente e avviare workflow.

Azioni:

1. Proposta path cliente:

   • Proponi: clients/{nome_cliente_lowercase}/
   • Esempio: clients/demo_co_srl/
   • Chiedi conferma esplicita prima di procedere

2. Dopo conferma, crea struttura cartelle:

   clients/{client}/
   ├── knowledge/        (company profile, audience, brand)
   ├── research/         (competitor, market insights)
   ├── strategy/         (positioning, messaging, pillars)
   ├── design/           (design system, assets)
   ├── content/          (copy, social, video scripts)
   ├── ops/              (decisions, QA, run log)
   └── published/        (content pubblicato, versionato)
   

3. Leggi references/quality_bar.md per standard di qualità

4. Registra assunzioni in clients/{client}/ops/decisions.md

5. Avvia workflow selezionato coordinando gli agenti necessari

Regole:

• ✅ Non bloccare per input mancanti: fai assunzioni ragionevoli e documentale
• ✅ Tracciabilità: ogni decisione va 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 definizione degli obbiettivi chiara
   • 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 proposti

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/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)

---

References

• quality_bar.md — Standard V1
• publishing_gates.md — Gate pre-publish
• 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 alle priorità del progetto
• QA fallisce: Documenta issue in qa_notes.md e prosegui con fix

Limitazioni:

• Questa skill non esegue direttamente il lavoro degli agenti specialistici
• Richiede che gli altri agenti siano disponibili/eseguibili
• Publish richiede integrazione webhook configurata

---

Agency Skills Suite v1.0