pharaoh-process-audit

Run a full sphinx-needs audit by executing pharaoh-process-audit <project_root>, which orchestrates ten gap category checks and generates a consolidated, prioritised gap report for your entire corpus.

A prioritised gap report consolidates missing requirements and cross-artefact consistency issues across a sphinx-needs corpus. You need one when running a project-wide health check to drive remediation planning.

Yes, you need a built needs.json located at docs/_build/needs/needs.json within your project root. The audit reads this file to evaluate the current corpus across all ten gap categories.

Yes, the audit applies to sphinx-needs projects of any size. It delegates to specialized sub-skills for category-level detection, ensuring scalable and repeatable gap analysis across large corpora.

The best way is running a full-corpus audit via pharaoh-process-audit. It orchestrates ten gap category checks using sub-skills to surface cross-artefact consistency issues and produces a single prioritised report.

The audit fails when needs.json is missing from the expected path. You must build your sphinx-needs project first so the file exists under docs/_build/needs/needs.json before executing the audit.