---
name: code-review-workflow
description: Provides guidance and best practices on Python code style and documentation for the depot_tools codebase, covering language idioms and modernization, static type hinting, execution efficiency, code formatting, commit-message metadata and hygiene, technical documentation and comment quality, and data validation.
---

# Depot Tools Code Review Workflow

## Executive Summary

This skill consolidates the Python code style, commit-message, and
documentation standards for the depot_tools codebase. It codifies the language
idioms, static type-hinting, formatting, commit-message hygiene, and
documentation-quality rules that every change should satisfy.

## How to use this skill

Use this page as the overview, then open the relevant reference guide below for
the detailed rules, rationale, traps, and worked examples on a given topic. Each
guide is self-contained — read only the one(s) relevant to the change under
review.

## Reference guides

| Topic | When to consult | Guide |
|-------|-----------------|-------|
| Code style & documentation | Python style and docs: language idioms/modernization, static type hints, performance, formatting, commit-message metadata, documentation quality, and regex/data validation. | [Code_Style_and_Documentation_guide.md](references/Code_Style_and_Documentation_guide.md) |
