5d8df80271
- scan_results.txt: Scansione framework (54 markdown, 5 script, 12 agenti) - analysis_report.md: Analisi semantica completa (Fase 1) - mapping_plan.md: Mappatura approvata (Fase 2) Risultati: - 9 skills proposte (da 12 agenti + 6 workflow) - 12 references + 2 trasversali - 4 entità eliminate/assorbite (UI/UX, Ops, Data Manager, QA assorbito) Decisioni chiave: - Merge Agronomo + Nutrizione (overlap >50%) - QA assorbito in Orchestratore - Meteo → skill dedicata (trasversale) - UI/UX eliminato (non MVP testuale)
168 lines
6.8 KiB
Markdown
168 lines
6.8 KiB
Markdown
# 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)_
|