Experiment

.agents/skills/arduino-code-generator/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: arduino-code-generator
+description: Generate Arduino/embedded C++ code snippets and patterns on demand for UNO/ESP32/RP2040. Use when users request Arduino code for sensors, actuators, communication protocols, state machines, non-blocking timers, data logging, or hardware abstraction. Generates production-ready code with proper memory management, timing patterns, and board-specific optimization. Supports DHT22, BME280, buttons, I2C/SPI, EEPROM, SD cards, WiFi, and common peripherals.
+---
+
+# Arduino Code Generator
+
+Generate production-quality Arduino code snippets for sensors, actuators, communication, and embedded patterns.
+
+## Quick Start
+
+**Browse example sketches:**
+```bash
+# See 9 production-ready examples in examples/ folder
+ls examples/
+# config-example.ino, filtering-example.ino, buttons-example.ino,
+# i2c-example.ino, csv-example.ino, scheduler-example.ino,
+# state-machine-example.ino, hardware-detection-example.ino,
+# data-logging-example.ino
+```
+
+**List available patterns:**
+```bash
+uv run --no-project scripts/generate_snippet.py --list
+```
+
+**Generate code for specific pattern and board:**
+```bash
+uv run --no-project scripts/generate_snippet.py --pattern i2c --board esp32
+uv run --no-project scripts/generate_snippet.py --pattern buttons --board uno --output button.ino
+```
+
+**Interactive mode:**
+```bash
+uv run --no-project scripts/generate_snippet.py --interactive
+```
+
+## Resources
+
+- **examples/** - 9 production-ready example sketches (one per pattern category)
+- **examples/README.md** - Detailed documentation for each example with wiring diagrams
+- **scripts/generate_snippet.py** - CLI tool for code generation with 9 pattern templates
+- **scripts/verify_patterns.ps1** - Compile examples for UNO/ESP32/RP2040 (PowerShell)
+- **scripts/verify_patterns.sh** - Compile examples for UNO/ESP32/RP2040 (bash)
+- **assets/workflow.mmd** - Mermaid diagram of code generation workflow
+
+## Supported Patterns
+
+### Hardware Abstraction
+- Multi-board config.h with conditional compilation
+- Pin definitions for UNO/ESP32/RP2040
+- Memory budget tracking
+
+See [patterns-config.md](references/patterns-config.md) | Example: [config-example.ino](examples/config-example.ino)
+
+### Sensor Reading & Filtering
+- ADC noise reduction (moving average, median, Kalman)
+- DHT22, BME280, analog sensors
+- Data validation and calibration
+
+See [patterns-filtering.md](references/patterns-filtering.md) | Example: [filtering-example.ino](examples/filtering-example.ino)
+
+### Input Handling
+- Software button debouncing
+- Edge detection (PRESSED/RELEASED/LONG_PRESS)
+- Multi-button management
+
+See [patterns-buttons.md](references/patterns-buttons.md) | Example: [buttons-example.ino](examples/buttons-example.ino)
+
+### Communication
+- I2C device scanning and diagnostics
+- SPI configuration
+- UART/Serial protocols
+- CSV data output
+
+See [patterns-i2c.md](references/patterns-i2c.md) and [patterns-csv.md](references/patterns-csv.md) | Examples: [i2c-example.ino](examples/i2c-example.ino), [csv-example.ino](examples/csv-example.ino)
+
+### Timing & Concurrency
+- Non-blocking millis() patterns
+- Task scheduling without delay()
+- Priority-based schedulers
+- State machines
+
+See [patterns-scheduler.md](references/patterns-scheduler.md) and [patterns-state-machine.md](references/patterns-state-machine.md) | Examples: [scheduler-example.ino](examples/scheduler-example.ino), [state-machine-example.ino](examples/state-machine-example.ino)
+
+### Hardware Detection
+- Auto-detect boards (UNO/ESP32/RP2040)
+- SRAM usage monitoring
+- Sensor fallback strategies
+- Adaptive configuration
+
+See [patterns-hardware-detection.md](references/patterns-hardware-detection.md) | Example: [hardware-detection-example.ino](examples/hardware-detection-example.ino)
+
+### Data Persistence
+- EEPROM with CRC validation
+- SD card FAT32 logging
+- Wear leveling for EEPROM
+- Buffered writes
+
+See [patterns-data-logging.md](references/patterns-data-logging.md) | Example: [data-logging-example.ino](examples/data-logging-example.ino)
+
+## Code Generation Workflow
+
+- [ ] **[Identify Pattern Type](workflow/step1-identify-pattern.md)** - Analyze user request to determine core pattern category
+- [ ] **[Read Reference Documentation](workflow/step2-read-reference.md)** - Consult pattern-specific reference files for implementation details
+- [ ] **[Generate Code](workflow/step3-generate-code.md)** - Create production-ready code following quality standards
+- [ ] **[Provide Instructions](workflow/step4-provide-instructions.md)** - Include wiring diagrams and usage guidance
+- [ ] **[Mention Integration](workflow/step5-mention-integration.md)** - Suggest combinations with other patterns when relevant
+
+## Quality Standards & Rules
+
+- [ ] **[Quality Standards](rules/quality-standards.md)** - Compilation, timing, memory safety, and error handling requirements
+- [ ] **[Board Optimization](rules/board-optimization.md)** - UNO, ESP32, and RP2040 specific optimizations and features
+- [ ] **[Common Pitfalls](rules/common-pitfalls.md)** - Critical mistakes to avoid in Arduino development
+
+## Code Output Template
+
+- [ ] **[Code Template](templates/code-output-template.md)** - Standardized structure for generated Arduino sketches
+
+## Resources
+
+- **examples/** - 9 production-ready example sketches (one per pattern category)
+- **examples/README.md** - Detailed documentation for each example with wiring diagrams
+- **scripts/generate_snippet.py** - CLI tool for code generation with 9 pattern templates
+- **assets/workflow.mmd** - Mermaid diagram of code generation workflow
+- **workflow/** - Step-by-step code generation process
+- **rules/** - Quality standards and board-specific optimizations
+- **templates/** - Code output templates and structure guidelines
+- **references/** - Detailed pattern documentation and API references
+- **references/README.md** - Reference structure and formatting guide

.agents/skills/arduino-code-generator/assets/workflow.mmd

@@ -0,0 +1,28 @@
+```mermaid
+flowchart TD
+    A["User Request:\nGenerate Arduino Code"] --> B{"Pattern Type?"}
+
+    B -->|config| C1["patterns-config.md"]
+    B -->|buttons| C2["patterns-buttons.md"]
+    B -->|i2c| C3["patterns-i2c.md"]
+    B -->|scheduler| C4["patterns-scheduler.md"]
+    B -->|filtering| C5["patterns-filtering.md"]
+    B -->|state-machine| C6["patterns-state-machine.md"]
+    B -->|csv| C7["patterns-csv.md"]
+    B -->|data-logging| C8["patterns-data-logging.md"]
+    B -->|hardware| C9["patterns-hardware.md"]
+
+    C1 & C2 & C3 & C4 & C5 & C6 & C7 & C8 & C9 --> D["Template Engine\ngenerate_snippet.py"]
+
+    D --> E{"Board Type?"}
+
+    E -->|Arduino UNO| F1["2KB SRAM\n9600 baud\nF macro"]
+    E -->|ESP32| F2["520KB SRAM\nWiFi/BLE\n115200 baud"]
+    E -->|RP2040| F3["264KB SRAM\nDual-core\n115200 baud"]
+
+    F1 & F2 & F3 --> G["Generated .ino Code"]
+
+    style A fill:#e1f5fe
+    style G fill:#c8e6c9
+    style D fill:#fff3e0
+```