Rewrites the scanner instruction to focus on substantive documentation
problems rather than mechanical style violations. Key changes:
- Adds a 4-question self-check gate before any issue is filed
- Explicitly excludes broken links, single time-relative words, feature
gates (Limited Access, Contact sales), and vague verification tasks
- Replaces "max 3 per run" with "file zero if nothing substantive found"
- Elevates cross-document contradiction detection as the primary focus
- Adds "Why this matters" section to issue template to force impact reasoning
- Adds --repo docker/docs to gh commands for correctness outside repo root
Based on analysis of all agent/generated issues to date: borderline
issues like #24266, #24245, #24310 were all single Vale-catchable words;
bad issues like #24617, #24618, #24619 were feature-gate misidentification
and vague verification tasks.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
