framework-translator/test/README.md

# Test Directory — framework-translator

Questa cartella contiene tutti i test eseguiti per validare framework-translator.

---

## Struttura

```
test/
├── README.md                    # Questo file
└── <framework-name>/            # Una sottocartella per test
    ├── test-<framework>_v1/     # Output Fasi 1-4 (analysis, mapping, references, skills)
    └── <framework>-skills-suite/# Packaging finale (Fase 5)
```

### Esempio

```
test/
├── README.md
└── orto/                        # Test: orto_v1 → orto-skills
    ├── test-orto_v1/            # Output Fasi 1-4
    │   ├── analysis_report.md
    │   ├── mapping_plan.md
    │   ├── references/          # 11 file .md
    │   ├── skills/              # 7 skills
    │   └── TEST_SUMMARY.md
    └── orto-skills-suite/       # Packaging (Fase 5)
        ├── INSTALL.sh
        ├── README.md
        ├── orto-init/
        ├── orto-onboarding/
        ├── ...
        └── references/
```

---

## Come Eseguire un Test

Per ogni nuovo framework da trasformare:

### 1. Crea sottocartella

```bash
mkdir -p test/<framework-name>
cd test/<framework-name>
```

**Esempio:**
```bash
mkdir -p test/finance
cd test/finance
```

---

### 2. Esegui Fasi 1-4

Segui `SKILL.md` nella root del repository:

```bash
# Fase 1: Analisi
# (LLM legge framework, genera analysis_report.md)

# Fase 2: Mappatura
# (LLM genera mapping_plan.md, approva con utente)

# Fase 3: Estrazione References
# (LLM estrae knowledge → references/*.md)

# Fase 4: Generazione Skills
# (LLM genera N skills → skills/*/SKILL.md)
```

**Output atteso:**
```
<framework-name>/
├── test-<framework>_v1/
│   ├── analysis_report.md
│   ├── mapping_plan.md
│   ├── references/
│   └── skills/
```

---

### 3. Esegui Fase 5 (Packaging)

```bash
# Usa script meccanici dalla root
cd ../../
./scripts/02_create_structure.sh <framework>-skills ./test/<framework-name>/
./scripts/03_generate_packaging.sh ./test/<framework-name>/<framework>-skills-suite/
```

**Output atteso:**
```
<framework-name>/
└── <framework>-skills-suite/
    ├── INSTALL.sh
    ├── README.md
    ├── <skill-1>/
    ├── <skill-2>/
    └── references/
```

---

### 4. Documenta Test

Crea `TEST_SUMMARY.md` in `<framework-name>/`:

```markdown
# Test Summary — <framework>_v1 → <framework>-skills

**Data:** YYYY-MM-DD
**Framework:** <nome> (X agenti, Y workflow)
**Output:** <N> skills + <M> references

## Fasi Completate

- [ ] Fase 1: Analisi (100%)
- [ ] Fase 2: Mappatura (100%)
- [ ] Fase 3: References (X/Y%)
- [ ] Fase 4: Skills (X/Y%)
- [ ] Fase 5: Packaging (100%)

## Metriche

| Metrica | Valore | % |
|---------|--------|---|
| Skills | X/Y | Z% |
| References | X/Y | Z% |
| Commit | N | - |

## Status

✅ Test completato / ⚠️ Parziale / ❌ Fallito
```

---

## Test Eseguiti

### Test #1: orto_v1 → orto-skills v0.2

**Data:** 2026-03-07  
**Path:** `test/orto/`  
**Status:** ✅ Completato (78% skills, 79% references)  
**Release:** `v0.2-test`

**Risultati:**
- 7 skills generate (su 9 previste)
- 11 references estratte (su 14 previste)
- Packaging completo
- Documentazione completa

**Dettagli:** Vedi `test/orto/test-orto_v1/TEST_SUMMARY.md`

---

## Prossimi Test (Pianificati)

| Framework | Dominio | Priorità | Status |
|-----------|---------|----------|--------|
| **finance_v1** | Finanza personale | Alta | 🔧 Da eseguire |
| **health_v1** | Salute/wellness | Media | 📋 Pianificato |
| **edu_v1** | Educazione | Bassa | 📋 Pianificato |

---

## Criteri di Accettazione

Un test è considerato **completato** quando:

- [ ] **Fase 1:** Analysis report generato (100%)
- [ ] **Fase 2:** Mapping plan approvato (100%)
- [ ] **Fase 3:** References estratte (≥70%)
- [ ] **Fase 4:** Skills generate (≥70%)
- [ ] **Fase 5:** Packaging completo (100%)
- [ ] **Documentazione:** TEST_SUMMARY.md compilato
- [ ] **Git:** Commit + push eseguiti
- [ ] **Tag:** Release tag creato (se ≥70% completion)

---

## Cleanup

Per rimuovere un test:

```bash
# Rimuovi cartella test
rm -rf test/<framework-name>/

# Rimuovi tag release (se esistente)
git tag -d <framework>-vX.Y
git push origin :refs/tags/<framework>-vX.Y
```

**Nota:** Non rimuovere test completati a meno che non siano obsoleti. Servono come riferimento per test futuri.

---

## Best Practices

1. **Una cartella per test:** Ogni framework ha la sua sottocartella
2. **Naming coerente:** `test-<framework>_v1` per output Fasi 1-4
3. **Commit frequenti:** Ogni fase completata = 1 commit
4. **Documenta tutto:** TEST_SUMMARY.md obbligatorio
5. **Tag release:** Se completion ≥70%, crea tag (es. `v0.1-test`)

---

**Ultimo aggiornamento:** 2026-03-07  
**Test totali:** 1 (orto_v1)  
**Success rate:** 100%