updating-agent-rules

To keep AGENTS.md in sync, gather the current repository state from files like pyproject.toml and lefthook.yml, identify deltas against the existing documentation, and apply coherent updates to align agent rules with the latest structural changes.

You need to update agent rules documentation when project configuration, tooling, or structural files change, ensuring AGENTS.md accurately reflects the current repository state and maintains consistent frontmatter and section layout.

Yes, this validates references to external files by verifying that files referencing AGENTS.md, including CLAUDE.md and .github/copilot-instructions.md, remain correct and point to valid documentation paths after repository updates.

The best way to maintain consistency is to enforce frontmatter presence, ensure a consistent section layout within AGENTS.md, and automatically verify that downstream referenced docs like CLAUDE.md stay aligned with the updated repository configuration.

Yes, updating AGENTS.md works with configuration sources like mise.toml, pyproject.toml, lefthook.yml, and README.md by gathering their current state to identify deltas and apply coherent documentation updates across the repository.

AGENTS.md frontmatter presence matters because it enforces a consistent section layout and structural validation, ensuring automated agent rules documentation remains parseable and correctly formatted after repository configuration changes.