6ac766172c
- 12 AgentSkills generate da agency_v3_1 framework - 17 references centralizzate - Script INSTALL.sh per installazione automatica - README.md con documentazione completa Skills incluse: - agency-orchestrator (coordinamento + QA) - agency-strategy (positioning, messaging) - agency-research (competitive intelligence) - agency-creative-director (direzione visiva) - agency-design-system (tokens, components) - agency-ux-copy (sitemap, copy) - agency-seo (SEO tecnico) - agency-social (social strategy) - agency-youtube (YouTube strategy) - agency-visual-generator (asset visuali) - agency-analytics (report KPI) - agency-publisher (publish gate-based) Generated by framework-translator v2.0 Approved by: MarcoB (2026-03-09)
166 lines
4.5 KiB
Markdown
166 lines
4.5 KiB
Markdown
---
|
|
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_
|