Scaffold iniziale del marketplace di plugin per ingegneria meccanica

Struttura marketplace.json + plugin machine-design, documentazione di
architettura e linee guida per la scrittura delle skill.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

docs/architecture.md

@@ -0,0 +1,51 @@
+# Architettura del repository
+
+Questo repository è un **marketplace di plugin Claude** per l'ingegneria meccanica, pensato per essere usato come supporto all'ufficio tecnico nella chat normale di Claude (web e tab Chat di Claude Desktop), non nel tab "Code".
+
+## Come funziona l'installazione (target reale)
+
+Un plugin bundla più skill in un unico pacchetto installabile. Per installarlo:
+1. In Claude: Customize → Plugins → "+" → Add marketplace → Add from a repository, indicando l'URL di questo repository.
+2. Installare il plugin desiderato (es. `machine-design`): tutte le sue skill diventano disponibili in chat (web e tab Chat di Desktop) e in Cowork.
+
+Disponibile su tutti i piani a pagamento (Pro, Max, Team, Enterprise). Nota: hook e sub-agent eventualmente presenti in un plugin funzionano solo in Cowork, ma le skill funzionano ovunque.
+
+Questo è lo stesso formato marketplace.json/plugin.json usato da Claude Code — non serve nulla di diverso per il nostro target.
+
+## Plugin attivi
+
+- **machine-design** (`plugins/machine-design/`): progettazione e verifica di organi meccanici (alberi, cuscinetti, ingranaggi, collegamenti filettati, saldature, molle).
+
+## Plugin previsti (non ancora creati)
+
+Verranno aggiunti come nuova cartella in `plugins/` + entry in `.claude-plugin/marketplace.json` solo quando si inizia a lavorarci concretamente:
+
+- **engineering-materials**: scienza e tecnologia dei materiali (proprietà, trattamenti termici, criteri di scelta materiali).
+- **applied-mechanics**: meccanica applicata alle macchine (cinematica, dinamica, vibrazioni, meccanismi).
+- **manufacturing-engineering**: tecnologia meccanica e processi di produzione (lavorazioni, tolleranze e rugosità, saldatura come processo).
+
+## Perché non creare subito le cartelle vuote
+
+Una cartella placeholder senza skill reali non aiuta: meglio tenere qui il piano e creare la struttura di un nuovo plugin nel momento in cui si scrive la prima skill di quel dominio.
+
+## Struttura di un plugin
+
+```
+plugins/<nome-plugin>/
+├── .claude-plugin/
+│   └── plugin.json
+├── skills/
+│   └── <nome-skill>/
+│       └── SKILL.md
+├── README.md
+└── CHANGELOG.md
+```
+
+## Vincoli reali sul frontmatter di SKILL.md
+
+Campi obbligatori: `name` e `description`.
+
+- `name`: max 64 caratteri, solo lettere minuscole/numeri/trattini, niente tag XML, non può contenere "claude" o "anthropic".
+- `description`: non vuota, max 1024 caratteri, niente tag XML. Deve descrivere sia cosa fa la skill sia quando Claude deve usarla (guida l'attivazione automatica).
+
+Vedi [skill-guidelines.md](skill-guidelines.md) per le convenzioni di scrittura complete.

docs/skill-guidelines.md

@@ -0,0 +1,33 @@
+# Linee guida per la scrittura delle skill
+
+## Lingua
+
+- **Chiavi/campi degli schema** (`name`, `description`, `version` in `plugin.json` e nel frontmatter di `SKILL.md`): nomi di campo fissi in inglese, non traducibili.
+- **Valori di quei campi e tutto il contenuto** (description, istruzioni, esempi, commenti nel codice): in italiano. L'utilizzatore e il materiale tecnico di riferimento (norme UNI, letteratura italiana) sono in italiano; la description in italiano matcha meglio semanticamente le richieste dell'utente, che scrive sempre in italiano.
+- Nomi di file/cartelle/skill (slug): kebab-case, in italiano (es. `verifica-trave-flessione`).
+
+## Struttura di una skill
+
+```
+skills/<nome-skill>/
+├── SKILL.md
+├── scripts/       # eventuali script di calcolo (se necessari)
+└── references/    # tabelle, formulari, estratti di norme
+```
+
+## Vincoli sul frontmatter (obbligatori, imposti da Claude)
+
+- `name`: max 64 caratteri, solo lettere minuscole (a-z, niente accentate), numeri e trattini, niente tag XML, non può contenere "claude" o "anthropic". Deve coincidere con il nome della cartella della skill.
+- `description`: non vuota, max 1024 caratteri, niente tag XML.
+
+## Contenuto di SKILL.md
+
+- Frontmatter con `name` e `description` accurati: la description determina quando Claude attiva la skill, deve descrivere chiaramente il caso d'uso (es. "verifica a fatica di un albero rotante sollecitato a flessione e torsione").
+- Riportare sempre le **norme/riferimenti** usati (UNI, ISO, manuali) quando la skill implementa un metodo di calcolo codificato.
+- Esplicitare le **ipotesi e i limiti di validità** del metodo di calcolo (es. campo di applicabilità di una formula).
+- Preferire formule e simbologia standard della manualistica italiana di meccanica applicata/costruzione di macchine.
+
+## Cosa evitare
+
+- Non duplicare in una skill calcoli già coperti da un'altra: verificare prima le skill esistenti nel plugin.
+- Non inventare valori numerici (coefficienti, tabelle) senza fonte: se manca il riferimento, chiederlo esplicitamente prima di scrivere la skill.