From 853c62d7751ae7f078a8f225e408695ba9b56d5f Mon Sep 17 00:00:00 2001
From: ryoppippi <1560508+ryoppippi@users.noreply.github.com>
Date: Mon, 5 Jan 2026 17:38:00 +0000
Subject: [PATCH] docs(readme): improve Nix development environment setup
 instructions

- Add Nix installation command using experimental installer
- Add instructions for enabling flakes if not already enabled
- Clarify direnv activation (use existing .envrc)
- Link to flake.nix for reference
---
 README.md | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 8db1bcd..282e1a2 100644
--- a/README.md
+++ b/README.md
@@ -600,13 +600,27 @@ The tool description includes clear instructions for AI agents to always ask for
 
 ### Using Nix Flake
 
-This project includes a Nix flake for reproducible development environments. If you have Nix installed with flakes enabled, you can use it to set up your development environment:
+This project includes a Nix flake for reproducible development environments. All development tools are defined in [flake.nix](./flake.nix) and provided via Nix.
+
+#### Installing Nix
 
 ```bash
-# Enter development shell
-nix develop
+# Install Nix with flakes enabled (if not already installed)
+curl --proto '=https' --tlsv1.2 -sSf -L https://artifacts.nixos.org/experimental-installer | \
+  sh -s -- install
+
+# If flakes are not enabled, enable them with:
+mkdir -p ~/.config/nix && echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
+```
 
+#### Activating the Development Environment
+
+```bash
+# Automatic activation with direnv (recommended)
 direnv allow
+
+# Or manual activation
+nix develop
 ```
 
 The flake provides all necessary development dependencies including Node.js, pnpm, and other build tools.