# Mapping Plan — orto_v1

**Status:** APPROVED (auto-approved per test)
**Data analisi:** 2026-03-07
**Approvato da:** AgentePotente (test automation)
**Data approvazione:** 2026-03-07

---

## Skills da Generare (9 totale)

| # | Nome Skill | Origine | Pattern | Giustificazione | References | Complessità |
|---|------------|---------|---------|-----------------|------------|-------------|
| 1 | orto-init | Workflow 00 + init_new_orto.py | Pattern 3 | Workflow operativo con script runtime | Nessuna | Bassa |
| 2 | orto-onboarding | Workflow 01 | Pattern 3 | Workflow raccolta dati questionario | Nessuna | Media |
| 3 | orto-agronomo | Agente 02 + Agente 07 | Pattern 2 | Overlap >50% (colture + nutrizione) | colture_it.md, stagionalita_it.md, rotazioni_it.md, consociazioni_it.md, fabbisogni_it.md | Media |
| 4 | orto-calendario | Agente 03 | Pattern 1 | Auto-contenuto (stagionalità + timeline) | stagionalita_it.md, calendario_it.md | Bassa |
| 5 | orto-fitopatologo | Agente 04 | Pattern 1 | Auto-contenuto (diagnosi + trattamenti) | diagnosi_it.md, trattamenti_bio_it.md, trattamenti_ipm_it.md | Media |
| 6 | orto-layout | Agente 06 | Pattern 1 | Auto-contenuto (aiuole + consociazioni) | consociazioni_it.md, layout_parametri_it.md | Media |
| 7 | orto-irrigazione | Agente 05 | Pattern 1 | Auto-contenuto (sistema + automazione) | irrigazione_zoning_it.md, irrigazione_scheduling_it.md | Media |
| 8 | orto-meteo-decisioni | Agente 11 + Workflow 05 | Pattern 4 | Meteo → decisioni irrigazione (coordinato con irrigazione) | meteo_analisi_it.md, meteo_decisioni_it.md, meteo_soglie_it.md | Media |
| 9 | orto-orchestratore | Agente 01 + Agente 10 (QA) | Pattern 2 + Pattern 6 | Coordinamento + QA assorbito | conflitti_risoluzione_it.md, qa_checklist_it.md | Alta |

**Skills eliminate/non incluse:**
- Agente 08 (Data Manager) → assorbito in orchestratore
- Agente 09 (UI/UX) → ELIMINATO (non essenziale per MVP testuale)
- Agente 12 (Ops) → ELIMINATO (integrazioni gestite da singole skills)

---

## References da Creare (12 totale)

| # | Nome File | Contenuto | Dimensione Stimata | Usato Da |
|---|-----------|-----------|-------------------|----------|
| 1 | colture_it.md | Catalogo ortaggi, famiglie botaniche, varietà, requisiti | 20 KB | orto-agronomo, orto-layout |
| 2 | stagionalita_it.md | Finestre semina/trapianto/raccolta per zona climatica | 15 KB | orto-agronomo, orto-calendario |
| 3 | rotazioni_it.md | Rotazioni colture, successioni, famiglie botaniche | 10 KB | orto-agronomo |
| 4 | consociazioni_it.md | Matrice consociazioni positive/negative, spacing | 12 KB | orto-agronomo, orto-layout |
| 5 | diagnosi_it.md | Sintomi, patogeni, probabilità diagnosi | 15 KB | orto-fitopatologo |
| 6 | trattamenti_bio_it.md | Trattamenti biologici, prodotti ammessi, safety | 18 KB | orto-fitopatologo |
| 7 | trattamenti_ipm_it.md | IPM, soglie intervento, rotazione principi attivi | 12 KB | orto-fitopatologo |
| 8 | irrigazione_zoning_it.md | Zone irrigue, fabbisogni idrici colture | 10 KB | orto-irrigazione, orto-layout |
| 9 | irrigazione_scheduling_it.md | Programmi irrigazione, runtime, stagionalità | 12 KB | orto-irrigazione |
| 10 | meteo_analisi_it.md | Analisi previsioni, vento, pioggia, allerte | 10 KB | orto-meteo-decisioni, orto-irrigazione |
| 11 | meteo_decisioni_it.md | Decisioni irrigazione basate meteo (irrigate/delay/skip) | 8 KB | orto-meteo-decisioni |
| 12 | fabbisogni_it.md | Fabbisogni alimentari comunità, mix colture | 15 KB | orto-agronomo |

