---
name: new-section
description: Genera una nuova sezione del workshop rispettando la struttura, le convenzioni e il pattern ricorrente del progetto.
---

# Genera Sezione Workshop

## Quando Usare
Usa questa skill quando l'utente chiede di creare una nuova sezione (file `.md`) per il workshop.

## Input Richiesti
1. **Numero della sezione** — prefisso a due cifre (es. `12`)
2. **Titolo** — nome della sezione in italiano, kebab-case per il filename
3. **Durata stimata** — in minuti
4. **Obiettivo** — una frase che descrive cosa impareranno i partecipanti
5. **Argomento principale** — il concetto Kiro o il tema da trattare

## Struttura del File Generato

Il file DEVE seguire questo template:

```markdown
# {NUMERO} — {TITOLO}

> **Durata:** {DURATA} minuti  
> **Obiettivo:** {OBIETTIVO}

---

## Il Problema che Risolve

[Spiegazione del problema che questa funzionalità/concetto risolve, con analogia concreta]

---

## Cos'è [Concetto]?

[Spiegazione teorica chiara e concisa]

---

## [Sezioni Tecniche]

[Dettagli tecnici con esempi di codice, diagrammi, configurazioni]

---

## Esercizi Pratici

### Esercizio 1: [Titolo] ({DURATA_ESERCIZIO} min)

[Passi numerati con istruzioni chiare]

### Esercizio 2: [Titolo] ({DURATA_ESERCIZIO} min)

[Passi numerati con istruzioni chiare]

---

## Best Practice

### ✅ Cosa Fare
- [punto 1]
- [punto 2]

### ❌ Cosa NON Fare
- [punto 1]
- [punto 2]

---

## Prossimi Passi

[Collegamento logico alla sezione successiva]

📖 **Documentazione ufficiale:** [kiro.dev/docs/{topic}](https://kiro.dev/docs/{topic}/)

---

[← {Sezione Precedente}](./{FILE_PRECEDENTE}) | [{Sezione Successiva} →](./{FILE_SUCCESSIVO})
```

## Regole
- Il contenuto DEVE essere scritto in **italiano**
- I termini tecnici Kiro (Steering, Skills, Specs, Hooks, MCP) restano in **inglese**
- Usa blocchi di codice con language hint appropriato (`json`, `bash`, `markdown`, `yaml`, ecc.)
- Includi almeno 2 esercizi pratici con durata stimata
- Includi link di navigazione alla sezione precedente e successiva
- Il filename segue il formato `{NN}-{titolo-kebab-case}.md` nella cartella `workshop/`
- Dopo la creazione, verifica che il file `00-agenda.md` sia aggiornato con la nuova sezione