AG|ST: add some logic to toolkit.init, and add more developer notes