Skip to content

Architecture

001.

Let It Propagate

Most catch blocks shouldn’t exist. An exception should rise until it reaches a layer with the context to act on it, and the catches that deserve to exist fit five patterns.
002.

Give Your AI Assistant the Docs, Not the Search Bar

Web search hands an AI assistant stale forum posts and deprecated APIs. Shallow submodules of the Home Assistant and HACS docs, symlinked under docs/ and described in CLAUDE.md, give it the real thing.