git-repo/agents/README.md

git-repo AI Review Agents (WIP)

Note: This project is a work in progress and is subject to change.

This directory contains configurations and skills for AI review agents that automatically analyze changes in the git-repo codebase.

These agents help maintain code quality, enforce style guidelines, and catch common pitfalls before code is merged.

Directory Structure

• agent_configs.txtpb: Defines the active AI agents, their configurations, and which skills they are equipped with.
• skills/: Contains the "skills" (rules, guidelines, and traps) used by the agents.
  • code_review_workflow/: Guidelines for code review processes, commit messages, and testing.
  • core_internals/: Technical guidelines for git-repo core logic (sync, manifest, git integration, etc.).

How It Works

The agents defined in agent_configs.txtpb are configured to run automatically on new changes. They analyze the diffs against the rules defined in their respective skills and provide feedback in the code review interface (e.g., Gerrit).

Contributing

To improve the agent's review quality or add new rules:

1. Update existing skills: Modify the SKILL.md files under skills/ to add new rules, "What" explanations, "Why" rationales, and "Traps" (Don't/Do code examples).
2. Add new skills:
   • Create a new directory under skills/.
   • Add a SKILL.md following the established format (see existing skills for reference).
   • Register the new skill in agent_configs.txtpb by adding it to the skills field of an agent configuration.