Problem: The explanations here about transformer classes don't mention that for personalisation the ruleField is different - it is wrapped implicitly inside MultiField, thus its definition should start with a compositeField as described here.

Fix: Add a note in the Personalization transformers section of the transformer classes page with a link to the "Creating custom traits with complex fields" page.