AGENTS.md

• Brevity is good.
• Assume that the maintainers and readers of the code you write are Go experts:
  • Don't use comments to explain the obvious.
  • Use self-explanatory variable and function names.
  • Use short variable names when the context is clear.
• If you need to add temporary debug printing, use hdebug.Printf.¹
• Never export symbols that's not needed outside of the package.
• Avoid global state at (almost) all cost.
• This is a project with a long history; assume that a similiar problem has been solved before, look hard for helper functions before creating new ones.
• In tests, use qt matchers (e.g. b.Assert(err, qt.ErrorMatches, ...)) instead of raw if/t.Fatal checks.
• In tests, always use the latest Hugo specification, e.g. for layouts, it's layouts/page.html and not layouts/_default/single.html, layouts/list.html and not layouts/_default/list.html
• Brevity is good. This applies to code, comments and commit messages. Don't write a novel.
• Use ./check.sh ./somepackage/... when iterating.
• Use ./check.sh when you're done.

Footnotes

1. CI build fail if you forget to remove the debug printing. ↩