Skip to content

docs(windows): Windows install guide + pre-call checklist - #2

Draft
noogalabs wants to merge 3 commits into
mainfrom
docs/windows-install-guide
Draft

noogalabs wants to merge 3 commits into
mainfrom
docs/windows-install-guide

Conversation

@noogalabs

Copy link
Copy Markdown
Owner

DRAFT — HOLD MERGE, review-gated to David. Overnight sprint item #1.

Two operator-facing onboarding docs derived from the live Windows install friction report:

  • PRE-CALL-CHECKLIST.md — shareable before a setup call: accounts, Claude tier guidance ($100/$200, personal sub not API), local-admin-rights requirement (the fix(install): Windows build-tools (vswhere + winget VCTools) + fork-origin migration #1 mid-call blocker), 24/7 always-on.
  • WINDOWS-INSTALL.md — step-by-step: the PATH-refresh gotcha, Node + Git install, VS C++ build tools via winget (matches the install.mjs fix in the sibling PR), Developer PowerShell step, one-line installer, ASCENDOPS_DIR for manual clones, Telegram phone-then-desktop order, sleep/lid power settings.

Complements the Mac-centric SKOOL-INSTALL.md (no overlap). Leak-gate clean (0 markers).

🤖 Generated with Claude Code

Operator-facing onboarding docs derived from a live Windows install
(Maranda call friction report). Closes the Windows-specific gaps the
Mac-centric SKOOL-INSTALL.md does not cover:

- Pre-call checklist: account list, Claude tier guidance ($100/$200,
  personal sub not API), local-admin-rights requirement, 24/7 always-on.
- Windows guide: the PATH-refresh gotcha, Node + Git install, VS C++
  build tools via winget (NOT deprecated windows-build-tools), Developer
  PowerShell step, the one-line installer, ASCENDOPS_DIR for manual
  clones, Telegram phone-then-desktop order, sleep/lid power settings.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
noogalabs added a commit that referenced this pull request Jun 14, 2026
…concile fork-origin onto post-rename repo name (#3)

Reconciles the field-proven Windows installer fix (PR #1, fix/windows-install-mjs,
which got Foothills PM running) onto current main, and adds the Windows guide
(PR #2, docs/windows-install-guide).

install.mjs:
- Replace the dead `npm install -g windows-build-tools` path (package deprecated/
  removed) with vswhere DETECTION + `winget install Microsoft.VisualStudio.2022.
  BuildTools` install. vswhere finds the toolset even when cl.exe isn't on PATH
  (the false "build tools missing" failure mid-install).
- Drop the redundant `cl.exe /?` probe; keep `where cl.exe` + vswhere fallback.
- Update the final C++-error hint (was L613) to the winget command.
- Adopt PR #1's richer isCanonicalOrigin / isForkOrigin fork-migration logic,
  reconciled to the POST-RENAME canonical name noogalabs/ascendops (PR #1 was
  authored pre-rename and referenced noogalabs/ascendops-install).

Guides (WINDOWS-INSTALL.md, PRE-CALL-CHECKLIST.md): install URLs updated to the
canonical noogalabs/ascendops name.

Mac and Linux code paths are byte-untouched (verified: outside the Windows
build-tools hunk and the fork-origin hunk, the file is identical to main).
node --check passes.

Co-authored-by: David Hunter <davidhunter@Davids-Mac-mini.local>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
David Hunter and others added 2 commits June 15, 2026 07:43
…uired

Adds a callout after the Git install step explaining that Git for Windows ships
Git Bash, which the framework uses to run the agent shell scripts, so WSL is not
needed (only an optional alternative). Preempts the common "Windows needs WSL"
assumption for POSIX bash scripts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The guide referenced the pre-rename ascendops-install name in the step-6 install
commands and the ASCENDOPS_DIR path example. The redirect still resolves (raw URL
200s), but a member-facing guide should match the canonical name the README was
already aligned to. No functional change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

1 participant