chore: Update agents.md file

[Eric-Warehime]

Description

Updates top level agents file.

[greptile-apps]

Greptile Summary

This PR updates AGENTS.md with improved guidance for automated agents, adding a new dedicated Submodules section with accurate go.mod paths, correcting contrib/ to contrib/x/, adding references to UPGRADING.md and SECURITY.md, restructuring the Development Workflow, and converting the Pull Request Workflow to a checklist. All referenced submodule paths (api, client/v2, collections, tests/systemtests, tools/systemtests, enterprise/poa/simapp, etc.) were verified to exist in the repository.

Confidence Score: 5/5

Documentation-only change with no code modifications; safe to merge.

All changes are confined to AGENTS.md. All submodule paths, directory references, and make targets mentioned in the updated content were verified against the actual repository structure. No logic, config, or generated files are touched.

No files require special attention.

Important Files Changed

Filename	Overview
AGENTS.md	Documentation-only update: restructures agent guidance with a new Submodules section, updated directory paths (contrib/ → contrib/x/), improved changelog format, PR checklist, and streamlined development workflow. All referenced submodule paths verified to exist in the repo.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Agent starts work] --> B{Dependency change?}
    B -- Yes --> C[make tidy-all]
    B -- No --> D[make build]
    C --> D
    D --> E[make lint]
    E --> F[make test / make test-unit]
    F --> G{Breaking change?}
    G -- Yes --> H[Add UPGRADING.md entry + State Machine Breaking stanza]
    G -- No --> I[Add CHANGELOG.md entry under UNRELEASED]
    H --> I
    I --> J{Proto / mock changes?}
    J -- Yes --> K[make proto-all / make mocks]
    J -- No --> L[Open PR with checklist]
    K --> L

Loading

_{Reviews (1): Last reviewed commit: "Update agents.md file" | Re-trigger Greptile}