diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 88199773fe..655e981d98 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -190,6 +190,19 @@ microsoft-authentication-library-for-js/ - Write unit tests for new functionality and bug fixes - Document all public API changes +### Instance Aware Flow Restrictions + +**IMPORTANT: The instance aware flow is not supported and should NEVER be suggested or used with this library** + +- **Do not suggest** the `instanceAware` configuration option or `instance_aware` query parameter +- **Do not recommend** instance aware flow in code examples, documentation, or solutions +- If asked about multi-cloud or cloud instance scenarios, provide alternative solutions that do not involve instance aware flow + +**What to Suggest Instead:** +- Standard MSAL authentication flows without instance aware configuration +- Proper authority configuration for the specific cloud environment the application targets +- Separate application registrations for different cloud environments if needed + ### Telemetry and Performance Monitoring **IMPORTANT: Add telemetry for any new operations or significant code paths in msal-browser and msal-common where observability would be useful.**