From f28dab3d42c6e4a33642b990f60f69abc2d89f07 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Thu, 12 Mar 2026 23:02:59 +0200
Subject: chore: pin libbpfgo v0.9.2-libbpf-1.5.1 workflow

---
 AGENTS.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

(limited to 'AGENTS.md')

diff --git a/AGENTS.md b/AGENTS.md
index 0eabe9f..65c9a2c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,7 +4,14 @@ This file provides guidance to AI coding assistants working with the I/O Riot NG
 
 ## Build/Test Commands
 
-**Prerequisites**: Ensure libbpfgo is cloned at `../libbpfgo` relative to this repository.
+**Prerequisites**: Ensure `libbpfgo` is cloned at `../libbpfgo` relative to this repository (or set `LIBBPFGO`), pinned to `v0.9.2-libbpf-1.5.1`, and rebuilt with:
+
+```bash
+git -C ../libbpfgo checkout v0.9.2-libbpf-1.5.1
+git -C ../libbpfgo submodule update --init --recursive
+make -C ../libbpfgo libbpfgo-static
+```
+
 If builds/tests fail with missing libbpf headers (for example `bpf/bpf.h` not found), run `mage world` first. It bootstraps generation/dependencies and is the preferred first troubleshooting step before retrying `mage test` or `go test`.
 
 ```bash
-- 
cgit v1.2.3