---

name: route-auditor-v1 description: Prevent 404s by validating all routes exist and are accessible

Route Auditor Skill v1.0

Purpose: Ensure every route has a valid page and every page has a valid route.

1) Non-Negotiables (Policy)

Routing Rules

• All routes MUST be defined in client/src/App.tsx
• Route path MUST match page filename (without .tsx)
• All pages in client/src/pages/ MUST have a corresponding route
• Lazy loading REQUIRED for all page imports

Forbidden Patterns

• ❌ Dead links (href to non-existent routes)
• ❌ Orphan pages (pages without routes)
• ❌ Duplicate routes (same path defined twice)
• ❌ Missing lazy imports

---

2) Inputs & Outputs

Inputs (When to Run)

• After creating new pages
• After modifying App.tsx
• Before deployment
• As part of PR review

Output Contract

Copy{
  "status": "PASS" | "FAIL",
  "totalRoutes": number,
  "totalPages": number,
  "issues": {
    "orphanPages": ["string"],
    "missingRoutes": ["string"],
    "deadLinks": [
      {
        "source": "string",
        "href": "string"
      }
    ],
    "duplicateRoutes": ["string"]
  }
}

---

3) Quality Gates

Route Integrity Check

Run before any deployment:

Copynpm run guard:routes
npm run guard:route-integrity

Comprehensive Audit

Copytsx scripts/audit-routes.ts

Dead Link Detection (Playwright)

Copynpm run test:e2e -- tests/dead-link-crawler.spec.ts

---

Validation Scripts

Primary Scripts

Sitemap Validation

Copynpm run guard:sitemap

Validates against ANDARA_SITEMAP_V1_3.md

---

Common Issues & Fixes

Orphan Page (page exists, no route)

Copy// In App.tsx, add:
const NewPage = lazy(() => import('./pages/new-page'));
// In routes:
<Route path="/new-page" component={NewPage} />

Dead Link (link to non-existent route)

1. Find the source file containing the bad link
2. Either create the missing page/route, OR
3. Update the link to point to existing route

Duplicate Route

1. Search App.tsx for duplicate path definitions
2. Remove the duplicate
3. Ensure only one component handles the route

---

Integration with CI/CD

These guards run automatically:

Copy{
  "prebuild": "npm run guard:all",
  "guard:routes": "tsx scripts/guard-route-order.ts",
  "guard:sitemap": "tsx scripts/guard-routes.ts"
}

Build FAILS if any route issues detected.