diff --git a/agency-analytics/SKILL.md b/agency-analytics/SKILL.md index 82c59bf..5ace133 100644 --- a/agency-analytics/SKILL.md +++ b/agency-analytics/SKILL.md @@ -180,11 +180,10 @@ Report KPI settimanali e azioni misurabili per social e YouTube. 1. Usa template da `references/weekly_report_template.md` 2. Compila tutte le sezioni 3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md` -4. Aggiorna backlog se azioni richiedono task +4. Documenta azioni nel run log del progetto se richiedono follow-up **Output:** - `clients/{client}/analytics/weekly_reports/YYYY-WW.md` -- Update suggerito a `clients/{client}/ops/backlog.md` --- @@ -193,7 +192,7 @@ Report KPI settimanali e azioni misurabili per social e YouTube. | File | Formato | Descrizione | |------|---------|-------------| | `clients/{client}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale | -| `clients/{client}/ops/backlog.md` | Markdown | Update con actions (se necessario) | +| `clients/{client}/ops/run_log.md` | Markdown | Azioni e follow-up (se necessario) | --- diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index 1ff1ffb..69214f4 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -1,17 +1,17 @@ --- 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. +description: Coordinare agenti, gestire decisioni e qualità per workflow multi-agente. Usare quando: (1) avviare nuovo progetto/cliente, (2) coordinare output di più agenti, (3) gestire decisioni, (4) eseguire QA trasversale. Output: Decision log, QA notes, stato progetto. --- # Agency Orchestrator — Coordinamento Multi-Agente -Coordina agenti e mantiene stato (backlog/decisioni/QA) per arrivare a V1 rapidamente e iterare. +Coordina agenti e mantiene stato (decisioni/QA) per eseguire workflow in modo efficiente. ## Quando Usare -- **Nuovo progetto:** Avviare onboarding cliente e definire MVP +- **Nuovo progetto:** Avviare onboarding cliente e definire workflow - **Coordinamento:** Consolidare output di più agenti (strategy, design, content) -- **Backlog management:** Prioritizzare task P0/P1/P2 +- **Gestione progetto:** Monitorare avanzamento workflow - **QA trasversale:** Verificare qualità deliverable prima di publish --- @@ -70,15 +70,15 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: |-------|------|---------|------| | **Workflow da eseguire** | string | `20_website`, `30_social_launch` | ID workflow (vedi README) | | **Agenti necessari** | array | strategy, design, ux-copy, web-developer | Skills da attivare | -| **Priorità** | string | "MVP veloce" o "Qualità massima" | Approccio preferito | +| **Priorità** | string | "Veloce" o "Dettagliato" | Approccio preferito | --- ## Processo -### Fase 1: Setup Progetto e Definizione MVP +### Fase 1: Setup Progetto e Avvio Workflow -**Obiettivo:** Creare struttura cartelle cliente e chiarire output minimi. +**Obiettivo:** Creare struttura cartelle cliente e avviare workflow. **Azioni:** @@ -95,23 +95,18 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: ├── strategy/ (positioning, messaging, pillars) ├── design/ (design system, assets) ├── content/ (copy, social, video scripts) - ├── ops/ (backlog, decisions, QA, run log) + ├── ops/ (decisions, QA, run log) └── published/ (content pubblicato, versionato) ``` -3. **Leggi `references/quality_bar.md`** per standard V1 +3. **Leggi `references/quality_bar.md`** per standard di qualità -4. **Definisci output MVP (P0) vs Next (P1/P2):** - - Basandoti su obiettivi cliente e workflow selezionato - - Prioritizza: V1 funzionante > perfezione +4. **Registra assunzioni in `clients/{client}/ops/decisions.md`** -5. **Crea `clients/{client}/ops/backlog.md`** con task prioritizzati - -6. **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 -- ✅ **V1 prima:** MVP funzionale > features incomplete - ✅ **Tracciabilità:** ogni decisione va nel decision log - ✅ **Conferma path:** sempre chiedere OK prima di creare cartelle @@ -151,8 +146,7 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: 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 +4. Crea `clients/{client}/ops/qa_notes.md` con issue + fix proposti **QA Checklist:** - [ ] Output in path corretto @@ -181,34 +175,12 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: | 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 @@ -222,8 +194,8 @@ Raccogliere queste informazioni prima di avviare il workflow end-to-end: **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 +- **Conflitti tra agenti:** Orchestratore decide in base alle priorità del progetto +- **QA fallisce:** Documenta issue in qa_notes.md e prosegui con fix **Limitazioni:**