diff --git a/tools/check-doc-links.js b/tools/check-doc-links.js
index d89d6605..cd0d2152 100644
--- a/tools/check-doc-links.js
+++ b/tools/check-doc-links.js
@@ -196,7 +196,11 @@ function getAnchorsForFile(filePath) {
 async function main() {
   console.log('  → Scanning for broken links and anchors...');
 
-  const files = await glob('**/*.{md,mdx}', { cwd: DOCS_DIR, absolute: true });
+  const files = await glob('**/*.{md,mdx}', {
+    cwd: DOCS_DIR,
+    absolute: true,
+    ignore: ['**/_*/**'], // Ignore underscore directories (archive, planning, etc.)
+  });
   const errors = [];
 
   // Track all resolved paths for duplicate detection