naftiko: 1.0.0-alpha2
info:
  label: Clerk B2B SaaS Workflow
  description: 'Multi-tenant B2B SaaS workflow composition for Clerk: organizations, memberships, custom roles, role sets, organization invitations, SAML/enterprise SSO, and domain-based auto-join.'
  tags:
  - Clerk
  - Workflow
  - B2B SaaS
  - Organizations
  - Multi-Tenant
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys:
    CLERK_SECRET_KEY: CLERK_SECRET_KEY
imports:
- ./clerk-backend-api-organizations.yaml
- ./clerk-backend-api-organization-memberships.yaml
- ./clerk-backend-api-organization-invitations.yaml
- ./clerk-backend-api-organization-roles.yaml
- ./clerk-backend-api-organization-permissions.yaml
- ./clerk-backend-api-organization-domains.yaml
- ./clerk-backend-api-role-sets.yaml
- ./clerk-backend-api-saml-connections.yaml
- ./clerk-backend-api-enterprise-connections.yaml
capability:
  description: |
    Composes the multi-tenant B2B SaaS pattern in Clerk:
      1. createOrganization for tenant bootstrap.
      2. Configure roles via Role Sets, custom permissions, and createOrganizationDomain for auto-join.
      3. createOrganizationInvitation to invite teammates; updateOrganizationMembership to elevate roles.
      4. createSAMLConnection / Enterprise Connections for IdP federation, SCIM directory sync.