.claude/rules/

La directory .claude/rules/ è un luogo per organizzare istruzioni specifiche del progetto in più file markdown, piuttosto che in un unico grande CLAUDE.md. Ogni file all'interno di questa directory rappresenta un argomento distinto, come testing.md o api-design.md. Questi file vengono scoperti ricorsivamente, consentendo un'ulteriore organizzazione in sottodirectory.

Le regole collocate in .claude/rules/ senza un campo frontmatter paths vengono caricate per impostazione predefinita all'inizio di una sessione, in modo simile al file principale CLAUDE.md. Tuttavia, le regole che includono un campo paths sono considerate con ambito di percorso. Queste regole con ambito di percorso vengono caricate solo quando Claude sta attivamente lavorando con file che corrispondono ai pattern glob specificati, ad esempio, src/**/*.{ts,tsx}. Questo meccanismo aiuta a gestire la finestra di contesto caricando istruzioni pertinenti solo quando necessario, migliorando l'efficienza. Le regole con ambito di percorso vengono attivate quando Claude legge file che corrispondono al pattern, non necessariamente ad ogni utilizzo dello strumento.

Le regole personali possono essere collocate in ~/.claude/rules/. Queste regole globali si applicano a tutti i progetti e vengono caricate prima delle regole specifiche del progetto, dando effettivamente alle regole del progetto una precedenza maggiore. Il sistema supporta i symlink, consentendo l'uso di un set condiviso di regole in più progetti collegandoli alla directory .claude/rules/ di ciascun progetto.

È importante distinguere queste regole dalle skills. Le regole vengono caricate nel contesto all'inizio di una sessione o quando vengono aperti file corrispondenti. Per le istruzioni specifiche del task e che non richiedono una presenza costante nel contesto, una skill è il meccanismo più appropriato. Similmente alle regole, anche i file SKILL.md hanno un campo paths nel loro frontmatter, che controlla quando una skill si attiva automaticamente in base alla corrispondenza dei file.