From 40ce5bc1d9da31b49f42e488d2ab5633e7c6a3fb Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Sun, 22 Feb 2026 18:16:59 +0200
Subject: Implement sync_file_range coverage and document mage world bootstrap

---
 AGENTS.md | 1 +
 1 file changed, 1 insertion(+)

(limited to 'AGENTS.md')

diff --git a/AGENTS.md b/AGENTS.md
index cfd3dd1..db92aa8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -5,6 +5,7 @@ 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.
+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
 mage all          # Build everything (BPF objects and Go binary)
-- 
cgit v1.2.3