diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index 9a24a7d..1ff1ffb 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -16,34 +16,104 @@ Coordina agenti e mantiene stato (backlog/decisioni/QA) per arrivare a V1 rapida --- -## Input +## Input — Questionario di Onboarding Cliente -| 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 | +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 | `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 | --- ## Processo -### Fase 1: Definizione MVP e Backlog +### Fase 1: Setup Progetto e Definizione MVP -**Obiettivo:** Chiarire output minimi e prioritizzare. +**Obiettivo:** Creare struttura cartelle cliente e chiarire output minimi. **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` +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/ (backlog, decisions, QA, run log) + └── published/ (content pubblicato, versionato) + ``` + +3. **Leggi `references/quality_bar.md`** per standard V1 + +4. **Definisci output MVP (P0) vs Next (P1/P2):** + - Basandoti su obiettivi cliente e workflow selezionato + - Prioritizza: V1 funzionante > perfezione + +5. **Crea `clients/{client}/ops/backlog.md`** con task prioritizzati + +6. **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 +- ✅ **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 ---