mirror of
https://github.com/mod-playerbots/azerothcore-wotlk.git
synced 2026-03-01 14:57:48 +00:00
docs(Agents): Configure AI PR review to enforce CLAUDE.md and wiki standards (#24655)
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: Kitzunu <24550914+Kitzunu@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
60
.github/agents/README.md
vendored
Normal file
60
.github/agents/README.md
vendored
Normal file
@@ -0,0 +1,60 @@
|
||||
# GitHub Agents Configuration
|
||||
|
||||
This directory contains configuration files for AI-powered code review and development agents used in the AzerothCore project.
|
||||
|
||||
## Overview
|
||||
|
||||
Agent configuration files provide context-specific instructions to AI tools (like GitHub Copilot, Claude, etc.) when they interact with this repository. These configurations ensure that automated reviews and code suggestions follow project-specific standards and best practices.
|
||||
|
||||
## Available Agents
|
||||
|
||||
### PR Reviewer (`pr-reviewer.md`)
|
||||
|
||||
The PR Reviewer agent is configured to review pull requests with deep understanding of AzerothCore's:
|
||||
- Architecture patterns (two-server model, scripting system, database structure)
|
||||
- Code style requirements (indentation, line length, formatting)
|
||||
- C++ coding conventions and naming standards
|
||||
- SQL query formatting and database design standards
|
||||
- Commit message conventions (Conventional Commits format)
|
||||
- Testing and validation requirements
|
||||
- Security and quality standards
|
||||
|
||||
**Key Feature**: This agent always references `/CLAUDE.md`, 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 `/CLAUDE.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
|
||||
|
||||
## For Contributors
|
||||
|
||||
If you're using AI tools to assist with contributions:
|
||||
|
||||
1. Familiarize yourself with `/CLAUDE.md` - it contains essential project knowledge
|
||||
2. Review the [C++ Code Standards](https://github.com/azerothcore/wiki/blob/master/docs/cpp-code-standards.md) for C++ contributions
|
||||
3. Review the [SQL Standards](https://github.com/azerothcore/wiki/blob/master/docs/sql-standards.md) for database contributions
|
||||
4. The AI agents will help ensure your changes follow project standards
|
||||
5. Agent feedback should be treated as helpful suggestions that align with maintainer expectations
|
||||
|
||||
## For Maintainers
|
||||
|
||||
To update agent configurations:
|
||||
|
||||
1. Edit the relevant `.md` file in this directory
|
||||
2. Ensure any changes align with documentation in `/CLAUDE.md` and the wiki standards
|
||||
3. Test the updated configuration with a sample PR review
|
||||
4. Commit changes following the project's commit message format
|
||||
|
||||
## References
|
||||
|
||||
- Project guidelines: `/CLAUDE.md`
|
||||
- C++ standards: [C++ Code Standards](https://github.com/azerothcore/wiki/blob/master/docs/cpp-code-standards.md)
|
||||
- SQL standards: [SQL Standards](https://github.com/azerothcore/wiki/blob/master/docs/sql-standards.md)
|
||||
- PR template: `/pull_request_template.md`
|
||||
- Contribution guide: `/.github/CONTRIBUTING.md`
|
||||
Reference in New Issue
Block a user