Repository navigation
docs(claude): never name a document-internal label bare in the personal CLAUDE.md template - #849
Merged
Merged
Conversation
…al CLAUDE.md template A finding, question, step or revision label (F8, f2, A1, r26) means nothing in a reply read without its source document. The template now asks for a short gloss and a link on first mention, and names the kind of label instead of one example so the rule covers every scheme. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rix suite
The suite runs under `set -o pipefail` and matched gate output with
`printf '%s' "$out" | grep -q`. grep -q exits on the first match, so on a
large enough output printf takes SIGPIPE, the pipeline returns non-zero
and a matching assertion is reported as a failure ("printf: write error:
Broken pipe"). Feed grep through a here-string so there is no pipe to break.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he gate-3 suite Five single-quoted PHP fixtures in test_gate_3_external_contract_and_tabs.sh lacked the per-assignment SC2016 suppression the first one carries, so the repo-wide ShellCheck job failed on every PR that touches a shell script. The `$` in those strings is PHP source and must not expand. Co-Authored-By: Claude Opus 5.5 <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
1 participant
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
Adds a short section to
docs/claude/examples/global-CLAUDE.md.example: a label that only exists inside its source document (plan finding, review finding, audit item, question, plan step, revision, scenario number, tracking tag) gets, on first mention in a reply, a short gloss in parentheses and preferably a link.Why
A reply asked what to do with a plan finding that was only named by its label, and a tracking tag was read as a different ticket. A first version of the rule named a single example and did not obviously cover other label shapes, so the section names the kinds of label instead.
Scope
Docs-only: the example template, nothing that is installed into
~/.claude/.🤖 Generated with Claude Code