**Reference aggiuntive (trasversali):**
- `conflitti_risoluzione_it.md` — Pattern risoluzione conflitti (orchestratore)
- `qa_checklist_it.md` — Checklist validazione PlanBundle (orchestratore)

---

## Decisioni di Mappatura

### 1. Merge Agronomo + Nutrizione (Pattern 2)

**Entità originali:**
- Agente 02: Agronomo Colture
- Agente 07: Nutrizione & Consumi

**Motivazione:**
- Overlap funzionale >50%: entrambi gestiscono selezione colture
- Nutrizione traduce fabbisogni → colture, ma Agronomo già seleziona colture
- Separazione artificiale: utente vuole "cosa piantare", non due skill separate

**Vantaggi:**
- UX semplificata: una skill per "piano colture"
- Knowledge condivisa (colture, stagionalità) centralizzata
- Meno context switching

**Rischi mitigati:**
- Skill più grande → references separate (colture, fabbisogni)

---

### 2. Assorbimento QA in Orchestratore (Pattern 6)

**Entità originali:**
- Agente 01: Orchestratore/Planner
- Agente 10: QA & Safety Agent

**Motivazione:**
- QA è parte naturale dell'orchestrazione (merge + validazione)
- Separare richiederebbe due step (genera → valida) invece di uno integrato
- QA context-aware: orchestratore conosce tutto il PlanBundle

**Implementazione:**
- orto-orchestratore include sezione "Validazione QA"
- Reference `qa_checklist_it.md` consultata durante orchestrazione

---

### 3. Eliminazione UI/UX Agent (Pattern 5)

**Entità originale:**
- Agente 09: UI/UX Agent

**Motivazione:**
- UI/UX non essenziale per MVP testuale (AgentSkills sono CLI/chat-based)
- Wireframe e componenti UI sono documentazione, non automazione eseguibile
- Skill AgentSkills focalizzate su automazione, non generazione UI

**Funzionalità perse:**
- Wireframe generation
- Componenti UI specs

**Recupero futuro:**
- Skill separata "ui-generator" in v2 (se necessario)
- Per ora: documentazione UI rimane in `docs/gui/` del framework

---

### 4. Eliminazione Ops & Integrazioni (Pattern 5)

**Entità originale:**
- Agente 12: Ops & Integrazioni

**Motivazione:**
- Connettori (meteo, sensori, notifiche) gestiti da singole skills
- Export (iCal, CSV, PDF) sono feature opzionali, non core
- Eliminare semplifica senza perdere valore per MVP

**Funzionalità perse:**
- Connettori centralizzati
- Export formati multipli

**Recupero:**
- Ogni skill gestisce le proprie integrazioni specifiche
- Export: feature futura se richiesta

---

### 5. Separazione Meteo → Skill Dedicata

**Entità originali:**
- Agente 11: Weather Intelligence
- Workflow 05: Irrigazione Dinamica Meteo

**Motivazione:**
- Meteo è trasversale (usato da irrigazione, fitopatologo, calendario)
- Decisioni meteo-aware sono critiche (vento, pioggia, gelo)
- Separare permette riuso: orto-meteo-decisioni consultata da multiple skills

**Coordinamento:**
- orto-irrigazione consulta orto-meteo-decisioni per decisioni irrigazione
- orto-fitopatologo consulta per trattamenti (no vento/pioggia)

---

## Riepilogo

- **Skills:** 9 (da 12 agenti + 6 workflow originali)
- **References:** 12 (+ 2 trasversali)
- **Eliminati/Assorbiti:** 4 entità (08, 09, 10, 12)
- **Complessità stimata:** HIGH (9 skills, 14 references, dominio ortofrutticolo completo)

---

## Approvazione

- **Approvato da:** AgentePotente (test automation)
- **Data:** 2026-03-07
- **Note:** Mappatura approvata per test su orto_v1. Procedere con Fase 3 (estrazione knowledge).

---

_Fine piano — Pronto per Fase 3 (Estrazione Knowledge)_