feat(Agents): structure agents docs with progressive disclosure (#26946)

This commit is contained in:
Francesco Borzì
2026-08-04 09:25:52 +02:00
committed by GitHub
parent c55191a1be
commit 3d5dccf0ca
10 changed files with 127 additions and 84 deletions
+7 -6
View File
@@ -19,18 +19,19 @@ The PR Reviewer agent is configured to review pull requests with deep understand
- Testing and validation requirements
- Security and quality standards
**Key Feature**: This agent always references `/AGENTS.md`, the C++ Code Standards wiki, and the SQL Standards wiki before reviewing any PR.
**Key Feature**: This agent always references `/AGENTS.md`, the matching `.agents/docs/*.md` task guides, the C++ Code Standards wiki, and the SQL Standards wiki before reviewing any PR.
## How It Works
When an AI tool reviews a PR in this repository:
1. The tool reads the appropriate agent configuration from this directory
2. The agent configuration instructs it to read `/AGENTS.md` for full project context
3. For C++ changes, the agent also references the [C++ Code Standards wiki](https://github.com/azerothcore/wiki/blob/master/docs/cpp-code-standards.md)
4. For SQL changes, the agent also references the [SQL Standards wiki](https://github.com/azerothcore/wiki/blob/master/docs/sql-standards.md)
5. The agent applies project-specific rules during review
6. Feedback is provided following the project's conventions and standards
2. The agent configuration instructs it to read `/AGENTS.md` for project context and per-task routing
3. Per AGENTS.md's "Mandatory reading per task", it reads the `.agents/docs/*.md` guides matching what the PR touches
4. For C++ changes, the agent also references the [C++ Code Standards wiki](https://github.com/azerothcore/wiki/blob/master/docs/cpp-code-standards.md)
5. For SQL changes, the agent also references the [SQL Standards wiki](https://github.com/azerothcore/wiki/blob/master/docs/sql-standards.md)
6. The agent applies project-specific rules during review
7. Feedback is provided following the project's conventions and standards
## For Contributors
+2 -1
View File
@@ -5,7 +5,8 @@ You are an expert code reviewer for the AzerothCore project. When reviewing pull
## Required Reading
Before reviewing any PR, you MUST read and follow the instructions in:
- `/AGENTS.md` - Contains comprehensive project architecture, coding standards, build instructions, and PR requirements
- `/AGENTS.md` - Slim index of agent rules, repository layout, and per-task routing to `.agents/docs/`
- The `.agents/docs/*.md` guides matching what the PR's diff touches, per AGENTS.md's "Mandatory reading per task"
- [C++ Code Standards](https://github.com/azerothcore/wiki/blob/master/docs/cpp-code-standards.md) - Detailed C++ coding conventions and style guide
- [SQL Standards](https://github.com/azerothcore/wiki/blob/master/docs/sql-standards.md) - SQL query formatting and database standards