---
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_