In #1432, a new stylistic convention was introduced to the Tool and ToolSpec classes, but this new convention was not explained in CONTRIBUTING.md.

We should update the agent skills so that opportunities for updating the docs are identified when changing the code (especially the parts of the code that are mentioned in CONTRIBUTING.md and the README.md), especially when introducing a new pattern.