docs(onboarding): one universal paste-to-Claude path for every OS

[jeremylongshore]

What

Rewrites onboarding/README.md so Claude Code / Cowork install is one path on Mac and Windows: paste a short prompt that (1) installs from the public marketplace and (2) writes ~/.teamkb/team.json with the required tenantId. Demotes the macOS .command to a legacy footnote. Changelog Unreleased notes the change.

The live dogfood page (demos.intentsolutions.io/bbb/) was updated in the same pass (not in this repo): Step 3 is the universal prompt; zero links to .cmd / .command / win-setup.ps1.

Why

Plugin install is already cross-platform. The only OS-specific bit was writing team.json, which Claude can do. Dual installers added friction during the team dogfood run; Jeremy asked to rip the OS split.

Chose one paste prompt over keeping dual installers because Max connected end-to-end on the Claude path and the Jul 14 cohort email already used it.

How it works

• Public marketplace: jeremylongshore/bobs-big-brain-plugin → install governed-second-brain@governed-second-brain
• Connection file: ~/.teamkb/team.json with apiUrl, apiToken, tenantId: intent-solutions (required; missing tenant → empty search results)
• Manual expander still available for people who prefer the two /plugin commands

Verification & evidence

• Live page: curl https://demos.intentsolutions.io/bbb/ — Step 3 is the paste prompt; no installer downloads linked
• README reviewed against that page for the same commands + tenantId callout

Risk assessment

Docs-only. Legacy .command still in-tree for operators who want it. Orphaned Windows assets may still sit under ~/demos/bbb/ but are unlinked.

Operational impact

None for runtime. New teammates should use the page / paste prompt, not OS installers.

Follow-up & deferred

• Optionally delete unlinked win-setup.ps1 / .cmd from demos host after a soak
• ope / tim / pablo reissued-token emails still staged if needed

Refs

Resumed from Claude session 69e9d23f-3f83-439a-a6b0-a8f4a78bfdae (weekly limit mid-task).

[gemini-code-assist]

Code Review

This pull request simplifies the onboarding process by introducing a single, universal path for both macOS and Windows via a paste-to-Claude prompt, demoting the macOS-specific installer to a legacy footnote. The review feedback highlights two issues: first, the POSIX permission check on team.json will fail on Windows, preventing the plugin from starting, which requires a fix in src/team-config.ts; second, the onboarding prompt contains a redundant update command that should be removed.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

On Windows, Node's fs.statSync().mode does not map to POSIX permissions in a way that allows mode & 0o077 to be 0. By default, Node.js on Windows simulates permissions where group/world read/write bits are always set (resulting in a mode like 0o666 or 0o444).

As a result, the permission check in src/team-config.ts (line 103):

if ((mode & 0o077) !== 0) {

will always evaluate to true on Windows, causing the plugin to refuse to start with a TeamConfigError under all circumstances.

To fix this, src/team-config.ts needs to be updated to bypass or handle this check differently on Windows (e.g., checking process.platform !== 'win32'). Since src/team-config.ts is not modified in this PR, you will need to submit a change to that file as well to make this universal onboarding path actually work on Windows.

[gemini-code-assist]

The command claude plugin marketplace update governed-second-brain is redundant and likely invalid because governed-second-brain is the plugin name, not a marketplace name. For a fresh installation, adding the marketplace and installing the plugin is sufficient, as shown in the manual steps below.

Suggested change

	1) Add and install the plugin from the public marketplace (no GitHub login needed):
	claude plugin marketplace add jeremylongshore/bobs-big-brain-plugin
	claude plugin marketplace update governed-second-brain
	claude plugin install governed-second-brain@governed-second-brain
	1) Add and install the plugin from the public marketplace (no GitHub login needed):
	claude plugin marketplace add jeremylongshore/bobs-big-brain-plugin
	claude plugin install governed-second-brain@governed-second-brain