pool-controller

Deployment workflow for the pool-controller ESP32 — build, serial flash, uploadfs, OTA update, release-please semver pipeline, version management, and post-deploy verification. Use when asked to deploy, flash, upload, release, or update firmware. 🇩🇪 Deutsche Trigger: Deployment, Flashen, Firmware einspielen, OTA Update, Release erstellen, Version verwalten, semver, uploadfs, ausrollen.

Clean Code checklist for the pool-controller C++ codebase — derived from Codex Review PR #143 findings. Systematic review categories for heap safety, duplication, debris, logging hygiene, boot sequencing, naming, const correctness, and testability. 🇩🇪 Deutsche Trigger: Sauberer Code, Code-Review, Clean Code Checkliste, Heap-Sicherheit, String-Verbot, Duplikate, Toter Code, Logging, Boot-Reihenfolge, const correctness, Testbarkeit, Entkopplung, Lesbarkeit, Wartbarkeit.

IoT quality assurance for the ESP32 pool-controller — static analysis, anti-pattern detection, code review rules, hardening for 24/7 operation, and systematic quality gates. Use when asked to review code quality, detect embedded-specific bugs, enforce IoT best practices, or verify production readiness. 🇩🇪 Deutsche Trigger: Qualitätssicherung, Statische Analyse, Anti-Patterns, Code-Review, Embedded Bugs, IoT Best Practices, Production Readiness, Quality Gates, Speicherleck-Erkennung.

IoT security checks for the ESP32 pool-controller - Secure Boot, Flash Encryption, TLS, WPS, secrets management, network security, and 24/7 operational security. Use when asked to audit security, fix vulnerabilities, implement secure communication, or harden the device firmware. 🇩🇪 Deutsche Trigger: IoT Sicherheit, Secure Boot, Flash Verschlüsselung, TLS, WPS, Credentials, Passwörter, Netzwerksicherheit, Härtung, Verwundbarkeiten.

NVS/Preferences configuration storage for the pool-controller — ConfigManager API, key naming, NVS vs LittleFS trade-offs, OTA-safe persistence, and migration. 🇩🇪 Deutsche Trigger: Konfiguration, NVS, Preferences, ConfigManager, Konfiguration speichern, Einstellungen persistieren, OTA-sicher, Factory Reset, Werksreset.

Code quality, linting, formatting, and CI fix patterns for the pool-controller project. Use when asked to fix linter errors, run clang-format, fix EditorConfig issues, or resolve MegaLinter CI failures. 🇩🇪 Deutsche Trigger: Code-Qualität, Linting, Formatierung, clang-format, cpplint, MegaLinter, EditorConfig, CI-Fehler beheben, Pre-Commit.

ESP32 heap/stack/buffer optimization for pool-controller firmware. Use when asked to reduce memory usage, fix heap fragmentation, eliminate String in loops, resize JSON buffers, or optimize RAM in the pool-controller C++ codebase. 🇩🇪 Deutsche Trigger: Speicheroptimierung, Heap-Fragmentierung beheben, String-Eliminierung, JSON-Puffer anpassen, RAM-Optimierung, Stack-Größe, statische Puffer.

Inline documentation standard for the pool-controller C++ codebase using Doxygen. Use when asked to add, review, or fix inline code documentation. 🇩🇪 Deutsche Trigger: Inline-Dokumentation, Doxygen-Kommentare, Code-Dokumentation ergänzen, Quellcode dokumentieren.

Hugo documentation workflow for pool-controller — docs/ directory structure, Hugo frontmatter conventions (type: docs, menu, weight), shortcodes, i18n (EN/DE), GitHub Actions dispatch to smart-swimmingpool/website, and version management across doc pages. Use when asked to edit, create, update, translate, or publish documentation. 🇩🇪 Deutsche Trigger: Dokumentation, Hugo-Dokumente bearbeiten, Übersetzungen EN/DE, Dokumentenstruktur, Menü-Gewichtung, Hugo-Shortcodes, Docs publizieren, Website-Deployment, smart-swimmingpool.com.

