From e68f20644b74cd81a8598190ffde6ed0e7fbf275 Mon Sep 17 00:00:00 2001
From: alamouri99 <mamoun.alamouri99@gmail.com>
Date: Thu, 28 May 2026 03:06:34 +0400
Subject: [PATCH] =?UTF-8?q?chore(install):=20bump=20command=20count=2017?=
 =?UTF-8?q?=20=E2=86=92=2027=20+=20add=20Guide=2006=20Day-1=20reference?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

INFRA TOUCH — separate PR per ~/.claude/rules/infra-guard.md.

Two files changed:
  install/eng-desktop.sh  — Mac / Linux engineering desktop
  install/qa-machine.ps1  — Windows QA machine

Two diffs per file:
  1. "17 commands should appear" → "27 commands should appear: 20 smorch-dev + 7 smorch-ops"
     (Reflects actual v1.6.0 surface — was stale at v1.4 count.)
  2. New final Next step:
       eng-desktop.sh: "5. READ THIS BEFORE YOUR FIRST PR: docs/guides/06-TEAM-USER-GUIDE.md"
       qa-machine.ps1: "5. READ THIS BEFORE YOUR FIRST QA RUN: docs/guides/06-TEAM-USER-GUIDE.md"

Rationale:
- New hires currently get install → "Next: cd to project, run claude". No
  pointer to the OS guide. Guide 06 is the Day-1 reading per docs/INDEX.md
  Start-here matrix; the install should surface it mechanically.
- 27-vs-17 count drift is the kind of silent rot lessons.md was written for.
- Zero behavior change to the install pipeline. Just two echo lines + one count.

Servers (dev-server.sh + prod-server.sh) NOT touched — servers don't have
human readers mid-bootstrap and don't install smorch-dev (smorch-ops only).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 install/eng-desktop.sh | 4 +++-
 install/qa-machine.ps1 | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

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 ""