fix(phpcs): stop the SpecTagSniff instructing the pattern gate-46 rejects

[rubenvdlinde]

Two tools in the same pipeline gave OPPOSITE instructions about where an
@spec tag should point, and following the one that runs FIRST manufactured
findings for the one that runs SECOND.

SpecTagSniff runs as a blocking PHP Quality (phpcs) job and told every
developer, in its file docblock and in its own warning text:

@spec openspec/changes/{change-name}/tasks.md#task-N

A change directory is temporary by definition — completing a change moves it
to openspec/changes/archive/<date>-<name>/, and renaming or dropping one
removes the target outright. Every tag written to that instruction dangles
from that moment on, and gate-46 (spec-anchor-existence) reports it. The
developer who wrote the tag had followed this sniff's own advice.

Measured on portaliq: 100 unresolved gate-46 targets, and 260 of its 385 live
tags pointing into a change directory. The sniff ships identically in 20
ConductionNL repos, so grinding the tags without fixing the sniff regenerates
them at the rate changes are archived.

This changes the docblock example and BOTH warning messages to the canonical
form gate-46 and the project rule agree on:

@spec openspec/specs/{capability}/spec.md#requirement-{slug}

The method-level message previously carried no guidance at all, so a developer
reading it had only the class message to copy from; it now names the same
canonical shape.

Behaviour is unchanged: severity stays WARNING (verified via phpcs — an
untagged class and public method still report 0 errors / 2 warnings, and a
tagged file still reports nothing), and an openspec/changes/... target is
still accepted, since this sniff only checks that a tag is PRESENT.

No @spec tags are repointed here — this repo's existing tags are untouched.

Refs ConductionNL/.github#228

[github-actions]

Quality Report — ConductionNL/softwarecatalog @ 9baf9e9

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
check-vue-demi		✅
test-l10n		✅
composer			✅	✅ 128/128
npm			✅	✅ 718/718
PHPUnit					✅
Newman					⏭️
Playwright					✅
Hydra gates					✅

---

Quality workflow — 2026-08-08 14:19 UTC

Download the full PDF report from the workflow artifacts.