gerrit.googlesource.com/gerrit/ (link)

# AI Agent Project Profile: gerrit

## Project Overview

Gerrit is a web-based code review system for Git. Backend is Java 21, frontend is TypeScript/Lit components, built with Bazel.
The bazel version to be used can be read from the `.bazelversion` file.

## Sub-projects

- **`polygerrit-ui`**: The frontend web application. See `polygerrit-ui/AGENTS.md` for details on the frontend development environment.

## Build tool selection

If `bazelisk` is installed, use `bazelisk` instead of `bazel` for all build

# AI Agent Project Profile: gerrit/polygerrit-ui

This document provides a summary of the front-end development environment for the `polygerrit-ui` part of the gerrit project.

## Overview

- **Framework**: The project is built with Web Components, using Lit
- **Language**: TypeScript
- **Build Tool**: Bazel is the primary build tool for the overall project.
- **Testing**:
  - **Runner**: `@web/test-runner`
  - **Framework**: `mocha`
  - **Assertions/Mocks**: `sinon`, `@open-wc/semantic-dom-diff`
  - **Brow

---
name: gerrit-hygiene-operations
description: Provides rules, patterns, and best practices for code hygiene, formatting, downstream plugin dependencies, and release operations in Gerrit.
---

# Gerrit Hygiene & Operations Engineering Guide

## Executive Summary

Welcome to the authoritative engineering guide for maintaining code hygiene,
managing downstream deployments, and optimizing operations within the codebase.
This living repository serves as the definitive source of tribal knowledge aimed
at preve

---
name: gerrit-commit-message-review
description: Proofreads and suggests structural improvements for Git commit messages to ensure style guide compliance, completeness, and accuracy.
---

# Git Commit Message & Metadata Standards

## Executive Summary

Welcome to the definitive engineering reference for formatting, structuring, and
preserving metadata inside Git commit messages. This document encapsulates the
core conventions for commit hygiene, which are essential to ensuring commit log
histories remain

---
name: typescript-style-review
description: Reviews TypeScript code against the Google TS Style Guide.
---

# TypeScript Style Review Guide

## Executive Summary

This guide serves as the instruction set for reviewing TypeScript code. The
goal is to ensure that all TypeScript code adheres to the official Google
TypeScript Style Guide.

## Guidelines

You must review the TypeScript files in the changelist and ensure they comply
with the rules and best practices outlined in the official Google TypeScript
S

---
name: gerrit-system-logic
description: Provides rules, patterns, and best practices for Gerrit backend system logic, Java APIs, performance, and correctness.
---

# System Logic & Correctness Engineering Guide

## Executive Summary

This engineering guide serves as the definitive reference for maintaining system
logic and operational correctness within Gerrit's repository management and
code review infrastructure. It exists to capture critical
historical tribal knowledge, prevent the regression of known

---
name: gerrit-frontend-engineering
description: Provides guidance and best practices on Polygerrit UI development, frontend architecture, and TypeScript/JS coding standards in Gerrit.
---

# Frontend Engineering & UI Development Engineering Guide

## Executive Summary

Welcome to the Frontend Engineering & UI Development guide. This repository
serves as the authoritative source of tribal knowledge for our UI architecture,
born from historical refactoring efforts, critical performance optimizations,
and t