docs: add CLAUDE.md for Claude Code guidance

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## About
+
+NixOS dotfiles for Pierre MARTIN (Lundi Matin — Front-Commerce, LMB, NEIA), using home-manager.
+
+## Architecture
+
+- `nixos/configuration.nix` — System-level NixOS config (bootloader, networking, services, system packages). Imports `hardware-configuration.nix` et `framework.nix`.
+- `home.nix` — Entry point home-manager. Importe `packages.nix` et les modules de `programs/`. Mappe aussi les fichiers statiques depuis `files/`.
+- `packages.nix` — Tous les packages utilisateur (avec allowlist unfree).
+- `programs/` — Modules home-manager par programme : `git.nix`, `zsh.nix`, `i3.nix`, `neia.nix`.
+- `files/` — Fichiers de config statiques copiés dans `$HOME` par home-manager (`.npmrc`, `.aider.conf.yml`, `traefik.toml`, etc.).
+- `shell.nix` — Dev shell pour travailler sur les dotfiles eux-mêmes.
+
+Home-manager est intégré au module NixOS (pas standalone). Appliquer avec `sudo nixos-rebuild switch`.
+
+## Commands
+
+```bash
+make fmt       # Formater .nix (nixfmt) et .sh (shfmt)
+make lint      # Linter les .sh avec shellcheck
+make check     # Vérifier le formatage sans modifier
+make clean     # Supprimer .direnv et result
+```
+
+Formatter Nix : `nixfmt-classic` (pas nixfmt-rfc-style).
+
+## Appliquer les changements
+
+Après modification des fichiers nix, appliquer avec :
+
+```bash
+sudo nixos-rebuild switch
+```
+
+Cette commande applique à la fois la config système (`nixos/`) et home-manager (`home.nix`, `packages.nix`, `programs/`). Un redémarrage n'est pas nécessaire sauf changement kernel/bootloader.
+
+Si un package unfree est ajouté dans `packages.nix`, il faut aussi l'ajouter dans `nixpkgs.config.allowUnfreePredicate` (même fichier).
+
+Si un nouveau module programme est créé dans `programs/`, il faut l'importer dans `home.nix`.
+
+Après modification de fichiers `.sh`, lancer `make fmt && make lint` avant d'appliquer.
+
+## Key details
+
+- Keyboard layout : bépo (`fr` variant `bepo`)
+- Window manager : i3 (Mod4)
+- Shell : zsh + oh-my-zsh + starship + mcfly
+- Terminal : sakura
+- Git : difftastic (diffs), meld (merges), `push.autoSetupRemote = true`
+- Node : fnm + bun
+- Aliases utiles : `c` = claude, `p` = claude perso, `g` = git, `m` = make, `dc` = docker compose, `k`/`kp` = kubectl build/prod