AGENTS.md

• Performance is critical. No debug.getinfo in hot paths (wrappers, metamethods).
• Tests don't need pcall - menu.lua handles errors. Only use pcall when testing failures.
• Don't add namespace "" to tests - simploo reloads fresh per test file.
• NEVER read dist/ files - outdated.
• Run tests: printf '4\n5' | lua menu.lua
• Manual init (outside menu.lua): load files from src/sourcefiles.txt in order:

  for name in io.open("src/sourcefiles.txt"):read("*a"):gmatch("[^\r\n]+") do
      dofile("src/" .. name)
  end

• ALWAYS read all src/ files before working (unless told not to).
• Benchmarks: compare to README numbers, run all 3 lua versions sequentially (not parallel), ask to update README, always end with a percentage change for every table entry.
• When adding/changing features, update both user docs (docs/) and AI reference (docs/reference/ai-agent.md).