cursorrules

FastLED Project Rules for Cursor

🚨 CRITICAL: PYTHON EXECUTION REQUIREMENTS - NO EXCEPTIONS! 🚨

MANDATORY COMMAND EXECUTION RULES - ALL AGENTS MUST FOLLOW

🚨 ABSOLUTELY FORBIDDEN: Direct python/python3 execution

• ❌ NEVER use: python3 <command>
• ❌ NEVER use: python <command>
• ❌ NEVER use: ./python
• ❌ NEVER use: Direct Python interpreter calls

✅ MANDATORY: Always use uv run

• ✅ ALWAYS use: uv run python <command>
• ✅ ALWAYS use: uv run python -c "..."
• ✅ ALWAYS use: uv run python script.py

NO EXCEPTIONS - ALL PYTHON CODE MUST RUN THROUGH UV:

# ✅ CORRECT - Use uv run python
uv run python test.py
uv run python ci/ci-compile.py uno --examples Blink
uv run python -c "from ci.ci.module import func; func()"
uv run python ci/ci/build_info_analyzer.py --board uno --show-defines

# ❌ FORBIDDEN - Direct python execution
python3 test.py                    # NO!
python ci/ci-compile.py            # NO!
python3 -c "import something"      # NO!
python3 script.py                  # NO!

THIS RULE APPLIES TO:

• 🚨 All test execution
• 🚨 All script execution
• 🚨 All build commands
• 🚨 All analysis tools
• 🚨 All development commands
• 🚨 ALL Python code execution without exception

WHY: The project uses UV for dependency management and execution environment. Direct python3 calls bypass the controlled environment and may use wrong Python versions or missing dependencies.

ENFORCEMENT: Any agent using direct python3/python commands is in violation of project requirements.

🚨 UV RUN MANDATE - FINAL WARNING 🚨

IF YOU SEE ANY COMMANDS IN THIS PROJECT DOCUMENTATION THAT USE python3 OR python DIRECTLY:

1. 🚫 DO NOT COPY THEM - They are legacy commands that must be updated
2. ✅ ALWAYS REPLACE python3 with uv run python
3. ✅ ALWAYS REPLACE python with uv run python
4. 📝 UPDATE DOCUMENTATION when you find python3 commands

EXAMPLES OF MANDATORY REPLACEMENTS:

# ❌ If you see this in docs (WRONG):
python3 script.py

# ✅ Always use this instead (CORRECT):
uv run python script.py

# ❌ If you see this in docs (WRONG):  
python -c "import something"

# ✅ Always use this instead (CORRECT):
uv run python -c "import something"