merge: fix docs check worktree scope

Author: ly028716

scripts/check_docs.py

@@ -31,6 +31,8 @@ def check_repository(root: Path) -> list[str]:
     errors: list[str] = []
     for markdown_file in sorted(root.rglob("*.md")):
         relative_file = markdown_file.relative_to(root)
+        if {".git", ".worktrees", "worktrees"}.intersection(relative_file.parts):
+            continue
         if relative_file.parts[:2] == ("docs", "superpowers"):
             continue
         try:

tests/test_docs_integrity.py

@@ -52,3 +52,14 @@ def test_check_repository_ignores_development_archive(tmp_path: Path) -> None:
     )
 
     assert check_repository(tmp_path) == []
+
+
+def test_check_repository_ignores_linked_worktrees(tmp_path: Path) -> None:
+    linked_worktree = tmp_path / ".worktrees" / "other-checkout"
+    linked_worktree.mkdir(parents=True)
+    (linked_worktree / "README.md").write_text(
+        "[Historical link](docs/no-longer-current.md)\n",
+        encoding="utf-8",
+    )
+
+    assert check_repository(tmp_path) == []