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

---

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

# 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 — 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 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