adk-style

name

adk-style

description

ADK development style guide for routine nits — Python idioms, codebase conventions, imports, typing, Pydantic patterns, formatting, logging, async/concurrency, and file organization. Use this skill whenever writing code, tests, or reviewing PRs for the ADK project to ensure compliance with styling and coding conventions. Triggers on "code style", "how should I format", "naming convention", "lint", "nit", "imports", "typing", "Pydantic patterns", "testing rules", "async", "io".

ADK Style Guide

Style Guide (references/)

• Visibility — naming conventions for module-private, internal, and package-private visibility.
• Imports — relative vs absolute imports, TYPE_CHECKING patterns.
• Typing — strong typing, avoiding Any, bare type names, keyword-only arguments, Optional vs | None, abstract parameter types, mutable default avoidance, runtime type discrimination.
• Pydantic Patterns — Pydantic v2 usage, Field() constraints, field_validator, model_validator, private attributes, deprecation migration, post-init setup.
• Formatting — indentation, line limits, and running pre-commit hooks.
• Documentation — comments and docstrings.
• Logging — lazy evaluation and log levels.
• Async and Concurrency — async I/O requirements, avoiding blocking the event loop.
• File Organization — file headers and class organization.

Testing

references/testing.md — core principles, 9 rules for writing ADK tests, test structure template