PlatformIO environment configuration for the pool-controller — platformio.ini deep dive, build environments, library management, platform/board selection, build flags, optimization, Python venv, and CI integration. 🇩🇪 Deutsche Trigger: PlatformIO Umgebung, platformio.ini Konfiguration, Build-Environment, Library-Management, Build-Flags, Plattform-Konfiguration, ESP32 Board, Compiler-Optimierung, Python venv, CI/CD PlatformIO.

Release-please automatisierte Versionierung und Release-Pipeline für den pool-controller — End-to-End Flow von Conventional Commit bis zum Firmware-Binary auf GitHub. Für Entwickler, die Releases verstehen, triggern oder troubleshooten wollen. 🇩🇪 Deutsche Trigger: Release, Version, Veröffentlichung, semver, Versionierung, Tag, Changelog, Firmware-Binary, GitHub Release, release-please, Pipeline.

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

MQTT/Homie/Home Assistant Discovery debugging for the pool-controller. Use when asked to debug MQTT communication, verify HA Discovery payloads, test Homie convention compliance, or troubleshoot publish/subscribe issues. 🇩🇪 Deutsche Trigger: MQTT Debug, Homie Konvention, Home Assistant Discovery, Nachrichten verfolgen, mosquitto, Publisher/Subscriber, MQTT Verbindung.

Process PR review comments (GitHub Codex or human) — fetch unresolved threads, triage by priority, fix per-comment with individual commits, reply with fix summary, resolve threads, and escalate larger items via OpenSpec + GitHub issue. Use when review comments arrive on an open PR, when triaging Codex review output, or when a PR needs systematic comment processing. 🇩🇪 Deutsche Trigger: Review-Kommentare, Codex Review, PR Review, Thread auflösen, Kommentar beantworten, Code Review, OpenSpec, GitHub Issue.

Conventional Commits standard for the pool-controller project — commit message format, allowed scopes, release-please integration, and real examples from the project history. Use when writing commit messages, reviewing PRs, or preparing releases. 🇩🇪 Deutsche Trigger: Conventional Commits, Commit-Nachricht, Commit-Format, Release, semver, Changelog, Commit-Richtlinien.

Build, flash, monitor, and OTA workflow for the pool-controller ESP32 firmware. Use when asked to build, flash, debug serial output, perform OTA updates, or troubleshoot PlatformIO issues. 🇩🇪 Deutsche Trigger: Build, Flashen, Monitor, OTA-Update, Serielle Ausgabe, PlatformIO Problemen, Kompilieren, Upload, ESP32 flashen.

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

Architecture improvement patterns for the pool-controller — dependency injection, interface extraction, layered architecture, code deduplication. Use when asked to refactor the codebase for better testability, maintainability, or separation of concerns. 🇩🇪 Deutsche Trigger: Architektur verbessern, Dependency Injection, Interfaces extrahieren, Schichtenarchitektur, Code-Duplizierung entfernen, Testbarkeit, Entkopplung, Refactoring.

24/7 reliability features for the pool-controller — watchdog, memory monitoring, boot-loop detection, degradation management, and sensor recovery. Use when asked to debug, test, or improve the always-on reliability systems. 🇩🇪 Deutsche Trigger: 24/7 Betrieb, Watchdog, Speicherüberwachung, Boot-Loop Erkennung, Degradationsmanagement, Sensor-Wiederherstellung, Ausfallsicherheit, Selbstheilung.

Web interface development for the pool-controller ESP32 — edit HTML/CSS/JS externally on LittleFS with PROGMEM fallback, REST API, uploadfs workflow, and dashboard architecture. Use when asked to modify the web UI, add dashboard features, change styling, work with REST API endpoints, or update web assets. 🇩🇪 Deutsche Trigger: Web-Interface, Dashboard, CSS, JavaScript, REST-API, LittleFS, uploadfs, Web-Assets, UI-Änderungen, Style, Theme, Frontend.