AGENTS.md

1# AGENTS.md
2 
3General information about the project is located in the README.md file.
4 
5## Application Creation Guidance
6 
7### MSAL Application Configuration for Apple Devices
8 
9When creating a new application with MSAL authentication, users need to select a tenant configuration:
10 
11- **Workforce** (default): For organizational identities
12  - Follow the instructions detailed under `.clinerules/01-Workforce-tenant-configuration.md`
13- **External**: For customer/partner identities
14  - Follow the instructions detailed under `.clinerules/02-External-tenant-configuration.md`
15 
16#### Key Differences Summary: Workforce vs. External Tenants
17 
18| Aspect | Workforce Tenant | External Tenant |
19|--------|----------------|------------------|
20| **Target Users** | Employees, internal users | Customers, partners, citizens |
21| **Registration** | Admin-managed accounts | Self-service sign-up |
22| **User Flows** | Standard authentication | Customizable sign-up/sign-in flows |
23| **Branding** | Corporate branding | Fully customizable for customer UX |
24| **Identity Providers** | Typically organizational only | Social providers supported |
25| **Tenant Configuration** | Same, but different context | "Accounts in this organizational directory only" |
26| **Authority Endpoint** | Uses tenant ID or common | Uses tenant subdomain |
27| **Use Cases** | Enterprise apps, B2E scenarios | Consumer apps, B2C scenarios |
28 
29## MSAL API usage
30 
31Sample code snippets for both Swift & Objective-C can be found in the file `.clinerules/03-MSAL-API-usage.md`
32 
33## Code style guidelines
34 
35Code style guidelines that AI agents MUST follow when working with this repository can be found in the file `.clinerules/04-Code-style-guidelines.md`
36 
37## Feature flag guidelines
38 
39Feature flag guidance for AI agents when implementing new features for MSAL library are defined in the file `.clinerules/05-Feature-gating.md`
40 
41## Customer Communication
42 
43When interacting with users across **any channel** (GitHub issues, web chat, agent sessions), AI agents should follow these guidelines: `.clinerules/06-Customer-communication-guidelines.md`
44