diff --git a/scripts/README.md b/scripts/README.md
index 7794261..0b41c9d 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -35,7 +35,7 @@ julia --project=. scripts/generate_lagrange_basis.jl
 - `src/basis/lagrange_generated.jl` (commit this file!)
 
 **Theory:**
-See `docs/theory/lagrange_basis_functions.md` for mathematical foundation.
+See `src/lagrange_basis_functions.md` for mathematical foundation.
 
 **Architecture:**
 
@@ -130,6 +130,6 @@ Pre-compute stiffness matrices for simple elements.
 
 **See also:**
 
-- `docs/theory/lagrange_basis_functions.md` - Mathematical theory
+- `src/lagrange_basis_functions.md` - Mathematical theory
 - `src/basis/lagrange_generator.jl` - Symbolic generation engine
 - `llm/VISION_2.0.md` - Overall project architecture
diff --git a/scripts/generate_lagrange_basis.jl b/scripts/generate_lagrange_basis.jl
index 815796d..4def54e 100755
--- a/scripts/generate_lagrange_basis.jl
+++ b/scripts/generate_lagrange_basis.jl
@@ -21,7 +21,7 @@
 #   - After modifying lagrange_generator.jl
 #
 # THEORY:
-#   See docs/theory/lagrange_basis_functions.md for full mathematical details
+#   See src/lagrange_basis_functions.md for full mathematical details
 #
 # ==============================================================================
 
@@ -617,7 +617,7 @@ println(output, "#   cd /path/to/JuliaFEM.jl")
 println(output, "#   julia --project=. scripts/generate_lagrange_basis.jl")
 println(output, "#")
 println(output, "# Theory:")
-println(output, "#   See docs/theory/lagrange_basis_functions.md")
+println(output, "#   See src/lagrange_basis_functions.md")
 println(output, "#")
 println(output, "# Generator:")
 println(output, "#   src/basis/lagrange_generator.jl (symbolic engine)")
diff --git a/src/basis/lagrange_generator.jl b/src/basis/lagrange_generator.jl
index 8f7d02a..b8e9fe3 100644
--- a/src/basis/lagrange_generator.jl
+++ b/src/basis/lagrange_generator.jl
@@ -45,7 +45,7 @@
 #   - Version control shows what changed
 #
 # SEE:
-#   - docs/theory/lagrange_basis_functions.md (mathematical explanation)
+#   - src/lagrange_basis_functions.md (mathematical explanation)
 #   - scripts/generate_lagrange_basis.jl (generation script)
 #   - src/basis/lagrange_generated.jl (output - do not edit manually!)
 #
diff --git a/docs/theory/lagrange_basis_functions.md b/src/lagrange_basis_functions.md
similarity index 100%
rename from docs/theory/lagrange_basis_functions.md
rename to src/lagrange_basis_functions.md