AGENTS.md@docs/audit git:20260827.343734dA

Immutable. This exact content is served forever at /api/v1/blob/137f95668e3dcb87.

# Audit reports — agent guide

> Companion to [`README.md`](README.md).

## Purpose

`docs/audit/` holds generated audit reports and dated point-in-time session
receipts (`DEEP_PASS_*`, `PROJECT_STATE_REPORT_*`, offline verification
receipts). Do not place those at the repository root — consistency linters
scan root Markdown as long-lived documentation.

Currently tracked:

- filepath/reference audit from
  [`scripts/audit/audit_filepaths.py`](../../scripts/audit/audit_filepaths.py)
- dated offline verification receipts (see [`README.md`](README.md) files table)

Treat every checked-in `.md` report as a snapshot, not a hand-authored guide.

## Working here

- **Never hand-edit `filepath-audit-report.md`.** Regenerate it with
  `uv run python scripts/audit/audit_filepaths.py` and commit the new
  output as a whole.
- If you add another generated audit report to this directory, list it in
  `README.md`'s table and name the generator script that produces it.
- This directory is distinct from `scripts/audit/` (the generator code) and
  from `output/` (disposable, gitignored pipeline artifacts) — reports here
  are intentionally tracked as point-in-time records.