claude-config
CLAUDE.md1 starsChanged 3 days agoMITView on GitHub
- Reads credentials
In this repositoryOne other file it gives its agents.
- docsSkill
The file
We found no rules to list in this file: it reads as prose or reference rather than instructions.
Files
CLAUDE.md — [NOME PROGETTO]
<!--
Copia questo file nella radice del progetto come `CLAUDE.md` e compila i campi tra [parentesi].
I moduli delle regole stanno in `.claude/rules/` e Claude Code li carica da solo, senza import: `core`, `lavoro`, `git` e `security` all'avvio; `frontend`, `security-frontend`, `backend` e `security-backend` solo quando si legge o modifica un file corrispondente (`paths:` nell'intestazione). I moduli opzionali stanno in `.claude/rules-optional/` (non si caricano): `docker` (solo su richiesta esplicita dell'utente, per esempio «crea un Dockerfile»; non si chiede all'avvio), `feature-workflow` (solo fullstack e solo se confermato all'avvio, domanda 8), `backend-email` e `backend-infra` (non all'avvio: si attivano spostandoli in `.claude/rules/` quando servono invio email o messaggistica/cache/eventi).
Il modulo non scelto all'avvio si sposta in `.claude/rules-optional/` (es. `frontend.md` in un progetto solo API), poi si compilano i campi tra [parentesi].
In modalità "solo Git" (progetto esistente) restano solo le sezioni "Regole", "Progetto", "Git" ed "Eccezioni alle regole globali", con i moduli `core` e `git`.
Questo file PREVALE sulle regole globali in caso di conflitto. Tienilo breve: solo ciò che è specifico del progetto.
-->Regola inviolabile (prevale su tutto, sempre attiva)
Nel dubbio Claude non decide in autonomia: pone una sola domanda alla volta e attende la risposta. Il testo completo, con le eccezioni, è in core.md (sezione in testa e §6, punto 5), che prevale su questo riepilogo solo per i dettagli.
Regole
I moduli sono in .claude/rules/ e Claude Code li carica da solo: core.md, lavoro.md, git.md e security.md all'avvio; frontend.md (**/*.{ts,html,css,scss}, angular.json, tsconfig*.json), backend.md, backend-architecture.md e backend-app.md (tutti e tre **/*.{cs,csproj,props}) security-backend.md (come i moduli backend, **/*.{cs,csproj,props}) e security-frontend.md (come frontend.md) quando si legge o modifica un file corrispondente (paths: nell'intestazione). I moduli opzionali stanno in .claude/rules-optional/ (non si caricano): si attivano spostandoli in .claude/rules/ e annotandolo qui; hanno già il loro paths: (backend per backend-email.md e backend-infra.md, backend e frontend per feature-workflow.md, Dockerfile, docker-compose*/compose* .yml/.yaml, .dockerignore e docker/** per docker.md, che si attiva solo su richiesta esplicita dell'utente, per esempio «crea un Dockerfile»), quindi attivati si caricano solo sui file corrispondenti. Per verificare cosa è caricato: /context. Non aggiungere altri .md in .claude/rules/ se non sono regole: vengono caricati tutti.
- Versione delle regole copiate:
core.mdv[x.y] del [data] - Moduli rimossi o non attivati (fuori ambito): [nessuno | security | docker | frontend | backend | feature-workflow | backend-email | backend-infra]
Progetto
- Scopo: [una frase: cosa fa l'applicazione e per chi]
- Tipo: [fullstack | solo API | solo frontend | solo Git (progetto esistente)]
- Stato: [nuovo progetto | esistente] — se esistente, NON migrare a zoneless né ristrutturare senza chiedere.
Scelte architetturali (decise una volta per progetto)
- Architettura backend: [Vertical Slice | Clean Architecture] (chiesta una volta per progetto; in un progetto esistente rilevata dal codice e confermata)
- Livelli Clean Architecture (se Clean): [Domain, Application, Infrastructure, Api | nomi diversi come deroga: .. (rinomina pianificata in
PIANO.md: sì/no)] - Entità di riferimento (solo se si usa
feature-workflow.md): [nessuna ancora |NomeEntità] — spunto di configurazione per le nuove entità, non un modello da clonare: se ne riprendono le convenzioni (interfaccia/classe base per l'id, audit, soft delete, tenant, configurazione EF, forma di DTO/endpoint/UI), non campi né regole di business; vedifeature-workflow.md§1. - Modello del dominio (se Clean): [anemico per i CRUD (default) | ricco: entità/aggregati: ..] (valutato a ogni progetto, non presunto; vedi
backend-architecture.md§2b) - Repository (Clean e Vertical Slice): [no (default) | sì: per aggregato o generico
IRepository<T>, motivo, ambito] (valutato a ogni progetto, non presunto; vedibackend-architecture.md§2b e §2c) - Specification pattern: [no (default: metodi di estensione su
IQueryable<T>) | sì: motivo, ambito] (valutato a ogni progetto, non presunto; vedibackend-architecture.md§2c) - Gestione errori/risultati: OperationResults (Marco Minerva) — scelta fissa; la variante AppEngine è sospesa fino a nuova modifica delle regole (vedi
backend.md§1) - Validazione backend: [FluentValidation (default, preferita alle Data Annotation) | deroga: .. (motivo)]
- Esposizione del documento OpenAPI: [solo build (nessun endpoint) | solo Development | anche produzione: protezione ..] (chiesto ogni volta, non presunto; la UI Swagger resta solo in Development)
- Tecnologia frontend: [Angular | Blazor (nessun modulo di regole: da creare)] (chiesto, non presunto)
- Sviluppo mobile: [no | PWA | Ionic + Capacitor | .NET MAUI | Flutter | React Native | altro: ..] (chiesto, non presunto)
- ORM: [EF Core (default) | Dapper | EF Core + Dapper per: ..] (chiesto, non presunto; Dapper si valuta ogni volta)
- Database: [SQL Server | PostgreSQL] — versione [..] (chiesto, non presunto)
- Database nei test: [nessuno | progetto
IntegrationTestscon database reale di prova (stesso motore, istanza: ..., un database per esecuzione) | SQLite] (chiesto, non presunto) - Mock EF nei test unitari: [no (default) | sì: mock di
DbContexteDbSetsolo per la logica che non tocca ilDbContext; i servizi che lo usano restano sul database reale] (chiesto, non presunto; vedibackend-app.md§4.5) - Multi-tenancy: [no | sì, per colonna
TenantIdcon global query filter] - Soft delete: [no | sì]
- Sicurezza backend: [da chiedere a Claude | nessuna (endpoint pubblici) | ASP.NET Core Identity | Keycloak o altro IdP self-hosted gratuito]
- Livello ASVS: [1 | 2 | 3] (chiesto, non presunto; vedi
security.md) - Indirizzo pubblico e host ammessi:
App:PublicBaseUrl[dominio pubblico],AllowedHosts[elenco] (chiesto, non presunto; valori reali da variabile d'ambiente; vedisecurity-backend.md, «Host header e URL assoluti») - Utenti del database: applicativo (senza DDL) e utente separato per le migrazioni (
ConnectionStrings:Migrations), valori solo da variabili d'ambiente valorizzate da.env, elencati in.env.example; connessione cifrata [Encrypt=True | SslMode=VerifyFull], CA fidata [..] (chiesto, non presunto; vedibackend-app.md§4.4) - Upload di file: [non previsto | previsto: tipi ammessi, limiti, antivirus/disarmo dei contenuti sì/no] (chiesto, non presunto; vedi
security-backend.md, «Upload e parsing di file») - Eccezioni a
npm ci --ignore-scripts: [nessuna | pacchetto: motivo e script lanciato a parte] (vedisecurity.md, «Supply chain») - Limiti e rate limiting:
pageSizepredefinito e massimo [20 / 100 | ..], limiti per IP e per utente [..], timeout database e HTTP [..] (concordati, non presunti; vedisecurity-backend.md, «Abuso di risorse») - Allerta sugli eventi di sicurezza: [solo log strutturati, controllati da: .. | alert su Grafana/Prometheus, canale: ..]; retention dei log di audit [..] (concordata, non presunta; vedi
security.md, «Log di sicurezza e allerta») - DAST (OWASP ZAP baseline): [no | sì, in CI su istanza di prova] (opzionale; vedi
security.md, «Scansione dinamica, segnalazioni e risposta agli incidenti»);SECURITY.mdedocs/runbook-sicurezza.md[presenti | da creare] - CSP della SPA statica: [hash alla build con
autoCsp(default) | nonce inserito dal server | deroga: ..] (vedisecurity-backend.md, «Protezione dell'API») - Token JWT (se Identity e solo API): [no | sì — ciclo di vita: solo creazione e verifica | anche rinnovo | anche rinnovo e revoca; algoritmo, durata access token]
- Granularità (se Identity): [solo autenticazione | ruoli | policy/claim | permessi granulari] — extra: [registrazione, conferma email, reset password, MFA, login esterni, lockout, multi-tenancy, UI amministrativa]
- Sessione SPA (se c'è un frontend con autenticazione): [cookie HttpOnly | BFF]
- Cache: [nessuna | FusionCache solo L1 (preferita) | memory cache nativa
IMemoryCache| con L2 Redis (istanza singola, volume e sola password) o altra configurazione avanzata: ..] (chiesto ogni volta, non presunto; L2 e configurazioni complesse valutati di volta in volta; vedibackend-infra.md) - File storage: [non usato | da chiedere a Claude | disco su volume Docker | MinIO | altro self-hosted]
- Invio email: [non previsto | MailKit (confermato) | altra libreria: ..] — sezione
Smtpin appsettings, valori reali solo da variabili d'ambiente valorizzate da.env - Messaggistica: [non usata | RabbitMQ]
- Job in background: [non usati | BackgroundService | hosted service | Coravel] — tipo di job: [ricorrente | a richiesta | avvio/arresto | ..] (chiesto, non presunto) — retry: [no | sì: tentativi, backoff] (chiesto, non presunto)
- Disaccoppiamento invio email: [n/a | RabbitMQ | job in background (vedi sopra)]
- Outbox/retry email: [n/a | nessuno | solo retry | outbox + retry: tentativi, backoff] (chiesto, non presunto)
- Logging: provider dietro
ILogger[nessuno | Serilog | provider standard .NET | OpenTelemetry | combinazione: ..] (concordato, non presunto); se Serilog: sink [console | file | database | OTLP | ..], formato [template testuale | JSON | ..], livelli minimi [..], rotazione/retention file [..] (concordati, non presunti) - SMTP di prova (test/sviluppo): [nessuno | Mailpit (default per i test che richiedono un mail server; istanza già presente nell'infrastruttura, host/porta forniti dall'utente) | altro: ..]
- Preferenze utente (tema, fuso orario, consenso cookie): [profilo a database | altra sede: .. (chiesta, non presunta)]
- Lingue supportate: [it, en] — lingua di default: [it]
- Temi disponibili: [light, dark, ...]
- Tailwind: [non usato | usato]
- SSR / PWA: [no | sì: motivo]
- Browser supportati: [default delle regole globali | diverso: ...]
Nomi e struttura
- Solution:
[Azienda.Progetto].sln - Namespace radice:
[Azienda.Progetto] - Cartelle: backend in
[src/Api], frontend in[src/web] - File di configurazione .NET:
.editorconfigeNuGet.configvalgono solo per il backend .NET e sono nella root del template; se il progetto non ha backend .NET (solo frontend) vanno rimossi.NuGet.config[tenuto | rimosso | deroga: ..],.editorconfig[tenuto | rimosso | deroga: ..] (chiesto, non presunto). Per il frontend non c'è un file nel template: lint e formattazione si decidono nel progetto Angular. - Prefisso selettori Angular:
[app] - Naming file Angular: componenti con suffisso
.componente file separati.ts/.html/.css/.spec.ts, senza template o stili inline (regola fissa difrontend.md§2; qui solo un'eventuale deroga motivata: ..) - Micro frontend: [no (default) | sì: motivo (team/rilasci indipendenti), Native Federation, ADR: ..] (chiesto, non presunto; vedi
frontend.md§12)
Comandi
| Azione | Comando |
| Avvio ambiente locale (Redis, RabbitMQ; il DB è preesistente) | docker compose up -d |
| Build backend | dotnet build |
| Test backend | dotnet test |
| Formattazione backend | dotnet format --verify-no-changes --no-restore |
| Audit pacchetti NuGet | dotnet list package --vulnerable --include-transitive |
| Avvio backend | dotnet run --project [src/Api] |
| Installazione frontend | npm ci --ignore-scripts |
| Avvio frontend | npm start |
| Lint frontend | npm run lint |
| Test unitari frontend | npm test |
| Test frontend con copertura | npm run test:coverage |
| Build di produzione frontend | npm run build |
| Formattazione frontend | npx prettier --check . |
| Audit pacchetti npm | npm audit --audit-level=high |
| Test E2E | npx playwright test |
| Generazione client API | [comando NSwag / OpenAPI Generator] |
| Nuova migrazione EF | dotnet ef migrations add [Nome] --project [..] --startup-project [..] |
Operatività
<!-- Le voci su Docker, compose, reverse proxy, backup e osservabilità valgono solo se `docker.md` è stato attivato su richiesta esplicita dell'utente; altrimenti si omettono. -->- Deploy: [non Docker | Dockerfile + docker-compose, solo se l'utente lo ha chiesto esplicitamente: regole in
docker.md, attivato]. Server gestiti dall'utente. - Ambienti: [dev + prod | dev + staging + prod] — file compose: base,
override(dev),prod - Reverse proxy / TLS: nginx preconfigurato sul server, gestito dall'utente (nessuna configurazione nginx generata da Claude) [note]
- Porta applicazione nel container: [8080]
- Database: preesistente sul server (SQL Server o PostgreSQL), mai nel compose; host/porta/rete forniti dall'utente
- Servizi nel compose: [Redis, RabbitMQ, ...] (mai database né reverse proxy)
- Osservabilità: [nessuna | stack OpenTelemetry + Prometheus/Jaeger/Grafana (
docker-compose.observability.yml) | altro: ..] (concordata, non presunta; i log seguono la voce "Logging") - Backup: [da valutare in ogni progetto: servizio
db-backupgenerato (dump pianificato (default) | PITR con pgBackRest) | già coperto sul server, nessun servizio generato] — frequenza [..], pianificazione e copia fuori host a cura dell'utente - RPO / RTO e retention backup: [..]
- Scadenza/rotazione segreti: [..]
- Soglie di performance diverse dal default: [nessuna | ...]
Git
- Modello branch (git flow): git flow completo con
develop, obbligatorio in ogni progetto (feature/bugfix/releasedadevelop,hotfixdamain; vedigit.md) — Claude crea da solo il branch di lavoro quando serve, senza chiederti conferma; sedevelopmanca, chiede se crearlo - Branch principale: [main]
- Strategia di merge: come da
git.md(squash versodevelop, merge commit per ogni PR che coinvolgemain) - Ticket nei branch/commit: [no | sì, formato
ABC-123] - Scope Conventional Commits ammessi: [liberi | elenco: ..]
- File della versione e changelog: [
Directory.Build.props+CHANGELOG.md| ...] —CHANGELOG.mdeREADME.mdsi aggiornano a ogni step del piano (core.md§5b) - Lingua della documentazione (README.md, CHANGELOG.md): [italiano | inglese | altro: ..] (chiesta, non presunta)
- Fine riga: [
.gitattributescon* text=auto| altro: .. | nessuno: motivo] (valutato caso per caso, non presunto) - Hook pre-commit: [nessuno | husky + lint-staged |
.githooks/] — attivazione a cura dell'utente - Push, PR, tag, release ed esecuzione delle pipeline: come da
git.md(«Integrazione GitHub»); PR e rilasci conghsolo se installata (riga in «Eccezioni alle regole globali»). - Attribuzione Claude nei commit: [no | trailer Co-Authored-By]
Eccezioni alle regole globali
<!-- Ogni deroga va motivata. Se vuota, vale tutto il resto. -->- [nessuna]
<!-- GitHub CLI: riga fissa letta dal hook guard-commands (git.md, «Integrazione GitHub»). Si scrive con la risposta dell'utente alla domanda unica per progetto, aggiungendo la data tra parentesi. Push e tag non la richiedono. -->- GitHub CLI (gh) installata: sì (2026-11-08)
Note per Claude
- [Particolarità del dominio, termini di business, vincoli del cliente, aree del codice delicate]
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

