Initial release: agency_v3_1-skills-suite v1.0
- 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)
This commit is contained in:
commit
6ac766172c
47 changed files with 4165 additions and 0 deletions
166
agency-orchestrator/SKILL.md
Normal file
166
agency-orchestrator/SKILL.md
Normal file
|
|
@ -0,0 +1,166 @@
|
|||
---
|
||||
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_
|
||||
1
agency-orchestrator/references
Symbolic link
1
agency-orchestrator/references
Symbolic link
|
|
@ -0,0 +1 @@
|
|||
../references
|
||||
Loading…
Add table
Add a link
Reference in a new issue