git:20260831.031f1a2 to git:20260831.482d6ce

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

+ On 2026-08-31 (agent-ergonomics round 2), the tracked root-level

+ `_FLEET_REPORT_2026-08-30.md` (git-guards diagnostics lane) was relocated here

+ via `git mv` — root Markdown stays reserved for long-lived entry documentation.

+ The dated `REVIEW_LOG_2026-08-31.md` remains at root as the tracked append-only

+ review log (referenced by TO-DO.md rows).

The two root-level dated session logs `_FLEET_REPORT_2026-08-30.md` and

`REVIEW_LOG_2026-08-31.md` were moved here from the repo root on 2026-08-31

(agent-ergonomics round-2 pass), per the same policy: root Markdown is

reserved for long-lived documentation, and dated lane reports are snapshots.

`TO-DO.md` row `ERG-ENTRY-DOCS-2026-08-31` references

[`REVIEW_LOG_2026-08-31.md`](REVIEW_LOG_2026-08-31.md) at its new path.

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