mirror of
https://github.com/ryan4yin/nix-config.git
synced 2026-11-13 12:13:36 +01:00
docs(agents): prefer upstream fixes over local workarounds
Clarify that minimality means the smallest best-practice change, not a local patch around an upstream defect. Assisted-by: DeepSeek Harness (deepseek-flash)
This commit is contained in:
1 parent
7e579d6aca
commit
13afe01441
1 file changed
+4
@@ -118,6 +118,10 @@ For an impactful change, follow these steps in order, scaled to its risk:
|
||||
provides over a new one, and reuse existing config and abstractions instead of duplicating them.
|
||||
Agents MUST NOT delete config the task did not ask about; when config merely appears unused,
|
||||
report it instead. Ask before a breaking change.
|
||||
- Minimality is not a reason to encode a local workaround for an upstream defect. Fix the owning
|
||||
upstream project first and consume the fixed revision; if a local stopgap is genuinely unavoidable,
|
||||
stop and ask the user before adding it. "Minimal" means the smallest change that follows existing
|
||||
best practice, not the smallest diff at any cost.
|
||||
- Documentation should describe current behavior for readers without the conversation history; give
|
||||
each fact one home per audience and link instead of repeating. Comments explain contracts or
|
||||
non-obvious constraints, not obvious code, and preserve safety, license, and workaround
|
||||
|
||||
Reference in new issue
Block a user