diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..09be004
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,4 @@
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+QWEN.md
diff --git a/LLM.md b/LLM.md
new file mode 100644
index 0000000..e5f771c
--- /dev/null
+++ b/LLM.md
@@ -0,0 +1,68 @@
+# keys
+
+## Overview
+
+Go package for Lux blockchain - keys
+
+## Package Information
+
+- **Type**: go
+- **Module**: github.com/luxfi/keys
+- **Repository**: github.com/luxfi/keys
+
+## Directory Structure
+
+```
+.
+cmd
+cmd/keys
+cmd/staking
+node1
+node1/bls
+node1/ec
+node2
+node2/ec
+node3
+node3/bls
+node3/ec
+node4
+node4/bls
+node4/ec
+```
+
+## Key Files
+
+- allocations.go
+- get_correct_node_ids.go
+- get_node_ids.go
+- go.mod
+- keys.go
+- upgrade_keys.go
+
+## Development
+
+### Prerequisites
+
+- Go 1.21+
+
+### Build
+
+```bash
+go build ./...
+```
+
+### Test
+
+```bash
+go test -v ./...
+```
+
+## Integration with Lux Ecosystem
+
+This package is part of the Lux blockchain ecosystem. See the main documentation at:
+- GitHub: https://github.com/luxfi
+- Docs: https://docs.lux.network
+
+---
+
+*Auto-generated for AI assistants. Last updated: 2025-12-24*