Home Automation Agent

An intelligent agent that designs, optimizes, and manages smart home routines across multiple platforms. It creates automations for Apple HomeKit, Amazon Alexa, Google Home, and Home Assistant that work together seamlessly. The agent handles energy optimization by scheduling high-draw appliances during off-peak hours, builds security routines that activate based on presence detection, and creates comfort automations that adapt lighting, temperature, and ambiance to your daily patterns.

Supported Platforms & Integrations

Platform	Integration Type	Features
Apple HomeKit	Scene & Automation Design	Creates scenes, automations, and adaptive triggers using HomeKit-compatible device protocols
Amazon Alexa	Routine Builder	Designs multi-step Alexa routines with conditions, wait actions, and device group controls
Google Home	Automation Scripts	Builds household and personal routines with time, device state, and presence triggers
Home Assistant	YAML Automation	Generates full YAML automation configs, scripts, and dashboard cards for HA installations
IFTTT	Applet Design	Creates cross-platform applets connecting smart home devices with external services
Hubitat	Rule Machine	Designs Rule Machine automations for local-processing-first smart home setups

When to Use

• Setting up a new smart home — designs a complete automation plan organized by room, covering lighting, climate, security, and entertainment from day one
• Optimizing energy consumption — creates schedules that shift heavy appliance usage to off-peak electricity rates and monitors standby power waste
• Building security routines — sets up presence-aware automations that simulate occupancy when you are away, lock doors at night, and alert on unexpected motion
• Creating mood and comfort scenes — designs multi-device scenes for activities like movie night, dinner party, focus work, or winding down for bed
• Migrating between platforms — translates automations from one ecosystem to another when switching from Alexa to HomeKit or adding Home Assistant
• Troubleshooting automation failures — analyzes existing routines to find conflicts, race conditions, and reliability issues causing automations to misfire

Alternatives to Consider

• Use platform-native apps (Apple Home, Alexa app) if you have fewer than 10 devices and simple scheduling needs
• Use professional installation services if you need electrical work, wiring, or complex multi-zone HVAC integration
• Use dedicated energy monitors (Sense, Emporia) if energy tracking is your sole concern and you do not need broader automation

Quick Start

Copy
agent: home-automation-agent
config:
  primary_platform: "home_assistant"
  secondary_platforms:
    - "homekit"
    - "alexa"
  rooms:
    - living_room
    - bedroom
    - kitchen
    - office
  priorities:
    - energy_efficiency
    - security
    - comfort
  household_members: 2
  presence_detection: "phone_gps"

Example Prompt

Design a complete automation setup for my 2-bedroom apartment. 
I use Home Assistant as the hub with HomeKit for Apple devices. 
We're two people with different wake times (6am and 8am). 
I want energy savings, good morning routines, and security 
when we're both away.

Example Output

## Smart Home Automation Plan
Hub: Home Assistant | Bridge: HomeKit via HA integration

### Morning Routine — Person A (6:00 AM)
trigger: alarm_dismissed OR time: 06:00 weekdays
actions:
  - kitchen_lights: 30% warm_white
  - coffee_maker: on
  - bedroom_lights: off (Person B still sleeping)
  - office_lights: 50% cool_white (if workday)
  - thermostat: 21°C
  - briefing: weather + calendar via kitchen speaker

### Morning Routine — Person B (8:00 AM)
trigger: alarm_dismissed OR time: 08:00
actions:
  - bedroom_lights: gradual sunrise (10 min ramp)
  - bathroom_fan: on for 15 min
  - kitchen_lights: 70% (daylight adjusted)

### Away Mode (both phones leave geofence)
actions:
  - thermostat: eco_mode (17°C)
  - all_lights: off (except random occupancy simulation)
  - cameras: armed + recording
  - smart_plugs: off (standby power savings)
  - door_lock: engaged + status notification
...

Advanced Configuration

Platform-Specific Settings

Copy
home_assistant:
  config_path: "/config"
  generate_yaml: true
  dashboard_cards: true
  mqtt_broker: "localhost"

homekit:
  bridge_via_ha: true
  expose_entities:
    - light.*
    - climate.*
    - lock.*
    - cover.*

energy_optimization:
  utility_provider: "pacific_gas"
  off_peak_hours: "21:00-07:00"
  solar_panels: false
  ev_charger: false
  monthly_budget_target: 150  # USD

Parameters Reference

Parameter	Type	Default	Description
primary_platform	string	required	Main automation platform: home_assistant, homekit, alexa, google_home
secondary_platforms	array	[]	Additional platforms to generate automations for
rooms	array	required	List of rooms/zones in your home
priorities	array	["comfort"]	Optimization priorities: energy_efficiency, security, comfort, convenience
household_members	number	1	Number of people in the household for presence logic
presence_detection	string	"phone_gps"	Method: phone_gps, wifi_detection, motion_sensors, manual
off_peak_hours	string	null	Electricity off-peak window for energy optimization
security_level	string	"standard"	Security automation depth: minimal, standard, comprehensive
voice_assistant	string	null	Primary voice assistant: siri, alexa, google_assistant
pet_friendly	boolean	false	Avoid motion-triggered automations in pet-accessible areas
quiet_hours	string	"22:00-07:00"	Hours during which automations avoid audio and bright lights

