docs(flaky-tests): note automatic PR number detection on CircleCI

[samgutentag]

Summary

• Documents that the Trunk Analytics CLI automatically detects the pull request number from CircleCI environment variables
• No extra configuration is needed for PR-level test attribution on CircleCI

Source

• trunk2 PR: https://github.com/trunk-io/trunk2/pull/3781

Test plan

• Preview in GitBook

---

Generated by Claude Code

[trunk-staging-io]

😎 Merged successfully - details.

[claude]

Claude finished @samgutentag's task in 36s —— View job

---

Review

• Gather context and read changed files
• Review documentation changes

---

The change is a clean, well-placed addition. Here's my assessment:

What the PR does: Adds an info hint block to flaky-tests/get-started/ci-providers/circleci.md (lines 44–46) noting that the Trunk Analytics CLI auto-detects PR context from CircleCI environment variables, so no extra configuration is needed.

Placement: ✅ Correctly positioned right after the "Upload Test Results" step instructions — exactly where a user might wonder if additional PR configuration is needed.

Grammar & spelling: ✅ No errors found.

Formatting: ✅ Uses the GitBook {% hint style="info" %} syntax consistently with the rest of the file.

Minor observation (non-blocking): The phrase "detects PR context from CircleCI environment variables, including the pull request number" is slightly redundant — "PR context" already implies PR number. A tighter alternative could be:

The Trunk Analytics CLI automatically detects the pull request number from CircleCI environment variables. No additional configuration is needed to associate test uploads with the correct PR in Trunk.

But the current wording is perfectly readable and not incorrect, so this is just a style note.

Result: ✅ Approved — no blocking issues.

[github-actions]

Auto-approved: Claude code review passed.

[claude]

Claude finished @samgutentag's task in 51s —— View job

---

Review

• Gather context and read changed files
• Review documentation changes

---

The change adds an {% hint style="info" %} block to flaky-tests/get-started/ci-providers/circleci.md noting that the Trunk Analytics CLI auto-detects PR context on CircleCI.

Placement: ✅ Well-positioned right after the "Upload to Trunk" intro — exactly where a user might wonder if extra PR configuration is needed.

Grammar & spelling: ✅ No errors.

Formatting: ✅ Uses {% hint style="info" %} syntax consistently with the rest of the file.

Minor style note (non-blocking): "PR context... including the pull request number" is slightly redundant — "PR context" already implies PR number. A tighter phrasing is suggested in the inline comment.

Result: ✅ No blocking issues.

[github-actions]

Auto-approved: Claude code review passed.

[samgutentag]

Triage status (2026-05-05): up to date with main. Review approved. Ready to merge.

[claude]

Claude finished @samgutentag's task in 48s —— View job

---

Review

• Gather context and read changed files
• Review documentation changes

---

The change adds an {% hint style="info" %} block to flaky-tests/get-started/ci-providers/circleci.md (lines 44–46) noting that the Trunk Analytics CLI auto-detects PR context — including the pull request number — from CircleCI environment variables.

Placement: ✅ Correctly positioned right after the "Upload to Trunk" step instructions — exactly where a user might wonder if extra PR configuration is needed, and before the existing danger hint about stable branches.

Grammar & spelling: ✅ No errors.

Formatting: ✅ Uses {% hint style="info" %} syntax consistent with the rest of the file. Blank lines around the block are correct.

Accuracy: ✅ Claim aligns with the linked trunk2 PR (#3781).

Minor style note (non-blocking): "PR context... including the pull request number" is slightly redundant — "PR context" already implies the PR number. A tighter alternative:

The Trunk Analytics CLI automatically detects the pull request number from CircleCI environment variables. No additional configuration is needed to associate test uploads with the correct PR in Trunk.

The current wording is perfectly readable, so this is just a style note.

Result: ✅ No blocking issues.
| Branch: sam-gutentag/circleci-pr-number-detection

[github-actions]

Auto-approved: Claude code review passed.