Auth0

Détecter l'intention → détecter le framework → détecter l'outillage → charger 2–3 fichiers de référence.

Étape 1 : Détecter l'intention

Confrontez la demande du développeur à la colonne Ce que le développeur veut — elle décrit l'objectif en langage courant, pas seulement le terme Auth0. Un développeur qui n'a jamais entendu parler de « MFA » mais dit « faire en sorte que les utilisateurs confirment avec un code de leur téléphone » atterrit quand même sur feature:mfa.

La valeur Intent que vous choisissez ici est une clé de recherche : à l'Étape 4 : Charger les fichiers de référence, elle apparaît textuellement en tant qu'en-tête de section (### feature:mfa) qui liste quels fichiers de référence charger.

Étape 2 : Détecter le framework

Ignorez cette étape pour l'intent tooling. Une demande CLI-first / tooling-only n'a pas de framework d'application — allez directement à l'Étape 3, puis chargez la référence tooling. Posez une question sur le framework seulement si le développeur pivote ensuite vers l'intégration d'auth dans une application.

Travaillez de haut en bas. Arrêtez au premier tier qui produit un framework.

Tier 1 — SDK Auth0 déjà installé (signal le plus fort)

Lisez les fichiers du projet. Arrêtez à la première correspondance.

Node.js / JavaScript / TypeScript — vérifiez package.json → dependencies

Les lignes sont ordonnées du plus spécifique au moins spécifique — un projet Ionic/Capacitor porte aussi @auth0/auth0-angular (etc.), donc les lignes @capacitor/browser doivent être vérifiées avant les lignes de framework basiques.

Python — vérifiez requirements.txt ou pyproject.toml

Java / Kotlin — vérifiez build.gradle ou pom.xml

.NET — vérifiez *.csproj ou NuGet.Config

PHP — vérifiez composer.json

Le SDK auth0/auth0-php alimente à la fois les applications web PHP et les API PHP ; le mode est défini en code via SdkConfiguration. Vérifiez ce signal — la ligne STRATEGY_API est plus spécifique, vérifiez-la d'abord.

Si auth0/auth0-php est installé mais qu'aucune stratégie SdkConfiguration n'est définie encore (projet nouveau), passez à la désambiguation variante ci-dessous (intent : construction/protection d'une API → php-api, sinon php).

Go — vérifiez go.mod

Mobile (natif)

Tier 2 — Framework à partir des dépendances non-Auth0 du workspace

Si aucun SDK Auth0 ne correspond, détectez le framework à partir des dépendances ordinaires (non-Auth0). Arrêtez à la première correspondance. Pour les frameworks avec une séparation web vs API, le framework de base est choisi ici ; la variante est résolue dans « Désambiguation de variante » ci-dessous.

Les lignes sont ordonnées du plus spécifique au moins spécifique — un projet Ionic porte aussi @angular/core / vue / react, donc les lignes @ionic/* doivent être vérifiées avant les lignes de framework basiques (même raisonnement que Tier 1).

Remarque react : un projet React basique correspond à react pour une SPA utilisant le SDK React, ou spa-js si l'application est vanilla JS framework-agnostique. Si c'est flou, posez une question avant de charger.

Tier 3 — Framework à partir du prompt

Si aucun signal du workspace ne correspondait, lisez la demande du développeur pour un nom de framework ou de langage et mappez-le ici. Arrêtez à la première correspondance.

Désambiguation de variante (application web vs API)

Certains frameworks ont des références d'application web et API séparées. Quand le Tier 1 n'a pas défini la variante, choisissez intent-first :

Si l'intent est toujours ambigu (à la fois une UI et des endpoints protégés, ou flou), indiquez ce que vous avez détecté et posez une question au développeur sur application web vs API avant de charger.

Si rien ne correspond

Demandez au développeur quel framework/langage il utilise. Ne devinez pas.

Conflits

Si le Tier 2 (workspace) et le Tier 3 (prompt) sont en désaccord matériel (p. ex. le prompt dit « Next.js » mais package.json n'a pas de next), indiquez le conflit et posez une question plutôt que de choisir silencieusement. Les signaux du workspace priment le prompt quand les deux sont présents et cohérents.

Étape 3 : Détecter l'outillage

Lisez l'arborescence des fichiers du projet. Ceci est une décision de contexte de projet, pas une préférence produit.

Étape 4 : Charger les fichiers de référence

Trouvez la section ci-dessous dont l'en-tête correspond à l'Intent que vous avez choisi à l'Étape 1, puis lisez les fichiers de référence qu'elle liste.

integrate

Lire : references/framework-{framework}.md
Lire : references/tooling-{tooling}.md
Suivez le workflow d'intégration dans framework-{framework}.md.
Utilisez tooling-{tooling}.md pour toutes les étapes de configuration du tenant Auth0.

feature:mfa

Lire : references/feature-mfa.md
Lire : references/tooling-{tooling}.md
Si framework détecté : Lire references/framework-{framework}.md (pour le step-up trigger côté SDK)

feature:organizations

Lire : references/feature-organizations.md
Lire : references/tooling-{tooling}.md
Si framework détecté : Lire references/framework-{framework}.md
Si architecture multi-tenant / question de design B2B SaaS : aussi Lire references/pattern-multi-tenant.md

feature:custom-domains

Lire : references/feature-custom-domains.md
Lire : references/tooling-{tooling}.md

feature:acul

Lire : references/feature-acul.md
Lire : references/tooling-{tooling}.md

feature:branding

Lire : references/feature-branding.md
Lire : references/tooling-{tooling}.md

feature:dpop

Lire : references/feature-dpop.md
Lire : references/tooling-{tooling}.md
Si un framework SPA est détecté (vue/react/angular/spa-js) : Lire references/framework-{framework}.md
DPoP est SPA-only (pas de SSR : Next.js/Nuxt) — feature-dpop.md énonce l'exclusion.

guidance

Lire : references/pattern-security.md
Si framework détecté : Lire references/framework-{framework}.md (pour les conseils spécifiques au SDK — stockage des tokens, gestion de session, protection des routes)
Si gestion des tokens / JWT vs opaque / stockage : Lire references/pattern-token-handling.md
Si architecture multi-tenant / B2B : Lire references/pattern-multi-tenant.md + references/feature-organizations.md

debug

Lire : references/pattern-common-errors.md
Si framework détecté : Lire references/framework-{framework}.md

debug:rate-limit

Lire : references/pattern-rate-limiting.md

migrate

Lire : references/feature-migration.md
Lire : references/tooling-{tooling}.md
Si framework détecté : Lire references/framework-{framework}.md

upgrade-sdk

Lire : references/framework-{framework}.md
Suivez sa section « Major Version Migration » (p. ex. Auth0.swift v3, Auth0.Android v4).
Ceci est une mise à niveau de version SDK Auth0 — PAS une migration de fournisseur. Ne chargez pas feature-migration.md.
Si aucun framework n'est détecté : demandez quel SDK Auth0 le développeur met à niveau.

tooling

Lire : references/tooling-{tooling}.md
Pas de fichier framework — ceci est une tâche CLI/tooling-only (créer des applications/APIs, scripter la configuration du tenant,
automatiser la configuration en CI). Si le développeur veut ensuite intégrer auth dans une application, revenez à l'Étape 1 avec l'intent integrate.