fix(agents): inspect document suffix before URL fragments

tools/skills/validate-agent-guidance.mjs

@@ -126,7 +126,12 @@ async function packageMentions(rootDir) {
             token.split(/[\/\\]/u).some((part) => part === '.' || part === '..')
         )
             return false;
-        if (/\.(?:md|mdx|txt|json|ya?ml|html?)$/iu.test(token)) return false;
+        if (
+            /\.(?:md|mdx|txt|json|ya?ml|html?)$/iu.test(
+                token.split(/[?#]/u, 1)[0]
+            )
+        )
+            return false;
         if (packages.includes(token)) return true;
         if (token.endsWith('/*') && scopes.has(token.slice(0, -2))) return true;
         return declared.some((name) => {

tools/skills/validate-agent-guidance.test.mjs

@@ -1191,3 +1191,24 @@ test('valid iframe and inert iframe targets pass', async (t) => {
         []
     );
 });
+
+for (const suffix of [
+    '.md#rules',
+    '.md?view=raw#rules',
+    '.txt#rules',
+    '.json#rules',
+]) {
+    test(`package document imports retain suffix guards: ${suffix}`, async (t) => {
+        assert.ok(
+            (
+                await diagnostics(t, {
+                    'package.json': JSON.stringify({
+                        dependencies: { '@angular/core': '*' },
+                    }),
+                    'CLAUDE.md':
+                        '@AGENTS.md\n\nRead @angular/core/docs/extra' + suffix,
+                })
+            ).some((message) => message.includes('additional or inline'))
+        );
+    });
+}