Document — Update Project Documentation

To keep project documentation in sync, you can audit and update README.md and AGENTS.md files against the current codebase. This process validates repository conventions and guides targeted updates for affected directories based on recent changes.

Auditing a README for codebase consistency involves validating it against the current code structure and repo-level conventions. The process reads CLAUDE.md and per-directory docs to identify inconsistencies and produce actionable alignment steps.

To update project documentation for a specific directory, run the audit with an optional path argument like src/ingestion. This scopes the documentation synchronization to that portion of the repository, targeting only updates relevant to that directory.

Your AGENTS.md file has stale conventions because it was not synchronized after recent code changes. Scope-aware auditing determines affected directories from recent repository changes and identifies inconsistencies to guide targeted documentation updates.

Yes, you can discover and validate repo-level conventions by reading CLAUDE.md, README.md, and per-directory docs to assemble a holistic audit. This documentation discovery process enforces consistency across the entire repository structure.