docs(install): add empty-folder verify steps for v0.8.0 install paths#485
Merged
Conversation
After install (or after any new install), users can confirm both halves of the v0.8.0 surface independently in an empty directory: 1. CLI path — npm install -g specorator + specorator --version + specorator init (with --dry-run preview). Plus a one-liner to surface the sigstore provenance attestation on the published tarball. 2. Plugin path — /plugin marketplace add Luis85/agentic-workflow + /plugin install specorator@specorator-marketplace. This is the end-to-end test for the orphan dist/claude-plugin branch (git-subdir marketplace source per ADR-0043). Helps adopters self-validate after npmjs.com or marketplace configuration changes, and gives the next release operator a fast post-publish smoke test. ADR-0044 is referenced as an absolute main-branch URL because the backmerge into develop is still in flight (PR #483). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Extend `docs/how-to/install-claude-plugin.md` § Verify with a hands-on "end-to-end test in an empty folder" subsection so adopters and the next release operator can self-validate v0.8.0 install paths independently.
Two paths, each exercising an independent half of the v0.8.0 surface:
Why
After the v0.8.0 release cycle, the new install surface relies on:
Both are silent until something asks for them. A documented test sequence in an empty folder gives the operator a fast post-publish smoke test and gives downstream adopters a self-validation path after any marketplace or registry config change.
Note on ADR-0044 link
ADR-0044 landed on `main` via the v0.8.0 promotion (#482) but has not yet backmerged into `develop` (#483 still open). The doc cross-link uses an absolute GitHub URL pointing at `main` until the backmerge lands. `check:links` is green.
Test plan
🤖 Generated with Claude Code