From a34c2d4b3ad0a0a432c14bed33587bb713d7331f Mon Sep 17 00:00:00 2001
From: Danielle Maywood <danielle@themaywoods.com>
Date: Fri, 9 Jan 2026 14:04:09 +0000
Subject: [PATCH] chore: add agent instructions

---
 AGENTS.md | 23 +++++++++++++++++++++++
 CLAUDE.md |  1 +
 2 files changed, 24 insertions(+)
 create mode 100644 AGENTS.md
 create mode 120000 CLAUDE.md

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