# AGENTS.md — Istruzioni Installazione

**Per agenti LLM che ricevono framework-translator e devono installarlo.**

---

## 🎯 Tuo Compito

L'utente ti ha chiesto di installare `framework-translator` nel tuo workspace OpenClaw.

Segui questi step **in ordine**. Non saltare passaggi.

---

## 📋 Checklist Installazione

### Step 1: Verifica Pacchetto

```bash
# Se hai ricevuto uno zip:
unzip -l framework-translator.zip | head -20

# Se hai ricevuto una cartella:
ls -la framework-translator/
```

**Cosa cercare:**
- [ ] `SKILL.md` (file principale)
- [ ] `scripts/` (cartella con script bash)
- [ ] `test/` (cartella con test)
- [ ] `README.md` (documentazione)

Se mancano file critici → **Ferma installazione e notifica utente**

---

### Step 2: Sposta in Workspace

```bash
# Determina percorso workspace OpenClaw
WORKSPACE="$HOME/.openclaw/workspace"

# Verifica esistenza
if [ ! -d "$WORKSPACE" ]; then
    echo "❌ Workspace non trovato: $WORKSPACE"
    echo "Chiedi all'utente: 'Dov'è il tuo workspace OpenClaw?'"
    exit 1
fi

# Sposta framework-translator
if [ -d "framework-translator" ]; then
    mv framework-translator "$WORKSPACE/"
    echo "✅ Spostato in: $WORKSPACE/framework-translator"
elif [ -f "framework-translator.zip" ]; then
    unzip framework-translator.zip -d "$WORKSPACE/"
    rm framework-translator.zip
    echo "✅ Estratto in: $WORKSPACE/framework-translator"
fi
```

---

### Step 3: Verifica Installazione

```bash
cd "$WORKSPACE/framework-translator"

# Verifica struttura
echo "=== Struttura ==="
ls -la

echo ""
echo "=== Script ==="
ls -la scripts/

echo ""
echo "=== Test ==="
ls -la test/

# Verifica permessi script
chmod +x scripts/*.sh
```

**Output atteso:**
```
README.md
SKILL.md
AGENTS.md
RELEASE.md
scripts/
test/
...
```

Se output diverso → **Notifica utente**

---

### Step 4: Leggi SKILL.md

```bash
# Leggi prime 50 righe per capire scopo
head -50 SKILL.md
```

**Cosa capire:**
- Scopo: Trasformare framework in AgentSkills
- Input: Percorso framework testuale
- Output: Suite di skills in `test/<framework>/`

---

### Step 5: Conferma all'Utente

**Messaggio tipo:**

```
✅ framework-translator installato con successo!

**Percorso:** ~/.openclaw/workspace/framework-translator

**Cosa include:**
- SKILL.md (istruzioni per trasformare framework)
- scripts/ (3 script bash per packaging)
- test/ (test orto_v1 → orto-skills v0.2-test)
- Documentazione (README, RELEASE, AGENTS)

**Come usare:**
"Esegui framework-translator su /path/to/framework"

Seguirò SKILL.md per:
1. Analizzare framework
2. Proporre mappatura (tua approvazione)
3. Estrarre knowledge → references
4. Generare AgentSkills
5. Creare pacchetto installabile

**Primo test consigliato:**
- Framework: Qualsiasi framework multi-agente
- Output: test/<framework>/ con skills + references
```

---

## 🚨 Gestione Errori

### Errore: Workspace non trovato

```
❌ Workspace OpenClaw non trovato

Chiedi all'utente:
"Dov'è il tuo workspace OpenClaw? Di solito è ~/.openclaw/workspace"
```

---

### Errore: File mancanti

```
❌ File critici mancanti: [lista file]

Possibili cause:
- Zip corrotto
- Estrazione incompleta
- Percorso errato

Chiedi all'utente:
"Puoi verificare il pacchetto framework-translator? Mancano file critici."
```

---

### Errore: Permessi script

```bash
# Fix automatico
chmod +x scripts/*.sh

# Verifica
ls -la scripts/*.sh
```

---

## ✅ Conferma Finale

Dopo installazione completata:

1. **Conferma all'utente** (vedi Step 5)
2. **Attendi istruzioni** per primo framework da trasformare
3. **Tieni aperto** `SKILL.md` come riferimento

---

## 📖 Riferimenti

| File | Quando Leggere |
|------|----------------|
| `SKILL.md` | Sempre (istruzioni operative) |
| `test/README.md` | Prima di eseguire test |
| `RELEASE.md` | Per info release corrente |
| `README.md` | Panoramica generale |

---

**Nota:** Non eliminare mai `SKILL.md` — è il cuore della skill.

---

_framework-translator — AGENTS.md v0.2_  
_Aggiornato: 2026-03-07_