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

---
name: agency-orchestrator
description: Coordinare agenti, gestire decisioni e qualità per workflow multi-agente. Usare quando: (1) avviare nuovo progetto/cliente, (2) coordinare output di più agenti, (3) gestire decisioni, (4) eseguire QA trasversale. Output: Decision log, QA notes, stato progetto.
---

# Agency Orchestrator — Coordinamento Multi-Agente

Coordina agenti e mantiene stato (decisioni/QA) per eseguire workflow 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

---

## 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 | `20_website`, `30_social_launch` | ID workflow (vedi README) |
| **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
- ✅ **Conferma path:** sempre chiedere OK prima di creare cartelle

---

### 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 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](../../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 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

---

_Skill generata da framework-translator_