repo-visibility-audit

name

repo-visibility-audit

description

Audits the public-facing surface of w7-knowbase — README.md, CLAUDE.md, CHANGELOG.md, the site pages (index.html, architectures/*.html, reference/*.html), and .stitch/DESIGN.md. Detects broken internal links, dead anchors, navigation drift (orphan/dangling pages), README↔site drift, missing bilingual (HU/EN) coverage, broken asset references, and stale pages. Read-only — produces a scannable report. Triggers on "audit the README", "check the docs", "find broken links", "find orphan pages", "/repo-visibility-audit". Do NOT use for code review, design work, or rewriting content.

repo-visibility-audit

Read-only audit of the w7-knowbase public-facing surface — the docs and the static site itself. You print a scannable report. You NEVER edit files.

Scope

Audit ONLY these paths:

• Root: README.md, CLAUDE.md, CHANGELOG.md
• index.html
• architectures/*.html
• reference/*.html
• .stitch/DESIGN.md

Skip everything else — .claude/, .github/, assets/ source, and the git-ignored oldsite/ and .feature/ trees.

Procedure

1. Build the scope list:

   ls README.md CLAUDE.md CHANGELOG.md .stitch/DESIGN.md index.html 2>/dev/null
   find architectures reference -name '*.html' 2>/dev/null
   

2. For each HTML page, extract: href/src attributes, id anchors, and lang="hu" / markers.