diff --git a/install/eng-desktop.sh b/install/eng-desktop.sh
index 43ac457..4fd81c5 100755
--- a/install/eng-desktop.sh
+++ b/install/eng-desktop.sh
@@ -58,6 +58,8 @@ echo
 echo "  Next:"
 echo "  1. cd to any project"
 echo "  2. Run: claude"
-echo "  3. Type /smo to see autocomplete (17 commands should appear)"
+echo "  3. Type /smo to see autocomplete (27 commands should appear: 20 smorch-dev + 7 smorch-ops)"
 echo "  4. Run /smo-health to verify server connectivity"
+echo "  5. READ THIS BEFORE YOUR FIRST PR: $REPO_DIR/docs/guides/06-TEAM-USER-GUIDE.md"
+echo "     (Team OS Guide — 25 min, 12 scenarios, the way SMOrchestra builds)"
 echo
diff --git a/install/qa-machine.ps1 b/install/qa-machine.ps1
index ab9352b..6e80a65 100644
--- a/install/qa-machine.ps1
+++ b/install/qa-machine.ps1
@@ -184,6 +184,8 @@ Write-Host ""
 Write-Host "  Next:"
 Write-Host "  1. cd to any project dir"
 Write-Host "  2. Run: claude"
-Write-Host "  3. Type /smo to see 17 commands in autocomplete"
+Write-Host "  3. Type /smo to see 27 commands in autocomplete (20 smorch-dev + 7 smorch-ops)"
 Write-Host "  4. First QA task: /smo-qa-handover-score on any pending handover"
+Write-Host "  5. READ THIS BEFORE YOUR FIRST QA RUN: docs/guides/06-TEAM-USER-GUIDE.md"
+Write-Host "     (Team OS Guide — 25 min; Parts 4 + 6 + Scenarios 8 and 11 are QA-critical)"
 Write-Host ""