aod-architecture-contract

Explain Area Occupancy Detection architecture, probability logic, and database schema.

316|9|Updated Nov 23, 2024
One-click install
npx skills add https://github.com/Hankanman/Area-Occupancy-Detection --skill aod-architecture-contract
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aod-architecture-contract
Source: https://github.com/Hankanman/Area-Occupancy-Detection/tree/main/.claude/skills/aod-architecture-contract
Command: npx skills add https://github.com/Hankanman/Area-Occupancy-Detection --skill aod-architecture-contract

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps users understand the architectural decisions behind Area Occupancy Detection before making code changes to prevent bugs.

Core Features & Use Cases

  • Design Overview: Explains the single-coordinator-many-areas design and the probability pipeline.
  • Probability Calculation: Details the math and logic used to calculate the probability of occupancy.
  • Analysis Pipeline: Describes the 13-step analysis pipeline and how it works.
  • Entity Semantics: Defines how entities and evidence are semantically handled.
  • Database Layout: Describes the database schema and its concurrency rules.
  • Use Case: When planning to modify coordinator.py, area.py, utils.py, etc., load this to understand the implications.

Quick Start

Load this Skill before making changes to the Area Occupancy Detection code to understand the architecture.

Frequently Asked Questions about aod-architecture-contract

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does Area Occupancy Detection calculate the probability of occupancy?

The AOD architecture uses a single-coordinator-many-areas design where one coordinator manages multiple areas, feeding sensor evidence through a 13-step analysis pipeline to determine occupancy probability for each area.

How does the probability pipeline work in Home Assistant occupancy detection?

The probability pipeline processes occupancy evidence through a 13-step analysis pipeline, evaluating entity semantics and sensor data to calculate the combined probability of area occupancy across managed zones.

Do I need to know Python and Home Assistant to modify the Area Occupancy Detection architecture?

Yes, modifying the AOD architecture requires knowledge of Python and Home Assistant to understand the single-coordinator-many-areas design and safely edit files like coordinator.py, area.py, and utils.py.

What is the database schema layout for Area Occupancy Detection?

The database schema defines how occupancy data is structured and stored, including specific concurrency rules that govern database access to prevent data conflicts during probability analysis.

When should I review the AOD architecture before making code changes?

You should review the AOD architecture before modifying files like coordinator.py, area.py, or utils.py, as understanding the design decisions and entity semantics helps prevent bugs in the occupancy detection system.