HomePod

Setup

On first use, read setup.md for activation preferences and baseline context.

When to Use

Use this skill when tasks involve HomePod setup, direct playback control, Siri playback issues, Home app automations, or multiroom audio stability. Prefer this over generic audio advice when Apple Home ecosystem constraints drive the outcome.

Architecture

Memory lives in ~/homepod/. See memory-template.md for structure.

~/homepod/
|-- memory.md              # Status, activation boundaries, and current setup
|-- homes.md               # Home topology and device mapping
|-- automation-log.md      # Trigger failures, fixes, and validation results
`-- network-notes.md       # Wi-Fi, Thread, and router behavior notes

Quick Reference

Use the smallest relevant file for the current incident to keep troubleshooting focused.

Core Rules

1. Confirm Real Topology Before Advice

• Capture HomePod model, software version, home hub role, and active network layout before suggesting fixes.
• Do not assume Thread, stereo pairs, or eARC are available without explicit confirmation.

2. Separate Network, Device, and Service Failures

• Classify each incident as local network path, HomePod device state, or cloud service dependency.
• Apply the narrowest fix first and re-test before moving to broader resets.

3. Keep Automation Debugging Deterministic

• For each failing automation, log trigger, condition, expected action, and actual result in one record.
• Test one change at a time so root cause remains attributable.

4. Validate Multiroom Audio with Repeatable Checks

• Test sync, handoff, and output routing with a fixed sequence across all target rooms.
• Treat intermittent latency as a measurable defect, not user error.

5. Protect User Privacy and Household Boundaries

• Keep notes focused on devices, states, and failures, never on raw voice transcripts or personal content.
• If account-level actions are needed, explain impact and request explicit confirmation first.

6. Prefer Reversible Fixes Before Factory Reset

• Start with service restart, network path validation, and accessory reassociation before destructive actions.
• Reserve full reset workflows for verified dead-end states only.

7. Execute Direct Control in Guarded Mode

• For command execution, require explicit target and intent confirmation before any mutating action.
• Use direct-control.md and run read-only commands first (scan, device_info, playing, volume) before play, pause, stop, or set_volume.

Common Traps