Skip to content

docs: cover 2026.6 automation, helper, template & dashboard changes#60

Open
kingpanther13 wants to merge 2 commits into
homeassistant-ai:mainfrom
kingpanther13:issues-55-58-2026.6
Open

docs: cover 2026.6 automation, helper, template & dashboard changes#60
kingpanther13 wants to merge 2 commits into
homeassistant-ai:mainfrom
kingpanther13:issues-55-58-2026.6

Conversation

@kingpanther13

@kingpanther13 kingpanther13 commented Jun 7, 2026

Copy link
Copy Markdown
Member

What does this PR do?

Updates the home-assistant-best-practices skill for HA 2026.6-specific changes. Closes #55, closes #56, closes #57, closes #58.

Stacked on #59 (the pre-2026.6 gaps). This branch contains #59's commit, so until #59 merges the diff below shows both commits — review/merge after #59. GitHub will recompute this diff to show only the 2026.6 commit once #59 lands.

references/template-guidelines.md (#55)

  • Rewrites the lone legacy per-domain platform: template example to the modern top-level template: form and notes the legacy form was removed in 2026.6 (zero platform: template recommendations remain)

references/helper-selection.md (#58)

  • Adds the template device_tracker sub-type and its key constraints (in_zones or latitude+longitude; location_accuracy; the keys that are not valid)

references/automation-patterns.md (#57)

  • Native 2026.6 zone triggers/conditions (zone.entered/left/occupancy_*, zone.in_zone/not_in_zone/occupancy_*) with the options:/target:/behavior: serialization (triggers each/all/first; conditions any/all), Labs-gated, any-zone; classic zone trigger/condition + state triggers kept as the stable fallback
  • Softens the "no new YAML syntax" claim to list the zone family and note:
  • New "Documenting Automations & Scripts" section: description: and the 2026.6 step-level note: (stored-only, stripped at runtime)
  • Keeps the entered_home/etc. removal labeled 2026.5

references/dashboard-guide.md (#56 + feature-catalog completeness)

  • Features table: Weather (temperature-forecast/precipitation-forecast) + media additions (media-player-volume-buttons/source/sound-mode) with config-key notes; plus Select/Update/Counter/Date/Lawn-mower/Humidifier/Water-heater/Lock/Area/Favorites rows
  • Per-entity graph color for history-graph/statistics-graph
  • Tile extras as real feature strings (trend-graph, bar-gauge); shortcut badge; sections header/footer; changelog extended through 2026.6

All 2026.6 syntax verified against home-assistant/core 2026.6.0 source and the live dashboards/features docs.

Checklist

  • Tested with real scenarios (if changing skill content) — verified against core 2026.6.0 source + live docs; not yet exercised on a live instance
  • README.md Skill Contents table updated (if reference files were added or removed) — n/a (no reference files added or removed in this PR)

🤖 Generated with Claude Code

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request expands the Home Assistant Best Practices guide by adding a new reference document for scenes and updating existing guides with modern features up to version 2026.6, such as native zone triggers, dashboard strategies, new helpers, and template device trackers. The review feedback identifies several technical inaccuracies in the documentation, including an invalid Jinja template example for the enabled option, an obsolete entity_id field in the markdown card, and incorrect configuration fields for the template device tracker. Additionally, it recommends formatting lists as comma-separated sentences to optimize token-efficiency for LLM consumption.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread skills/home-assistant-best-practices/references/dashboard-guide.md Outdated
Comment thread skills/home-assistant-best-practices/references/dashboard-guide.md Outdated
Comment thread skills/home-assistant-best-practices/references/helper-selection.md Outdated
@kingpanther13 kingpanther13 force-pushed the issues-55-58-2026.6 branch from 69fe4f5 to 2661b3a Compare June 7, 2026 20:23
kingpanther13 and others added 2 commits June 7, 2026 17:25
Fills coverage gaps that predate 2026.6 (issue homeassistant-ai#50):

automation-patterns.md
- Trigger Types: zone, template, calendar, webhook, homeassistant,
  conversation, tag, geo_location, persistent_notification triggers;
  fire-an-event action note
- Native Conditions: trigger condition; device-condition caveat note
- New sections: Parallel Actions (vs mode: parallel), Stopping a Sequence
  (stop:), Variables (+ trigger_variables caveat), Capturing Action
  Responses (response_variable); delay: action; per-element enabled:

helper-selection.md
- trend, bayesian (new Probabilistic Inference section), mold_indicator
- 'How Helpers Are Created': storage-collection vs config-entry-flow
  classification (HA mechanisms, no tool names)
- TOC + decision-matrix rows

dashboard-guide.md
- Dashboard Strategies (+ 'Take control'); heading card; markdown card;
  grid_options card sizing; expanded visibility conditions (screen, etc.);
  typed entity/object badge form; drop stale (2024+) heading qualifier

references/scenes.md (new)
- Scene config shape, turn_on/create/apply/reload, snapshot-vs-script
- SKILL.md Reference Files + README Skill Contents updated

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Addresses the 2026.6-specific doc issues (homeassistant-ai#55, homeassistant-ai#56, homeassistant-ai#57, homeassistant-ai#58):

template-guidelines.md (homeassistant-ai#55)
- Rewrite the per-domain platform:template example to the modern
  top-level template: form; note the legacy form was removed in 2026.6

helper-selection.md (homeassistant-ai#58)
- Add the template device_tracker sub-type (2026.6) + its keys note

automation-patterns.md (homeassistant-ai#57)
- Native 2026.6 zone triggers/conditions (zone.entered/left/occupancy_*,
  zone.in_zone/not_in_zone/occupancy_*), options:/target:/behavior:
  serialization (each/all), Labs-gated, any-zone; classic zone trigger/
  condition + state triggers kept as the stable fallback
- Soften the 'no new YAML syntax' claim (now lists the zone family + note:)
- New 'Documenting Automations & Scripts' section: description: and the
  2026.6 step-level note: (stored-only, stripped at runtime)
- entered_home/etc. removal kept labeled 2026.5

dashboard-guide.md (homeassistant-ai#56 + feature-catalog discoveries)
- Features table: Weather (temperature/precipitation-forecast) + media
  additions (volume-buttons/source/sound-mode) with config-key notes;
  Select/Update/Counter/Date/Lawn mower/Humidifier/Water heater/Lock/
  Area/Favorites rows
- Per-entity graph color for history-graph/statistics-graph
- Tile extras as real feature strings (trend-graph, bar-gauge)
- shortcut badge (2026.5); sections header/footer; changelog → 2026.6

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant