first attempt to document core

"Agents are used to modify the underlying system".  Or at least, add "a" or "the" before "system" :wink: