Impeccable

docs/automations/qrmaster-broken-link-cta-checker.md

@@ -0,0 +1,57 @@
+# QRMaster Broken Link + CTA Checker
+
+## Goal
+
+Catch broken internal links and broken conversion CTAs on `main`, especially
+after direct edits without a pull request.
+
+## What It Checks
+
+- Static internal `href` values in source files.
+- Static `router.push("/...")` destinations.
+- Internal links against known Next.js app routes and files in `public/`.
+- CTA-like links such as "Get started", "Create QR", "Start free",
+  "Generate QR", "Pricing", and "Upgrade".
+- Pages that appear to have no obvious CTA link.
+
+## Command
+
+```bash
+npm run check:links
+```
+
+The command prints a JSON report. It exits with a non-zero status if broken
+internal links or broken CTA links are found.
+
+## Known Limits
+
+- Dynamic CMS/blog slugs are allowed by prefix and not fully validated.
+- Runtime-only links built from variables are skipped.
+- External links are not checked by this local script.
+- This is a fast safety check, not a full crawl of the deployed website.
+
+## Codex Automation Prompt
+
+```text
+Run the QRMaster Broken Link + CTA Checker.
+
+Use:
+- docs/automations/qrmaster-broken-link-cta-checker.md
+- scripts/check-links-and-ctas.js
+
+Run npm run check:links. Review the JSON report and summarize:
+1. broken internal links
+2. broken CTA links
+3. important pages without obvious CTAs
+4. concrete fixes with file paths
+
+If the script fails, inspect the listed files and propose the smallest safe fix.
+Do not modify production configuration automatically.
+```
+
+## Success Criteria
+
+- No broken internal links.
+- No broken CTA links.
+- Important marketing, tool, and pricing pages have a clear CTA.
+