mechanical-engineering-plugins/docs/architecture.md

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 per le convenzioni di scrittura complete.