diff --git a/docs/SESSION-XCODE.md b/docs/SESSION-XCODE.md
index 37fa621..dd35c9c 100644
--- a/docs/SESSION-XCODE.md
+++ b/docs/SESSION-XCODE.md
@@ -105,7 +105,9 @@ fois, dans le navigateur.
 ## Étape 4 — Activer la capability dans Xcode
 
 ```bash
-open ios/App/App.xcworkspace
+# Capacitor 8 utilise Swift Package Manager : il n'existe PAS de
+# .xcworkspace (celui-ci supposait CocoaPods). On ouvre le .xcodeproj.
+open ios/App/App.xcodeproj
 ```
 
 Pour **chacune** de ces trois targets (colonne de gauche → projet **App** →
diff --git a/docs/routine-watch-runbook-mac.md b/docs/routine-watch-runbook-mac.md
index 3420bc7..8bd8360 100644
--- a/docs/routine-watch-runbook-mac.md
+++ b/docs/routine-watch-runbook-mac.md
@@ -53,7 +53,7 @@ watchOS. Modifier la routine côté web ne demande donc aucun rebuild.
 # Xcode FERMÉ (règle COWORK)
 cd ~/coach-ios && git pull
 npm install && npx cap sync ios
-open ios/App/App.xcworkspace
+open ios/App/App.xcodeproj
 ```
 
 ### 2. Rien à ajouter dans Xcode
diff --git a/docs/widgets-runbook-mac.md b/docs/widgets-runbook-mac.md
index 34e38ca..7a7da54 100644
--- a/docs/widgets-runbook-mac.md
+++ b/docs/widgets-runbook-mac.md
@@ -34,7 +34,8 @@ créer `group.ch.hypnotruck.coach` (si pas déjà créé).
 
 ### 2. Activer la capability sur les 2 cibles (Xcode)
 ⚠️ **Quitter puis `git pull`** d'abord (règle COWORK : jamais de pull Xcode ouvert).
-Ouvrir `ios/App/App.xcworkspace`, puis pour **App** ET **CoachLiveActivity** :
+Ouvrir `ios/App/App.xcodeproj` (pas de `.xcworkspace` : Capacitor 8 passe par
+Swift Package Manager, plus par CocoaPods), puis pour **App** ET **CoachLiveActivity** :
 - onglet **Signing & Capabilities** → **+ Capability** → **App Groups** →
   cocher `group.ch.hypnotruck.coach`.
 - Vérifier que `CODE_SIGN_ENTITLEMENTS` pointe bien sur le bon `.entitlements`