diff --git a/build/orto-orchestratore/SKILL.md b/build/orto-orchestratore/SKILL.md index 21ecb38..b5034d1 100644 --- a/build/orto-orchestratore/SKILL.md +++ b/build/orto-orchestratore/SKILL.md @@ -14,6 +14,82 @@ Coordinare tutti skill planning, risolvere conflitti, validare vincoli, merge in - **Risoluzione conflitti:** Quando skill producono raccomandazioni conflittuali - **Revisione piano:** Validazione QA prima di publicare piano a utente +## Gestione Progetti & Registry + +### Struttura File Progetti + +Ogni orto gestito è organizzato in struttura standardizzata: + +``` +/home//.openclaw/workspace/Orti/ +├── orti_registry.json # Registry centrale (JSON) +└── orto_PROVINCIA_LOCALITA_NNN/ # Cartella progetto + ├── README.md + ├── config/ # Config statiche + │ ├── garden_config.md + │ └── ambiente_vincoli.md + ├── dati/ # Dati operazionali + │ ├── questionario/ + │ ├── calendario/ + │ ├── layout/ + │ ├── irrigazione/ + │ ├── meteo/ + │ ├── colture/ + │ ├── nutrizione/ + │ ├── trattamenti/ + │ └── raccolti/ + ├── log/ # Log e audit + │ ├── audit_trail.md + │ └── note_osservazioni.md + ├── media/ # Foto, video + │ ├── foto/ + │ └── video/ + └── report/ # Report generati +``` + +### Registry Centrale + +**File:** `/home//.openclaw/workspace/Orti/orti_registry.json` + +Mantiene indice tutti orti: + +```json +{ + "orti": [ + { + "orto_id": "orto_roma_testaccio_001", + "name": "Orto Testaccio Roma", + "provincia": "Roma", + "regione": "Lazio", + "latitude": 41.8782, + "longitude": 12.4922, + "zone": "centro", + "created_at": "2026-03-06T23:18:00Z", + "status": "active", + "path": "/home/noe/.openclaw/workspace/Orti/orto_roma_testaccio_001" + } + ] +} +``` + +### Funzioni Orchestrator su Progetti + +**Lettura:** +- Carica registry +- Locate progetto orto +- Legge tutti file dati/ per orchestration + +**Scrittura:** +- Aggiorna file dati/ (piano_colture_annuale, calendario, etc.) +- Aggiorna audit_trail.md con evento orchestration +- NO modifica registry (orto-init responsabile) + +**Validazione:** +- Verifica tutti prerequisito skill hanno completato (file exist) +- Check integrità dati (no corrupted markdown) + +--- + ## Processo ### Fase 1: Checklist Pre-Volo @@ -362,6 +438,34 @@ Se qualcosa non è chiaro, contatta l'agronomo. Buon orto! 🌱 --- +## Audit Trail & Project Updates + +**Ad ogni orchestration (pianificazione completa o weekly update), registrare:** + +**File:** `log/audit_trail.md` (append entry) + +```markdown +## Evento: Orchestration — PlanBundle Merge + +| Campo | Valore | +|-------|-------| +| **Timestamp** | [TODAY_ISO] | +| **Evento** | orchestratore_merge_plan | +| **Tipo** | Full Planning / Weekly Briefing | +| **Status** | success / warning / error | +| **Orto ID** | [ORTO_ID] | +| **Coordinatore** | Codex (skill: orto-orchestratore) | +| **QA Score** | 0.92 (Excellent) | +| **Conflitti Risolti** | 2 (Irrigazione zone, Calendar task) | +| **Raccomandazioni** | Mulching per deficit acqua 15% | +| **Output Files** | dati/PlanBundle_Master.md, dati/calendario/calendario_operativo_settimanale.md | +| **Dettagli** | Orchestration completa: init→onboarding→agronomo→layout→irrigazione→meteo→merge. PlanBundle generato e validato QA. User notificato. | +``` + +Questo crea cronologia completa di ogni decisione orchestrator per tracciabilità e debugging. + +--- + ## Gestione Errori | Errore | Fallback |