docs/enh: reviewer hallucination of cross-domain references — recurring on glm-5.3-flash (3x in one session)

[rz1989s]

Across today's 7-dispatch SDD run, reviewer subagents fabricated plausible-sounding internal context three separate times: a nonexistent "Brief 05 / Hallmark project", a "roll-up #22", and a "journal-layer seq filter" from a sibling repo. Each time the verdicts were sound and the findings verifiable against the diff — but the fabricated references could easily send a controller chasing phantom artifacts.

Pattern: hallucinated content always references process artifacts (briefs, roll-ups, ledger entries, other repos' fixes) — never invents code findings. Likely the model pattern-matching "reviewer reports reference their inputs" without having those inputs.

Suggestions:

1. Docs (SDD recipe / reviewer template guidance): add a known-issues note — controllers should treat reviewer references to artifacts outside the provided brief/report/diff as suspect and verify findings independently (we now do this, but it cost a whole session to learn).
2. Optional enhancement: reviewer dispatches could end with a structured references block (which input files the review actually relied on) — makes out-of-input references detectable mechanically.

Happy to share the three verbatim hallucination samples if useful for the docs.

[rz1989s]

Disposition — both halves delivered

1. armory-fleet docs half — shipped in PR feat(engine): language-drift flag on subagent result envelopes (#88) #100: README "Model-quality drift signals" section documents the reviewer-reference rule for controllers ("treat references to artifacts outside the provided brief/report/diff as suspect; verify by git + file contents, never prose").
2. SDD reviewer-template half — the template lives in obra/superpowers (third-party upstream):
   • Upstream issue filed: Reviewer template: harden against hallucinated cross-domain references (cheap model tiers) obra/superpowers#2243 (evidence-discipline section + end-at-Assessment, with the 3 verbatim hallucination pattern documented).
   • Local install patched today: task-reviewer-prompt.md now carries the "Evidence discipline" block (ground every finding in brief/report/diff/files-actually-opened; no citing artifacts you weren't given; end at Assessment).

Closing — upstream tracking via obra/superpowers#2243; the structured references block (the issue's optional enhancement) stays deferred until a consumer asks, same call as #85 part 2.