diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..7be9b6c
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,23 @@
+## Commands
+
+```bash
+make test          # Run tests
+make test-race     # Tests with race detection
+make lint          # golangci-lint + shellcheck
+make fmt           # gofumpt
+```
+
+Single test: `go test -v -run TestName ./...`
+
+## Conventions
+
+- Use `afero.Fs` for filesystem operations (enables test mocking)
+
+## Test Environment Variables
+
+```bash
+CLISTAT_IS_CONTAINERIZED=yes
+CLISTAT_HAS_MEMORY_LIMIT=yes
+CLISTAT_HAS_CPU_LIMIT=yes
+CLISTAT_IS_CGROUPV2=yes
+```
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file