organization-management

# Organization Management

**Purpose:** Autonomously implement and configure Clerk organization features for multi-tenant applications with RBAC.

**Activation Triggers:**
- Multi-tenant application requirements
- Organization creation/management needs
- Role-based access control (RBAC) implementation
- Organization switcher/profile components
- Member invitation and management
- Organization-scoped data isolation
- Custom role and permission setup
- Tenant-specific features

**Key Resources:**
- `scripts/setup-organizations.sh` - Enable and configure organizations
- `scripts/configure-roles.sh` - Setup RBAC with custom roles
- `scripts/test-org-isolation.sh` - Test tenant data isolation
- `templates/organization-schema.md` - Multi-tenant database schema patterns
- `templates/rbac-policies.ts` - Role and permission definitions
- `templates/organization-switcher.tsx` - Organization switcher component
- `examples/multi-tenant-app.tsx` - Complete multi-tenant application
- `examples/org-admin-dashboard.tsx` - Organization admin interface

## Implementation Workflow

### 1. Enable Organizations in Clerk Dashboard

Before implementing organization features, enable them in your Clerk Dashboard:

```bash
# Run setup script to guide through Clerk Dashboard configuration
./scripts/setup-organizations.sh
```

**Manual steps (documented in script):**
1. Go to Clerk Dashboard → Organization Settings
2. Enable "Organizations" feature
3. Configure organization creation settings
4. Set up default roles (admin, member)
5. Configure organization metadata fields (if needed)

### 2. Configure RBAC (Role-Based Access Control)

```bash
# Setup custom roles and permissions
./scripts/configure-roles.sh [basic|advanced|custom]

# Examples:
./scripts/configure-roles.sh basic       # Admin + Member only
./scripts/configure-roles.sh advanced    # Admin + Manager + Member + Viewer
./scripts/configure-roles.sh custom      # Interactive custom role creation
```

**Outputs:**
- RBAC policy TypeSc