mirror of
https://github.com/home-assistant/supervisor.git
synced 2026-09-30 15:22:31 +01:00
Jan ČermákandClaude Fable 5.1
c9543e8649
The instructions file carried product documentation on add-ons, the update system and backups, general Python advice, a directory tree and code samples. Every agent session loaded all of it. Current guidance for agent instruction files is a short list of commands and project specific conventions the agent cannot infer from the code. Restructure the file into the pull request template rule, development commands, Python 3.14 syntax notes, testing rules, good practices and the AI policy. Drop the coverage threshold, which nothing in CI enforces. The file shrinks from about 2,700 to 1,100 tokens. Keep the Supervisor specific conventions: relative imports, per-module const.py, CoreSysAttributes with the sys_* properties, the executor for blocking calls, api_process with api_validate, exceptions from exceptions.py and plain test_ functions. Replace add-on with app throughout and state that add-on is the legacy term. The code has moved to app naming, so agents must use it in new code and keep addon only where an existing API field, config key or class name still carries it. Adopt the section layout and several rules from the AGENTS.md in Home Assistant Core that were not in the old file: the pointer to the VS Code tasks, the note on lazily evaluated annotations, the test rules on type annotations, usefixtures, branching and parametrization, and the rules on small try clauses and comments. Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>