Skip to content

chore(install): bump command count 17→27 + add Day-1 Guide 06 reference (infra)#17

Merged
smorchestraai-code merged 1 commit into
mainfrom
chore/install-scripts-post-v1.6
May 27, 2026
Merged

chore(install): bump command count 17→27 + add Day-1 Guide 06 reference (infra)#17
smorchestraai-code merged 1 commit into
mainfrom
chore/install-scripts-post-v1.6

Conversation

@smorchestraai-code

Copy link
Copy Markdown
Member

Summary

Bring install scripts in line with v1.6.0 reality + add Guide 06 as final 'Next' step.

Why separate PR

Per ~/.claude/rules/infra-guard.md: 'Create a separate PR for infra changes — never bundle with feature code.' These are infra (bootstrap pipeline) touches. Not bundled with the docs PR that fixed the same count in guides.

What changes (~6 lines)

install/eng-desktop.sh

  • Line 61: 17 commands27 commands (20 smorch-dev + 7 smorch-ops)
  • Add line 62-63: 'READ THIS BEFORE YOUR FIRST PR: docs/guides/06-TEAM-USER-GUIDE.md'

install/qa-machine.ps1

  • Line 187: 17 commands27 commands (20 smorch-dev + 7 smorch-ops)
  • Add line 188-189: 'READ THIS BEFORE YOUR FIRST QA RUN: docs/guides/06-TEAM-USER-GUIDE.md'

Risk: zero

  • No behavior change to the install pipeline (echoes only)
  • No env vars, no secrets, no CI/CD touched
  • Server install scripts (dev-server.sh + prod-server.sh) NOT touched (servers don't read text during bootstrap; smorch-ops only on servers per install matrix)

Test plan

  • CI validate.yml passes
  • Next engineer install run displays '27 commands' + Guide 06 pointer
  • Next QA machine install run displays '27 commands' + Guide 06 pointer

🤖 Generated with Claude Code

…ence

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>
@smorchestraai-code smorchestraai-code merged commit dbae186 into main May 27, 2026
1 check passed
@smorchestraai-code smorchestraai-code deleted the chore/install-scripts-post-v1.6 branch May 27, 2026 23:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants