is there any documentation or example of how to add a new goal? i can't seem to find any.

You can find some documentation about goal rules here.

ah thank you!

you may also find this tutorial helpful https://www.pantsbuild.org/2.21/docs/tutorials/create-a-new-goal 🙂