UMS: note the cross-repo citation merge-order trap

[d-morrison]

Summary

• Adds a short note to shared/workflow/challenge-ambiguous-terminology.md: citing a specific file path in another repo's not-yet-merged PR is itself unverifiable, and will 404 a link checker. Cite the repo generically until the referenced PR merges, then tighten.

Context

Captured from ai-config#324 / gha#151's own review loop: the guideline caught this exact pattern twice while being added to gha's CLAUDE.md — the cited file only existed on ai-config#324, which hadn't merged yet, so both a direct link (404 in lychee) and a bare path citation got flagged by the reviewer as instances of the very anti-pattern the guideline warns against.

Test plan

• Doc-only fragment edit; no CI-affecting code touched.

---

Generated by Claude Code

[claude]

The pronoun "it" in "once it resolves" is ambiguous — "it" could refer to "the referenced PR", "the citation", or "the situation" — and "resolves" is not the usual verb for a PR lifecycle event (PRs "merge" or "close", not "resolve"). Prefer the explicit subject:

Suggested change

	until the referenced PR merges, then tighten the citation to the specific path
	once the referenced PR merges. (Caught by this very guideline, twice, while adding it to

Or, to keep the two-clause structure intact:

...then tighten the citation to the specific path once the referenced PR merges.

[claude]

Claude finished @d-morrison's task in 1m 12s —— View job

---

Review

• Gather context
• Read current diff
• Verify pronoun fix from prior review
• Check for new issues
• Post findings

---

Clean — prior nit addressed, no new findings.

The prior review (2026-07-01T21:58:53Z) found one nit: "once it resolves" at line 24 was ambiguous ("it") and used "resolves" for a PR lifecycle event. That finding still stands — and commit 00e6cb0 correctly addresses it.

Verification of the fix: Line 24 now reads:

until the referenced PR merges, then tighten the citation to the specific path.

Explicit subject, idiomatic verb — exactly what the suggestion called for.

No new issues. The remaining "it" on line 26 ("the file it pointed at") refers to the citation being made, which is the subject of the whole parenthetical; clear in context and not the same ambiguity as "once it resolves." Content is accurate, the gha#151 reference is corroborated by the PR body, and no hallucinated paths or fabricated symbols were found.