Update agency-orchestrator: questionario onboarding + creazione cartella cliente

- Rielaborata sezione Input: trasformata in questionario di onboarding completo con 6 sezioni (info base, obiettivi, audience, offerta, preferenze, workflow)
- Aggiornata Fase 1: aggiunto step di proposta path cliente con richiesta conferma esplicita prima di creare cartelle
- Definita struttura cartelle standard: knowledge/, research/, strategy/, design/, content/, ops/, published/
- Rafforzate regole: non bloccare per input mancanti, V1 prima, tracciabilità decisioni
This commit is contained in:
AgentePotente 2026-03-09 18:36:28 +01:00
parent b916892ee5
commit 6ad0b7dfd2

View file

@ -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
---