Audit System Overview

Static-first docs infrastructure audit system for quality, performance and maintainability.

Purpose

This audit system provides one repeatable command for repository-wide docs health:

• performance hotspots (scripts/report footprint)
• route/link integrity and legacy path drift
• stale or placeholder content risk
• UK English and style consistency for English v2 docs
• component-layout governance by page type
• conservative cleanup recommendations with quarantine-first workflow

Default Operating Mode

Use static and report-synthesis mode first. It is faster, deterministic and safe for routine use.

node operations/scripts/dispatch/governance/repo/repo-audit-orchestrator.js --mode static --scope full

Canonical Inputs and Outputs

The AI-tools registry is the canonical inventory/lifecycle surface for ai-tools/**, but the audit system still uses its existing subsystem-specific catalog and manifest below.

Inputs:

• ai-tools/registry/ai-tools-registry.json (AI-tools inventory + lifecycle reference)
• ai-tools/ai-skills/catalog/skill-catalog.json
• ai-tools/ai-skills/catalog/execution-manifest.json
• docs.json
• existing reports under workspace/reports/

Outputs:

• workspace/reports/repo-ops/repo-audit-summary.json
• workspace/reports/repo-ops/repo-audit-summary.md
• per-stage reports in workspace/reports/repo-ops/

Policy Defaults

• Cleanup: classify only by default; no deletion; quarantine only when explicitly requested.
• Language: enforce EN-GB style in English v2 pages in phase 1.
• Agent portability: generate packs from one source catalog.

Entry Points

• Orchestrator: operations/scripts/dispatch/governance/repo/repo-audit-orchestrator.js
• Pipeline manifest: ai-tools/ai-skills/catalog/execution-manifest.json (audit subsystem only)
• Skill catalogue: ai-tools/ai-skills/catalog/skill-catalog.json (audit subsystem only)
• Global AI-tools registry: ai-tools/registry/ai-tools-registry.json