media-player-mixed/CLAUDE.md

Claude Assistant Guidelines

This document contains guidelines for Claude when working on this project.

Git Workflow

Commits and Pushes

IMPORTANT: Never commit or push without explicit user approval.

When changes are ready to be committed:

1. Make the code changes
2. Show the user what will be committed (git status/diff)
3. Wait for explicit approval from the user before running git commit and git push
4. Only proceed with commits when the user says "commit and push" or similar

Commit Message Format

Use the following format for commit messages:

<Short description of changes>

<Optional longer description with bullet points>
- Detail 1
- Detail 2

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Project Structure

This is a monorepo containing:

• haos-integration: Home Assistant custom integration (submodule)
• media-server: FastAPI media server (submodule)

Submodule Workflow

When making changes:

1. Commit changes in the submodule first
2. Push the submodule
3. Update the main repo to reference the new submodule commit
4. Commit and push the main repo

Code Style

• Follow existing code patterns
• Add comprehensive documentation for new features
• Update README files when adding new functionality
• Include examples in documentation

Testing

• Test changes locally before committing
• Verify server restarts successfully after changes
• Check integration compatibility with Home Assistant

Server Restart

After making changes to the backend (Python files), restart the media server to apply them. Frontend-only changes (CSS, HTML, JS) are served as static files and only require a browser hard-refresh (Ctrl+Shift+R).