docs: scope Linear reporting to this project and pin Closes-line discipline - #346
Merged
Merged
Conversation
…ipline Two repo-local rules, both learned the hard way this week. Linear queries from this repo now filter to the `copier-uv-bleeding` project. The DOT team also tracks a macOS app and career/website work, none of it relevant here, and an unfiltered `list_issues` buries eight template issues in sixty rows of noise. The second rule is the DOT-629 post-mortem. Linear's GitHub integration closes on a bare `Closes DOT-NNN` and deliberately does not close on `Refs`. PR #345 carried exactly one tracker line, `Refs DOT-620`, written when the PR held three commits. The testmon fix was appended as a fourth commit afterwards and named DOT-629 nowhere -- not in its own message, not in the body. It shipped in 0.41.13 and the issue stayed in Backlog. The trap is specific to stacked PRs, where the body is written once and the commits keep arriving. So: re-check the body's Closes lines whenever a commit is appended to an open PR.
Member
Author
|
This change is part of the following stack: Change managed by git-spice. |
This was referenced Aug 5, 2026
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
Two repo-local rules in
CLAUDE.md:copier-uv-bleedingproject, not the whole DOT team.Closes/Refslines whenever a commit is appended to an already-open PR.Why
Rule 1 is noise reduction. The DOT team also tracks a macOS app and career/website work. An unfiltered
list_issuesreturns sixty rows to surface the eight that concern this template.Rule 2 is the DOT-629 post-mortem. Linear's GitHub integration closes on a bare
Closes DOT-NNNand deliberately does not close onRefs. #345 carried exactly one tracker line —Refs DOT-620— written when the PR held three commits. The testmon fix landed as a fourth commit afterwards and named DOT-629 nowhere: not in its own message, not in the body. It shipped in 0.41.13 and the issue stayed in Backlog until someone audited by hand.The failure mode is specific to stacked PRs, where the body is written once and the commits keep arriving.
Test plan
Documentation only — no code paths touched.
prekhooks (markdownlint, typos, lychee) pass.Greptile Summary
Adds repository-local Linear guidance for contributors working on this Copier template. The new instructions scope issue searches to the
copier-uv-bleedingproject, distinguish closing references from non-closing references, and remind authors to update issue references when appending work to an open PR.The updated guidance was checked against the previous and current versions of
CLAUDE.md: the new version contains the required project filter and clearly defines the separateCloses DOT-NNNandRefs DOT-NNNbehaviors. No defects were found.Confidence Score: 5/5
What T-Rex did
Reviews (1): Last reviewed commit: "docs: scope Linear reporting to this pro..." | Re-trigger Greptile