From f218e4781469d7bb18b85a70da068a35432a26e7 Mon Sep 17 00:00:00 2001 From: alexion Date: Sun, 26 Jul 2026 00:01:10 -0400 Subject: [PATCH] docs: note the repo pins no formatter and nix files aren't nixfmt-clean Record a gotcha so a future change does not run nixfmt across a file and reflow untouched code, injecting churn unrelated to the change. --- CLAUDE.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index fafe38e..cd89dd2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,6 +18,9 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla ## Gotchas +- This repo pins no Nix formatter, and its committed `.nix` files are not clean under current `nixfmt-rfc-style`. + Running `nixfmt` across a file reflows untouched code (for example `lib.nix`'s `deriveMac` list and multi-line assertion messages) and injects churn unrelated to the change. + Format only the lines being written or changed, matching the surrounding style by hand. - This repo is developed on `neogaia`, which now runs the NixOS it builds. Flakes and the chaotic substituter come from this flake's own `nix.settings`, so no `NIX_CONFIG` export or per-command `--extra-experimental-features` is needed, and building a toplevel with `boot.kernelPackages = linuxPackages_cachyos` fetches the kernel from `nyx-cache` rather than compiling it. Both were true only while the machine still ran CachyOS against a distro Nix daemon.