git:20260827.343734d to git:20260831.ed1e0d1

9 added, 0 removed. Audit A to A.

# 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.

+ ## 2026-08-31 fleet archival note

+ The four root-level `AUDIT_2026-08-30*.md` lane reports were moved here from the

+ repo root on 2026-08-31 (agent-ergonomics fleet pass) — they are untracked

+ working-tree snapshots, not yet in git history, and root Markdown is reserved

+ for long-lived documentation. They are point-in-time audit lanes for

+ 2026-08-30 only; no entry doc links to them as current guidance.

## 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.