Instruction file imported from ruaan-deysel/ha-actronair-neo (.github/instructions/yaml.instructions.md). Copyright stays with the author.

YAML Instructions

Applies to: All YAML files

Formatting Standards

• 2 spaces for indentation (never tabs)
• No trailing whitespace
• End files with a single newline
• Use lowercase for keys (except where case matters)
• Boolean values: true/false (lowercase)

Home Assistant YAML Conventions

• Use modern HA configuration syntax (no legacy platform: style)
• Use !secret for sensitive values (passwords, API keys, tokens)
• Boolean values: true/false (lowercase)

services.yaml (Service Actions)

Service action definitions must include:

• name — Human-readable action name
• description — What the action does
• fields — Parameters with types and descriptions
• target — If the action targets entities

set_zone_temperature:
  name: Set zone temperature
  description: Sets the target temperature for a specific zone.
  fields:
    zone_id:
      name: Zone ID
      description: The zone identifier (0-indexed)
      required: true
      selector:
        number:
          min: 0
          max: 7
          mode: box

configuration.yaml (Development Config)

The config/configuration.yaml file is for local development only:

• Set logger levels for debugging
• Configure Home Assistant for development use
• Never commit sensitive credentials

logger:
  default: info
  logs:
    custom_components.actronair_neo: debug

Common Mistakes

• ❌ Using tabs instead of spaces
• ❌ Trailing whitespace
• ❌ Hardcoded passwords in YAML (use !secret)
• ❌ Missing name or description in service definitions