Skip to content

Onboarding: marketplace only, granular Claude steps sent word for word - #6

Merged
turner merged 1 commit into
mainfrom
onboarding-granular-steps
Nov 7, 2026
Merged

turner merged 1 commit into
mainfrom
onboarding-granular-steps

Conversation

@turner

@turner turner commented Nov 7, 2026

Copy link
Copy Markdown
Collaborator

Why

The setup prompt in Claude Desktop produced a card with three vague steps plus an "Option B: add a custom connector". The assistant had paraphrased our step block and promoted a fallback line into a second route. Hand-added URLs get no updates, which we need while Geenee is in early development.

What changes

  • Marketplace only, everywhere. All hand-added server URL routes are removed from the prompt, README, install page and docs. docs/adr/0001-marketplace-only-distribution.md records why.
  • Eight granular Claude steps, each a click path (Customize → Plugins) with a ✓ check. They cover:
    • the new claude.ai/customize/plugins address
    • add-then-Connect on Geenee's Connectors tab
    • turning on Sync automatically for updates
    • the per-chat + → Connectors switch
    • GitHub Issues when stuck
  • One source for the steps. The README holds the canonical text. INSTALL-PROMPT.md holds a word-for-word copy and tells the assistant to send it unchanged, with no preamble, options or closing checklist. scripts/check-install-steps.sh, which runs in CI as .github/workflows/check.yml, fails if the two copies differ.
  • ChatGPT installs through Codex in the ChatGPT desktop app.
  • GLOSSARY.md is added. docs/install.html, docs/maintaining.md and the plugin README are updated to match.

Still to check

  • Three labels could not be confirmed from Anthropic's docs. The steps are worded so they work either way:
    • the confirm button after typing aidenlab/plugins
    • the Add button on the Connectors tab
    • whether Sync automatically exists for user-added marketplaces
  • The worker's /plugins redirect now points at claude.ai/customize/plugins. It takes effect only after cd install-worker && npx wrangler deploy.

🤖 Generated with Claude Code

- Drop every hand-added server URL route (Claude custom connector,
  ChatGPT custom MCP server, other MCP clients). ADR 0001 records why:
  only marketplace installs get updates.
- Claude: eight arrow-and-check steps (Customize → Plugins, new
  claude.ai/customize/plugins address, add-then-Connect, Sync
  automatically, per-chat + → Connectors switch, GitHub Issues when
  stuck). Canonical in README.md, copied verbatim into INSTALL-PROMPT.md,
  which now tells the assistant to send it word for word with no
  preamble, options or closing checklist.
- scripts/check-install-steps.sh + CI fails if the two copies drift.
- ChatGPT: install through Codex in the ChatGPT desktop app.
- install.html, maintaining.md and the plugin README follow; add GLOSSARY.md.
- Worker /plugins redirect points at claude.ai/customize/plugins
  (needs wrangler deploy).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@turner
turner merged commit 2f618b7 into main Nov 7, 2026
1 check passed
@turner
turner deleted the onboarding-granular-steps branch November 7, 2026 18:48
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