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

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

Esempio:

mkdir -p test/finance
cd test/finance

---

2. Esegui Fasi 1-4

Segui SKILL.md nella root del repository:

# 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)

# 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>/:

# 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:

# 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%