# Analysis Report — orto_v1

## Panoramica

- **Framework:** orto_v1
- **Percorso:** `/home/noe/.openclaw/workspace/frameworks/orto_v1`
- **Lingua rilevata:** Italian
- **Dominio stimato:** Orto / Giardinaggio
- **Data analisi:** 2026-03-07

---

## Struttura Identificata

### Cartelle Chiave

| Tipo | Percorso | Note |
|------|----------|------|
| Agenti | `docs/agents/` | 12 file agente (00-12) |
| Workflow | `docs/workflows/` | 6 file (index + 5 workflow) |
| Knowledge | `docs/knowledge/` | 1 file base + knowledge implicita in agents |
| Scripts | `scripts/` | 5 script (2 Python, 1 Bash, 2 template) |
| Prompts | `prompts/` | 4 file prompt |
| Skills | `docs/skills/` | Catalogo 17 skills |
| GUI | `docs/gui/` | 5 file (sitemap, wireframe, componenti) |
| Schemas | `docs/schemas/` | 5 schema markdown |

---

## Agenti Identificati (12 totale)

| # | ID | Nome | Missione (breve) | Priorità | Overlap Note |
|---|----|------|------------------|----------|--------------|
| 1 | agent_01 | Orchestratore/Planner | Coordina agenti, merge risultati, QA/Safety | MUST | Coordinamento trasversale |
| 2 | agent_02 | Agronomo Colture | Selezione ortaggi, parametri colturali | MUST | Overlap con Nutrizione (colture) |
| 3 | agent_03 | Stagionalità & Calendario | Timeline semina-raccolta, successioni | MUST | Overlap con Agronomo (stagionalità) |
| 4 | agent_04 | Fitopatologo & Trattamenti | Prevenzione, diagnosi, trattamenti bio | MUST | - |
| 5 | agent_05 | Irrigazione & Automazione | Sistema irrigazione, sensori, controller | MUST | Overlap con Meteo (decisioni irrigazione) |
| 6 | agent_06 | Layout & Zoning | Aiuole, consociazioni, accessibilità | MUST | Overlap con Agronomo (consociazioni) |
| 7 | agent_07 | Nutrizione & Consumi | Stima fabbisogni, mix colture | SHOULD | Overlap forte con Agronomo |
| 8 | agent_08 | Data/Knowledge Manager | Validazione dati, normalizzazione | LOW | Assorbibile in Orchestratore |
| 9 | agent_09 | UI/UX Agent | Wireframe, componenti UI | LOW | Eliminato (non essenziale per MVP testuale) |
| 10 | agent_10 | QA & Safety Agent | Validazione requisiti, risk | SHOULD | Assorbibile in Orchestratore |
| 11 | agent_11 | Weather Intelligence | Meteo → decisioni irrigazione | MUST | Overlap con Irrigazione |
| 12 | agent_12 | Ops & Integrazioni | Connettori, notifiche, export | LOW | Eliminato (integrazioni gestite da singole skills) |

---

## Workflow Identificati (5 totale)

| # | ID | Nome | Trigger | Agenti Coinvolti | Output |
|---|----|------|---------|------------------|--------|
| 1 | wf_00 | Init Orto | Nuovo progetto | Orchestratore | Struttura directory, registry |
| 2 | wf_01 | Onboarding | Utente nuovo | Orchestratore, UI | 5 blocchi questionario, GardenConfig |
| 3 | wf_02 | Piano Stagionale | Stagionale (inizio ciclo) | Agronomo, Calendario, Layout | PlanBundle (colture, layout, irrigazione) |
| 4 | wf_03 | Esecuzione Settimanale | Settimanale | Calendario, Meteo, Irrigazione | Task list settimanale |
| 5 | wf_04 | Diagnosi Problemi | Segnalazione utente | Fitopatologo, Meteo | Diagnosi + trattamenti |
| 6 | wf_05 | Irrigazione Dinamica | Giornaliero/sensori | Irrigazione, Meteo | Decisione irrigazione (irrigate/delay/skip) |

**Nota:** Workflow 00 (Init) non è nella lista index ma è descritto in `docs/workflows/00_init_orto.md`.

---

## Knowledge Base (17 skills catalogate)

### Skills dal Catalogo (docs/skills/01_skill_catalog.md)

