From 2b797b400ced26364ec2361bff823d6dd84ddd8f Mon Sep 17 00:00:00 2001
From: Michael Czechowski <mail@dailysh.it>
Date: Mon, 15 Sep 2025 22:22:10 +0200
Subject: [PATCH] docs: add critical warning about nix-env usage

- Add warning to never run nix-env as it can break Nix environments
- Include recommended alternatives (nix-shell, nix develop)
---
 AGENTS.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index 6ea5994..5a7ed1c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -50,7 +50,11 @@ This file provides guidelines for AI coding agents operating within this reposit
 ## General Guidelines
 
 - Keep code concise and readable
-- Prefer declarative over imperative approaches  
+- Prefer declarative over imperative approaches
 - Document complex logic with comments
 - Test locally before cloud deployment
 - Maintain feature parity between USB/VM environments where possible
+
+## ⚠️ Critical Warnings
+
+- **NEVER RUN `nix-env`** - This can break your Nix environment. Use `nix-shell`, `nix develop`, or declarative approaches instead.