Core Concepts

Concept	Description
Presence Awareness	Combines GPS geofencing, WiFi connection, and motion sensors to determine who is home and adjust automations accordingly
Scene Layering	Builds complex scenes by layering device states — base layer (security), comfort layer (climate), ambiance layer (lighting), and activity layer (entertainment)
Energy Scheduling	Shifts discretionary loads (dishwasher, laundry, EV charging) to off-peak hours and kills standby power on idle devices
Conflict Resolution	Detects when two automations would fight (e.g., one turns lights on while another turns them off) and adds conditions to prevent conflicts
Graceful Degradation	Designs automations so that if one device or service fails, the rest of the routine still executes rather than failing entirely

┌──────────────┐     ┌───────────────┐     ┌──────────────┐
│   Presence   │────▶│   Routine     │────▶│   Device     │
│   Detection  │     │   Selection   │     │   Commands   │
└──────────────┘     └───────────────┘     └──────┬───────┘
                                                   │
┌──────────────┐     ┌───────────────┐             │
│   Energy     │◀───│   State       │◀─────────────┘
│   Report     │     │   Monitoring  │
└──────────────┘     └───────────────┘

Workflow Examples

Scenario 1: Movie Night Scene

Input:

Create a movie night scene for the living room. We have Hue lights, 
a Sonos soundbar, Apple TV, and motorized blinds. Should work with 
both Siri and Alexa voice commands.

Output: A multi-platform scene: Hue lights dim to 10% with warm amber, motorized blinds close, Sonos soundbar switches to TV input with volume at 35%, Apple TV wakes and opens the TV app. HomeKit scene created for "Hey Siri, movie time" and Alexa routine for "Alexa, start movie night." Reverse scene for "movie's over" that brings lights up gradually over 30 seconds and opens blinds if before sunset.

Scenario 2: Vacation Security Simulation

Input:

We're going on vacation for 10 days. Set up automations to make 
the house look occupied. We have smart lights in 4 rooms, a Ring 
doorbell, and smart locks.

Output: A vacation mode automation that randomizes light patterns across rooms (varying on/off times daily by plus or minus 30 minutes), simulates TV glow in the living room via a smart plug and LED strip, enables Ring doorbell motion alerts with cloud recording, auto-locks doors every hour as a safety check, and sends daily security digest notifications. Includes a one-command deactivation for return.

Scenario 3: Energy Optimization Audit

Input:

Our electricity bill jumped 40% last month. We have a Home 
Assistant setup with energy monitoring on most circuits. Help me 
find what's wasting power and fix it.

Output: An energy audit automation that monitors consumption by circuit, identifies always-on devices drawing phantom power, creates a smart plug schedule to cut standby waste, shifts the dishwasher and laundry machine to off-peak triggers, and generates a weekly energy report dashboard card in Home Assistant showing consumption trends and savings.

Best Practices

1. Start with presence detection — It is the foundation of nearly every useful automation. Get presence working reliably before building complex routines. Combine two methods (GPS and WiFi) for accuracy.

2. Add manual overrides to every automation — Every automated action should have a way to be manually overridden without breaking the automation logic. A physical switch or voice command should always work.

3. Test automations individually before combining — Run each trigger-action pair in isolation before chaining them into complex routines. This makes debugging dramatically easier when something misfires.

4. Use conditions liberally — Time conditions, presence conditions, and state conditions prevent automations from firing inappropriately. A motion-triggered light should check if it is already on, if it is daytime, and if the room is occupied.

5. Document your automations — As your smart home grows beyond 20 automations, you will forget why certain rules exist. The agent generates inline comments in YAML configs and a summary document, but add your own reasoning notes for unusual rules.

Common Issues

Automations fire at wrong times or not at all

Check your Home Assistant or hub's timezone setting — a misconfigured timezone is the most common cause of time-based automation failures. Also verify that device entities are available (not "unavailable" state) before the trigger fires. The agent adds availability checks to generated automations by default.

Presence detection is unreliable

Single-method presence detection (GPS only or WiFi only) frequently produces false departures and arrivals. Use the agent's recommended dual-method approach: GPS geofencing for departure detection combined with WiFi or Bluetooth for arrival confirmation. Add a 5-minute departure delay to prevent false "away" triggers.

Cross-platform scenes are out of sync

When triggering devices across HomeKit and Alexa simultaneously, network latency can cause visible sequencing issues. The agent adds deliberate delays (500ms-2s) between commands to different platforms and prioritizes the most noticeable devices (lights) first for perceptual consistency.

Privacy & Data Handling

All automation configurations are generated and stored locally on your machine or Home Assistant instance. The agent does not connect to your smart home platforms directly — it generates configuration files and routine definitions that you manually import. Presence detection data stays within your local network when using Home Assistant. For cloud-based platforms (Alexa, Google Home), automations follow those platforms' existing privacy policies. No device states, usage patterns, or occupancy data are transmitted to external services by this agent. Energy consumption data used for optimization is processed locally and never leaves your network.