core/AGENTS.md

GitHub Copilot & Claude Code Instructions

This repository contains the core of Home Assistant, a Python 3 based home automation application.

Code Review Guidelines

Git commit practices during review:

• Do NOT amend, squash, or rebase commits after review has started - Reviewers need to see what changed since their last review

Development Commands

.vscode/tasks.json contains useful commands used for development.

Python Syntax Notes

• Python 3.14 explicitly allows except TypeA, TypeB: without parentheses.

Testing

When writing or modifying tests, ensure all test function parameters have type annotations. Prefer concrete types (for example, HomeAssistant, MockConfigEntry, etc.) over Any.

Good practices

Integrations with Platinum or Gold level in the Integration Quality Scale reflect a high standard of code quality and maintainability. When looking for examples of something, these are good places to start. The level is indicated in the manifest.json of the integration.