Source: Beguelin Claude Code para HA (2026-04)¶

Workflow concreto y reciente de un usuario que usa Claude Code (con MCP a HA) para mantener su setup. Validación práctica del approach "Opción 1" del Q10 strategy. Patrón clave: skills files con conventions del proyecto (formats YAML, naming entities, deployment via scp). Caso de debugging concreto: traces de GPS-induced home→home transitions.

Por qué entró al wiki¶

Validación práctica de la Opción 1 propuesta en ../analysis/q10-ai-tooling-strategy-v1 (Claude Code + MCP).
Documenta qué tipos de tareas funcionan bien con Claude Code en HA (debug de traces, tweaks de configs, pattern discovery, state management complex).
Introduce el patrón "skills files" como contexto persistente entre invocaciones — soluciona parcialmente la limitación "ciega entre runs" de Opción 1.

Páginas derivadas¶

Update ../analysis/q10-ai-tooling-strategy-v1 con patrón skills files (próximo iter).
Nueva técnica candidate: concepts/skills-files-pattern — convención de project context para agentes.

Workflow documentado¶

describe problem → Claude explores → builds solution → deploys via scp → verifies → commits

El usuario permanece en la conversación revisando propuestas y curando. Esto es coherente con ai-as-operator — el agente propone, el humano cura, ambos documentan.

Tools que usa el agente¶

MCP server con HA (probablemente ha-mcp o similar) → entity searching, automation trace reading, config reloading, device state querying.
scp para deploy desde git local al HA instance.
Comando explícito de automation reload tras scp.

Casos concretos exitosos¶

Debug GPS bouncing: el agente analizó traces y detectó que GPS updates triggereaban repeated home→home state transitions — diagnóstico que un humano scrolleando logs hubiera tardado mucho más.
Tweak rápido: ajustar brightness 50%→70% en 4 mensajes. Fricción cero.
Pattern discovery: review de automations existentes para mantener consistencia.
Motion-light con state preservation: variable snapshots de luces pre-existentes (más sofisticado que el patrón naive).

Skills files (patrón clave)¶

El autor usa skills files con conventions del proyecto: - Formatos YAML preferidos. - Workflow de deployment. - Naming conventions de entities. - Known quirks del setup. - Skills paralelos para otros dominios (OpenWrt en su caso para VLAN).

Esto resuelve la limitación de "Opción 1" del ../analysis/q10-ai-tooling-strategy-v1 (no estado entre invocaciones): los skills cargan en cada turn, manteniendo contexto persistente.

No documentado (gaps)¶

Failure modes / tareas donde Claude Code se rompió.
Token costs.
System prompt completo.
Guardrails formales para acciones destructivas.

Hay que cubrir con otros sources (Dan Malone serie, repo del autor si público).

Aplicación al setup del usuario¶

Adoptable hoy: el workflow es lo más cerca de "viable esta semana" que hay en el wiki.
Skills files = formato del wiki: las conventions del proyecto YA están en este wiki. Podrían exportarse como skills files al setup del agente.
scp deploy = compatibly con HAOS Yellow: no requiere container ni infra extra para empezar.

Abierto / gaps¶

Ingerir el home-assistant-mcp o ha-mcp repo para tener el MCP server documentado.
¿Cómo se diferencia este workflow del Dan Malone series (también Q10)? Comparar tras ingerir Dan Malone.
Patrón concreto de skills file para HA — falta example.
¿Cómo se monitorea que el agente no introduzca regressions en la review fase? Patrón humano = cura activa.