| # | Skill ID | Argomento | Dimensione Stimata | Usato Da | Raccomandazione |
|---|----------|-----------|-------------------|----------|-----------------|
| 1 | AGR-CROP-KB | Catalogo ortaggi, famiglie, varietà | 20 KB | Agronomo, Layout | REFERENCE |
| 2 | AGR-SEASONALITY | Stagionalità, finestre semina | 15 KB | Agronomo, Calendario | REFERENCE |
| 3 | AGR-ROTATION | Rotazioni, successioni | 10 KB | Agronomo | REFERENCE |
| 4 | AGR-COMPANION | Consociazioni, antagonismi | 12 KB | Agronomo, Layout | REFERENCE |
| 5 | PHYTO-DIAG | Diagnosi sintomi | 15 KB | Fitopatologo | REFERENCE |
| 6 | PHYTO-TREAT-BIO | Trattamenti biologici | 18 KB | Fitopatologo | REFERENCE |
| 7 | PHYTO-TREAT-IPM | IPM, soglie intervento | 12 KB | Fitopatologo | REFERENCE |
| 8 | IRR-ZONING | Zone irrigue, fabbisogni | 10 KB | Irrigazione, Layout | REFERENCE |
| 9 | IRR-SCHEDULING | Piano irrigazione | 12 KB | Irrigazione | REFERENCE |
| 10 | IRR-CONTROL | Attuatori, safety | 8 KB | Irrigazione | INLINE |
| 11 | MET-FORECAST-ANALYSIS | Analisi meteo, allerte | 10 KB | Meteo, Irrigazione | REFERENCE |
| 12 | MET-IRR-DECISION | Decisione irrigazione | 8 KB | Meteo, Irrigazione | REFERENCE |
| 13 | NUT-DEMAND-MODEL | Fabbisogni alimentari | 10 KB | Nutrizione | REFERENCE |
| 14 | NUT-CROP-MIX | Mix colture da domanda | 8 KB | Nutrizione, Agronomo | REFERENCE |
| 15 | UI-WIREFRAME | Wireframe, componenti | 20 KB | UI/UX | ELIMINATO (non MVP) |
| 16 | QA-CONSISTENCY | Controlli coerenza | 12 KB | QA, Orchestratore | REFERENCE |
| 17 | OPS-INTEGRATIONS | Connettori, export | 10 KB | Ops | INLINE/ELIMINATO |

**Totale Knowledge:** ~200 KB stimati

---

## Scripts Valutati (5 totale)

| # | Script | Scopo | Dimensione | Raccomandazione | Motivo |
|---|--------|-------|------------|-----------------|--------|
| 1 | init_new_orto.py | Crea nuovo progetto orto | 20 KB | INCLUDE | Runtime, crea struttura directory + registry |
| 2 | init_orto.sh | Shell script init (alternativo) | 2 KB | ELIMINA | Ridondante con Python version |
| 3 | json_to_md_converter.py | Migrazione JSON → Markdown | 3 KB | ELIMINA | One-time migration, non runtime |
| 4 | register_orto.py | Registra orto in registry | 2 KB | INLINE | Semplice, integrabile in orto-init |
| 5 | sync_md_from_agents.py | Validazione e sync markdown | 5 KB | ELIMINA | QA tool, non runtime |

---

## Metriche e Complessità

- **Totale agenti:** 12
- **Totale workflow:** 6 (incluso Init)
- **Totale knowledge/skills:** 17 (~200 KB)
- **Totale scripts:** 5 (1 da includere)
- **Complessità stimata:** HIGH (>25 entità totali)

---

## Raccomandazioni Iniziali

### Skills Stimate: 8-10

Basate su analisi agenti + workflow:

1. **orto-init** — Da Workflow 00 + init_new_orto.py
2. **orto-onboarding** — Da Workflow 01
3. **orto-agronomo** — Da Agente 02 + Agente 07 (Nutrizione assorbito)
4. **orto-calendario** — Da Agente 03 (Stagionalità)
5. **orto-fitopatologo** — Da Agente 04
6. **orto-layout** — Da Agente 06
7. **orto-irrigazione** — Da Agente 05 + Agente 11 (Meteo assorbito)
8. **orto-meteo-decisioni** — Da Workflow 05 (separato per chiarezza)
9. **orto-orchestratore** — Da Agente 01 + Agente 10 (QA assorbito)

**Eliminati:**
- Agente 08 (Data Manager) → assorbito in orchestratore
- Agente 09 (UI/UX) → eliminato (non MVP testuale)
- Agente 12 (Ops) → eliminato (integrazioni gestite da singole skills)

### References Stimate: 10-12

Dal catalogo skills, escludendo UI e Ops:

1. `colture_it.md` — AGR-CROP-KB
2. `stagionalita_it.md` — AGR-SEASONALITY
3. `rotazioni_it.md` — AGR-ROTATION
4. `consociazioni_it.md` — AGR-COMPANION
5. `diagnosi_it.md` — PHYTO-DIAG
6. `trattamenti_bio_it.md` — PHYTO-TREAT-BIO
7. `trattamenti_ipm_it.md` — PHYTO-TREAT-IPM
8. `irrigazione_zoning_it.md` — IRR-ZONING
9. `irrigazione_scheduling_it.md` — IRR-SCHEDULING
10. `meteo_analisi_it.md` — MET-FORECAST-ANALYSIS
11. `meteo_decisioni_it.md` — MET-IRR-DECISION
12. `fabbisogni_it.md` — NUT-DEMAND-MODEL + NUT-CROP-MIX (merge)

### Note

- **Overlap significativo:** Agronomo + Nutrizione (merge consigliato)
- **Overlap significativo:** Irrigazione + Meteo (separare ma coordinare)
- **Orchestratore chiaro:** Agente 01 con ruolo di coordinamento esplicito
- **Knowledge ben strutturata:** Catalogo skills esistente facilita estrazione

---

_Fine report — Pronto per Fase 2 (Mappatura)_