Skip to content

docs: scope Linear reporting to this project and pin Closes-line discipline - #346

Merged
ichoosetoaccept merged 1 commit into
mainfrom
linear-scope-closes-discipline
Aug 5, 2026
Merged

docs: scope Linear reporting to this project and pin Closes-line discipline#346
ichoosetoaccept merged 1 commit into
mainfrom
linear-scope-closes-discipline

Conversation

@ichoosetoaccept

@ichoosetoaccept ichoosetoaccept commented Aug 5, 2026

Copy link
Copy Markdown
Member

Summary

Two repo-local rules in CLAUDE.md:

  1. Linear queries from this repo filter to the copier-uv-bleeding project, not the whole DOT team.
  2. Re-check a PR body's Closes/Refs lines 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_issues returns 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-NNN and deliberately does not close on Refs. #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. prek hooks (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-bleeding project, 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 separate Closes DOT-NNN and Refs DOT-NNN behaviors. No defects were found.

Confidence Score: 5/5

T-Rex T-Rex Logs

What T-Rex did

  • Ran the review-authored checker against the parent CLAUDE.md and the updated CLAUDE.md; the parent failed due to missing Linear guidance, while the updated version passed after identifying the copier-uv-bleeding project filter and distinct Closes DOT-NNN and Refs DOT-NNN conventions.
  • Reviewed the executable script named linear-guidance-check.py to confirm it extracts the Issue Tracking contract and asserts the required project filter and Closes/Refs semantics.
  • Compared the before and after logs to verify the pre-capture failure turned into a passing post-capture state.
  • Mapped the supporting artifacts to verify the above conclusions, including the checker results and the linear guidance script and logs.

View all artifacts

T-Rex Ran code and verified through T-Rex

Reviews (1): Last reviewed commit: "docs: scope Linear reporting to this pro..." | Re-trigger Greptile

…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.
@linear-code

linear-code Bot commented Aug 5, 2026

Copy link
Copy Markdown

DOT-620

@ichoosetoaccept

Copy link
Copy Markdown
Member Author

@ichoosetoaccept
ichoosetoaccept merged commit b0004bf into main Aug 5, 2026
7 checks passed
@ichoosetoaccept
ichoosetoaccept deleted the linear-scope-closes-discipline branch August 5, 2026 23:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant