orto-skills/SKILL_DEVELOPMENT_PLAN.md

Orto Skills Development Plan

Start Date: 2026-03-06
Status: Fase 1 in Progress
Target: 9 skill packaggiati, testati, ready to distribution

---

Skill Development Queue

Sprint 1: Foundation Skills (Giorni 1-2)

[1] orto-init ⏱️ Starting

Purpose: Initialize new garden project
Source: Workflow 00 + init_new_orto.py script
Status: Reading sources
Complexity: Medium (scaffolding + registration)

Deliverables:

• SKILL.md drafted
• References collected
• Scripts bundled
• Test case: init test garden

---

[2] orto-onboarding ⏱️ Queued

Purpose: Collect garden profile via 5 questionnaire blocks
Source: Workflow 01 + allegati/A_questionario_utente.md
Complexity: Medium (validation + guidance)

Deliverables:

• SKILL.md with 5-block flow
• References: blocco templates + validation rules
• Test case: complete onboarding flow

---

Sprint 2: Decision Logic Skills (Giorni 2-3)

[3] orto-agronomo ⏱️ Queued

Purpose: Plan crop selection + rotations
Source: Agent 02 spec + knowledge base
Complexity: High (decision tree + consociations)

Deliverables:

• SKILL.md with selection logic
• References: colture_it.md (varieties, parameters, consociations)
• References: rotazione_regole.md
• Test case: select crops for 3 scenarios

---

[4] orto-calendario ⏱️ Queued

Purpose: Generate seasonal calendar (IT-regional)
Source: Agent 03 spec + clima zones
Complexity: High (frost dates, succession, meteo-sensitivity)

Deliverables:

• SKILL.md with calendar logic
• References: calendario_it.md (frost dates per region, planting windows)
• References: task_templates.md (metadata, meteo-tags)
• Test case: calendar for Nord/Centro/Sud region

---

[5] orto-irrigazione ⏱️ Queued

Purpose: Design irrigation zones + automation
Source: Agent 05 spec + Workflow 05
Complexity: High (multi-zone, sensors, meteo-aware)

Deliverables:

• SKILL.md with zoning + baseline logic
• References: irrigazione_parametri.md (ET, Kc, thresholds)
• References: sensori_configurazione.md
• Test case: design 3-zone system

---

Sprint 3: Analysis & Integration Skills (Giorni 3-4)

[6] orto-meteo-decisioni ⏱️ Queued

Purpose: Weather → operational decisions
Source: Agent 11 spec + Weather decision logic
Complexity: Medium (API integration + thresholds)

Deliverables:

• SKILL.md with decision tree
• References: meteo_soglie.md (wind, rain, frost, heat thresholds)
• Test case: apply meteo decisions to calendar

---

[7] orto-fitopatologo ⏱️ Queued

Purpose: Diagnose diseases + recommend treatments
Source: Agent 04 spec + treatment library
Complexity: High (diagnostic tree + safety checks)

Deliverables:

• SKILL.md with diagnostic flow
• References: malattie_sintomi.md (symptoms → pathogen)
• References: trattamenti_biologici.md (treatments, DPI, timing, efficacy)
• Test case: diagnose 3 common problems

---

[8] orto-layout ⏱️ Queued

Purpose: Design beds + consociations
Source: Agent 06 spec
Complexity: Medium-High (geometric + agronomic)

Deliverables:

• SKILL.md with bed layout logic
• References: layout_consociazioni.md (consociation matrix, bed sizing)
• References: accessibilita_guidelines.md
• Test case: design 2 different layouts

---

Sprint 4: Orchestration (Giorno 4)

[9] orto-orchestratore ⏱️ Queued

Purpose: Coordinate all skills + resolve conflicts
Source: Agent 01 spec + Orchestration rules
Complexity: Very High (conflict resolution + validation)

Deliverables:

• SKILL.md with orchestration flow
• References: conflitti_risoluzione.md (conflict matrix + policies)
• References: qa_checklist.md (validation rules)
• Test case: full planning pipeline init → onboarding → skills → merge

---

Shared References Library

Location: /home/noe/.openclaw/workspace/orto-skills/references/

These are shared across multiple skills. Extract once, reuse everywhere.

Knowledge Base Files (To Extract)

• colture_it.md (500+ lines)

  • Varietà coltivabili in IT
  • Cicli colturali, esigenze idriche, nutrienti, spaziatura
  • Famiglie botaniche (per rotazione)
  • Rese indicative (min/typ/max)
  • Esempi consociazioni

• calendario_it.md (200+ lines)

  • Frost dates per region (Nord: 25 aprile, Centro: 15 aprile, Sud: 1 aprile)
  • Seasonal windows per coltura
  • Length of season per macro-zone
  • Succession windows (es: lattuga primavera, successiva estate se semenzaio agostano)

