Template di progetto per Claude Code

Repository di partenza per i nuovi progetti sviluppati con Claude Code.

Contiene le regole di sviluppo (stack .NET + Angular, git flow, sicurezza, Docker) già organizzate nel formato che Claude Code carica da solo, più un CLAUDE.md da compilare per il progetto.

Le regole sono in italiano; codice, identificatori e messaggi di commit che ne derivano sono in inglese.

Documentazione

Documento	Contenuto
Come si usa, nei dettagli	Quale caso è il tuo (progetto nuovo, esistente senza regole, esistente con regole), il template come cartella a parte, copia-regole.bat, moduli da tenere per tipo di progetto
Plugin kit	Dodici hook personali (blocchi, avvisi e promemoria su comandi, segreti, pattern vietati, piano, regole aggiornate): installazione, aggiornamento, migrazione
Cosa contiene	Struttura del repository, moduli delle regole, cartella _template/ e plugin
Come funziona	Caricamento delle regole, deroghe, cosa chiede Claude e cosa fa da solo
Manutenzione	Verifiche periodiche, risoluzione dei problemi, punti aperti, aggiornamento del template

Come si usa, in breve

Le regole non si "installano": si copiano nel progetto e Claude Code le legge da solo.

Servono sempre due cose, che Claude prepara per te se glielo chiedi:

1. la cartella .claude/rules/ con i moduli scelti (almeno core.md e git.md);
2. un CLAUDE.md nella root del progetto, compilato con le scelte di quel progetto (database, architettura, ecc.).

Non devi fare altro che aprire Claude Code nella cartella del progetto e scrivere una frase (qui sotto indicata).

Claude ti fa le domande una alla volta, scrive il piano in PIANO.md (per i lavori sostanziosi, non per le modifiche piccole) e va avanti un passo per volta, con il tuo ok a ogni passo. I problemi che trova lavorando li annota in CHECKLIST.md, senza interrompere il lavoro.

Situazione	Cosa scrivere a Claude
Progetto nuovo	"Avvia un nuovo progetto"
Progetto già avviato, tutte le regole	"Applica le regole in <percorso del template> a questo progetto esistente"
Progetto già avviato, dopo aver copiato le regole con copia-regole.bat (voce 1)	"Applica le regole di questo progetto" (senza percorso)
Progetto già avviato, solo branch e commit	"Integra solo le regole Git in questo progetto, con le regole in <percorso del template>"
Aggiungere un modulo più avanti	"Aggiungi il modulo <nome>" o lo script copia-regole.bat (voce 1)
Allineare il progetto al template aggiornato	"Riallinea le regole" o lo script copia-regole.bat (voce 2)

Per copiare i file senza Claude (Windows) e per i casi particolari vedi Come si usa, nei dettagli.

Claude non fa mai git init e non fa push, PR, tag o rilasci se il progetto non li ha approvati (una riga nel CLAUDE.md, vedi Integrazione GitHub): altrimenti fa solo commit locali, e solo dopo aver confermato branch e messaggio con te. Il plugin kit rende tecnici molti di questi divieti (comandi, segreti, pattern vietati) e la regola della domanda unica; le pratiche che richiedono giudizio arrivano come avvisi. Si installa una volta per macchina:

claude plugin marketplace add AngeloDotNet/claude-config
claude plugin install kit@claude-config