Skip to content

docs(plugin-philosophy): run local-scope test installs outside a worktree #6409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kyle-sexton merged 3 commits into from
Oct 5, 2026
Merged

docs(plugin-philosophy): run local-scope test installs outside a worktree #6409

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1b3b33c
docs(plugin-philosophy): run local-scope test installs outside a work…
kyle-sexton Oct 5, 2026
5c3da2d
docs(plugin-philosophy): name the source of the local-scope observation
kyle-sexton Oct 5, 2026
e3e0a14
docs(plugin-philosophy): cite the run and the report for the local-sc…
kyle-sexton Oct 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/plugin-philosophy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -912,6 +912,20 @@ path and prerequisite tests, local `--plugin-dir` smoke tests, and the repositor
Apply the standards principles of explicit behavior, fail-fast boundaries, idempotency, one mechanism
per concern, cross-platform operation, and stress-testing before presentation.

Run a test install (`claude plugin install` or `claude plugin marketplace add` with
`--scope local`) from a throwaway folder outside any git repository, never from a linked worktree.
Local scope writes `.claude/settings.local.json`, and in a worktree Claude Code keeps that file at
the main checkout's root, so the install enables the plugin for every session there and outlives the
worktree. Outside a git repository the file stays in the folder you ran from.

- **Pointer:** [Where Claude Code keeps the local file in a git repository](https://code.claude.com/docs/en/settings#where-claude-code-keeps-the-local-file-in-a-git-repository);
[`--scope` names the settings file written](https://code.claude.com/docs/en/plugins/cli-reference).
Observed for `plugin install --scope local` on Claude Code 2.1.289, WSL2, during the
install-and-test run in melodic-software/claude-code-plugins#6318, reported in #6375.
- **As of:** 2026-10-04.
- **Recheck trigger:** that settings section stops placing a worktree's local file at the main
checkout, or a release note changes where `--scope local` writes.

## Instruction economy

Every standing instruction this marketplace ships is a per-session tax on every consumer, paid
Expand Down
Loading