From c14e31cc4395ff6cbede1581cd88a9a75daf4717 Mon Sep 17 00:00:00 2001 From: Jelle Spreeuwenberg Date: Thu, 10 Sep 2026 18:22:14 +0200 Subject: [PATCH] docs: narrow NixOS maintainer validation defaults --- .../skills/nixos-maintainer/SKILL.md | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) diff --git a/modules/capabilities/skills/nixos-maintainer/SKILL.md b/modules/capabilities/skills/nixos-maintainer/SKILL.md index a38c1f6..c89ad4d 100644 --- a/modules/capabilities/skills/nixos-maintainer/SKILL.md +++ b/modules/capabilities/skills/nixos-maintainer/SKILL.md @@ -15,15 +15,10 @@ secret, credential, and application-owned state outside the Nix store. Verify unfamiliar pinned interfaces against the exact package source or current primary documentation. -Preserve unrelated work in a dirty tree. Make the smallest complete change, -format touched Nix files with the repository formatter, and validate only the -affected hosts. Ordinarily run: +Preserve unrelated work. Format touched Nix files and use the narrowest useful +evaluation for configuration changes. Build affected hosts only when needed to +resolve a concrete concern or explicitly requested; instruction-only edits do +not need system builds. Do not add tests or migration/compatibility code by +default. Explain manual steps for breaking changes. -```sh -nix flake check --no-build --quiet -nix build --no-link --quiet .#nixosConfigurations..config.system.build.toplevel -``` - -Start with a narrower evaluation when it can fail faster. Inspect targeted -failure logs only. Do not switch or boot a generation unless the user explicitly -requests activation. +Do not switch or boot a generation unless the user explicitly requests activation.