• malattie_trattamenti.md (300+ lines)

  • Symptom → pathogen mapping
  • Biological treatments (neem oil, sulfur, copper, beneficial insects, etc.)
  • DPI required, timing, efficacy %
  • Safety interlocks (wind, rain, harvest carency)

• irrigazione_parametri.md (200+ lines)

  • ET0 formulas / lookup tables
  • Kc per coltura e fase
  • Water need classes (basso, medio, alto)
  • Sensor thresholds (umidità suolo min/max %)
  • Baseline watering schedules per metodo (goccia, spruzzatore, sommersione)

• consociazioni_layout.md (200+ lines)

  • Companion planting matrix (positive/negative combinations)
  • Bed sizing recommendations (larghezza, lunghezza, profondità)
  • Row spacing, plant spacing per coltura
  • Pathway width (accessibilità)
  • Sun exposure requirements (full sun, partial, shade)

• meteo_soglie.md (100+ lines)

  • Wind speed thresholds (no spray if > 5kn, transplant risky > 8kn)
  • Rain thresholds (skip watering if rain > 10mm in 24h forecast)
  • Frost alerts (temperature < 0°C for frost-sensitive crops)
  • Heat stress (temperature > 35°C, increase irrigation)

• conflitti_risoluzione.md (150+ lines)

  • Irrigation zone vs. consociations → prioritize water stress avoidance
  • Calendar task vs. weather → defer if risky conditions
  • Layout vs. irrigation zone → regrid if mismatch
  • etc. (conflict resolution policies)

• qa_checklist.md (100+ lines)

  • Validation rules for PlanBundle
  • Min crop diversity (% of nutritional groups)
  • Water adequacy (total availability vs. plan demand)
  • Nutrient balance (NPK coverage)
  • Crop rotation conflicts
  • etc.

---

Development Environment Setup

Directory Structure

orto-skills/
├── SKILL_DEVELOPMENT_PLAN.md           # This file
├── references/                         # Shared knowledge base
│   ├── colture_it.md
│   ├── calendario_it.md
│   ├── malattie_trattamenti.md
│   ├── irrigazione_parametri.md
│   ├── consociazioni_layout.md
│   ├── meteo_soglie.md
│   ├── conflitti_risoluzione.md
│   └── qa_checklist.md
├── scripts/
│   ├── init_new_orto_bundled.sh        # Bundled from framework
│   └── test_framework_extraction.py
├── build/
│   ├── orto-init/                      # Skill folder (will be packaged)
│   │   ├── SKILL.md
│   │   ├── references/
│   │   ├── scripts/
│   │   └── assets/
│   ├── orto-onboarding/
│   ├── ...
│   └── orto-orchestratore/
└── test/
    └── integration_tests.md

---

Extraction & Normalization Tasks

Fase 1 (TODAY): Extract knowledge base from framework

• Parse docs/agents/02_agronomo_colture.md → colture_it.md
• Parse docs/agents/03_stagionalita_calendario.md → calendario_it.md
• Parse docs/agents/04_fitopatologo_trattamenti.md → malattie_trattamenti.md
• Parse docs/agents/05_irrigazione_automazione.md → irrigazione_parametri.md
• Parse docs/agents/06_layout_zoning.md → consociazioni_layout.md
• Parse docs/agents/11_weather_intelligence_agent.md → meteo_soglie.md
• Parse docs/agents/01_orchestratore_planner.md + docs/workflows/ → conflitti_risoluzione.md
• Parse docs/agents/10_qa_safety_agent.md → qa_checklist.md

---

Testing Strategy

Unit Tests (Per Skill)

• Input examples from framework docs
• Validate output schema matches spec
• Check edge cases & fallbacks

Integration Test

• Full pipeline: init → onboarding → {agronomo, calendario, irrigazione} → orchestratore → merge
• Validate conflicts resolved correctly
• Check PlanBundle completeness

Smoke Test (One Garden)

• Real initialization of test garden
• Verify markdown files created and readable
• Confirm no blocking errors

---

Milestones & Timeline

Milestone	Target	Status
Fase 1 Complete (Prep + Refs)	EOD Today	⏱️ In Progress
Skill #1-2 Drafted	EOD Tomorrow	⏱️ Queued
Skill #3-5 Drafted	Day 3	⏱️ Queued
Skill #6-9 Drafted	Day 4	⏱️ Queued
All Skills Tested	Day 5	⏱️ Queued
Packaging + Distribution	Day 6	⏱️ Queued

---

Notes

• Maintain Italian language throughout (domain-local, as decided)
• Each skill SKILL.md < 500 lines (enforce progressive disclosure)
• References are shared; extract once, link many times
• Scripts bundled in skill, not external
• All outputs are markdown (readable, editable, versionable)