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)
6.8 KiB
6.8 KiB
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.mdconsultata 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)