if it's really easy for a model to read the source code / docs of a tool i've found that they fill in the gaps really easily and have no trouble using it.
The monorepo makes this easier but still impossible. Like Gemini isn't going to read Boq's source code and understand how to do config changes properly. It might read the src to figure out something smaller like what Scaffolding context to use.
Also, probably fixed now, but piper itself used to trip up the agents a lot. They didn't understand that it's a remote fs and got stuck recursive-grepping a huge dir. At some points they had a Codesearch skill and were not using it half the time.
