Core concepts

• Architecture — the contracts the adapter implements, how the read and write paths map onto Spatie, and how organizations map onto Spatie teams.
• Directory group → role mapping — map SCIM groups onto Spatie roles, and how reconciliation stays safe around manually granted roles.