221 lines
7.9 KiB
Markdown
221 lines
7.9 KiB
Markdown
---
|
|
name: agency-orchestrator
|
|
description: "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](../../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
|
|
|
|
---
|
|
|
|
_Agency Skills Suite v1.0_
|