docs: track CLAUDE.md instructions in the repo - #69
Merged
juemerson-at-purestorage merged 2 commits intoAug 13, 2026
Merged
Conversation
These three files (repo root, .github/workflows/, Tests/) existed only in local working trees -- never committed on any branch, despite the root file describing itself as repo-committed guidance safe to publish. Adds them to version control so they're actually visible to collaborators, plus a new root-level section on regenerating Reports/ drift-report artifacts whenever a commit changes cmdlet parameter/endpoint coverage (learned the hard way finishing PR dmann000#51 this session).
The original three files were written before the issue-dmann000#63 CI work landed, so they described a repo whose test entry point and gates no longer match. Nothing in them was wrong; they were silent about the parts most likely to red a build. Tests/CLAUDE.md gains the CI entry point, with the correction that -Edition selects which coverage baseline to measure against rather than which interpreter runs -- so each edition needs its own host. Also the coverage gate (MaxSkipped as a ceiling with headroom, RequiredDescribes for blocks that skip gracefully and so contribute neither a pass nor a skip), why the two editions differ by design, the gitignored tools/specs cache the tooling tests depend on, and the -Confirm:$false requirement for ConfirmImpact=High cmdlets. .github/workflows/CLAUDE.md gains the merge-commit semantics of pull_request runs: a green run goes stale when main moves with no branch change, and a manual re-run replays the recorded SHA rather than re-measuring, so it cannot clear a stale result. CLAUDE.md gains a before-you-push section pointing at both, and the standing rule that version bumps and CHANGELOG edits are a separate maintainer decision rather than part of a feature PR. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
juemerson-at-purestorage
force-pushed
the
docs/track-claude-md-files
branch
from
August 13, 2026 21:00
a031e3c to
4b019f5
Compare
Collaborator
Author
|
Rebased onto current Added, in a second commit so the rebase and the new content stay separable:
Still additive only — no existing file is modified, since none of these three exist on |
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
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
CLAUDE.md(repo root),.github/workflows/CLAUDE.md, andTests/CLAUDE.mdexisted only in local working trees -- never committed on any branch, despite
the root file describing itself as repo-committed guidance safe to publish.
This adds all three to version control so they're actually visible to
collaborators.
Also adds one new section to the root file: regenerate
Reports/drift-reportartifacts in the same commit whenever cmdlet parameter/endpoint coverage
changes, and merge/rebase onto current
mainfirst (to avoid mixing in anunrelated spec-version bump) -- a real gap found finishing PR #51 this session.
No code changes.
Test plan