docs(skills): add nix let review rule

This commit is contained in:
alexion committed 2026-09-16 13:44:35 -04:00
1 parent 8154feba5a
commit 652b92d4f4
4 files changed
+117 -125

No files matched your search

+16
View File
@@ -0,0 +1,16 @@
# Let rules
## Prefer explicit dependencies over shared convenience bindings
### Rule
Do not add a `let` binding only to let sibling values share one expression.
When one sibling value owns the concept, reference that sibling value directly.
When a flake output owns the public value, reference that output through `self`.
Do not make an output attrset recursive only to reference sibling outputs.
### Rationale
Shared convenience bindings hide dependency direction.
Explicit references show which value owns a concept and which value consumes it.