Imported from Woyken/huckleberry-homeassistant (
AGENTS.md). Install upstream withnpx skills add Woyken/huckleberry-homeassistant. Copyright stays with the author.
Agent guidelines
This repository is a Home Assistant custom integration over huckleberry-api. Keep Firebase access and Huckleberry operations in that library; this repository should contain only Home Assistant adaptation.
- Never guess values from the Huckleberry app or Firebase schema. Before adding or changing keys, enum or state values, modes, units, or options, verify them against
huckleberry-apitypes or implementation. - Keep the Home Assistant model minimal. Add only required entities, states, options, and attributes; do not expose convenience or speculative extras.
- Use precise types wherever possible. Prefer existing
huckleberry-apiand Home Assistant types overAny, untyped dictionaries, or duplicate local types. - Keep platform entry points such as
sensor.py,switch.py, andcalendar.pylimited to entity setup. Put entity behavior infeatures/or shared integration modules. - Keep
custom_components/huckleberry/manifest.jsonandpyproject.tomlsynchronized when changing dependencies. - Run Python tools through
uv, including tests, linting, and type checks. - Follow
RELEASE.mdwhen preparing and publishing a release. - Apply the
unslopskill to PR titles and descriptions.
