1.6 KiB
1.6 KiB
FastLED AI Agent Guidelines
Quick Reference
This project uses directory-specific agent guidelines. See:
- CI/Build Tasks:
ci/AGENTS.md- Python build system, compilation, MCP server tools - Testing:
tests/AGENTS.md- Unit tests, test execution, validation requirements - Examples:
examples/AGENTS.md- Arduino sketch compilation, .ino file rules
Key Commands
uv run test.py- Run all testsuv run test.py --cpp- Run C++ tests onlyuv run test.py TestName- Run specific C++ test (e.g.,uv run test.py xypath)bash lint- Run code formatting/lintinguv run ci/ci-compile.py uno --examples Blink- Compile examples for specific platformuv run ci/wasm_compile.py examples/Blink --just-compile- Compile Arduino sketches to WASMuv run mcp_server.py- Start MCP server for advanced tools
Core Rules
Command Execution (ALL AGENTS)
- Python: Always use
uv run python script.py(never justpython) - Stay in project root - never
cdto subdirectories - Git-bash compatibility: Prefix commands with space:
bash test
C++ Code Standards
- Use
fl::namespace instead ofstd:: - **If you want to use a stdlib header like <type_traits>, look check for equivalent in
fl/type_traits.h - Use proper warning macros from
fl/compiler_control.h - Follow existing code patterns and naming conventions
Memory Refresh Rule
🚨 ALL AGENTS: Read the relevant AGENTS.md file before concluding work to refresh memory about current project rules and requirements.
This file intentionally kept minimal. Detailed guidelines are in directory-specific AGENTS.md files.