Files
media-player-mixed/CLAUDE.md
alexei.dolgolyov 980c3bbaf9 Add runtime script management and CLAUDE.md guidelines
Updates:
- Add CLAUDE.md with project guidelines for AI assistance
- Update media-server submodule: runtime script management with HA integration
- Update haos-integration submodule: automatic script reload support

New features:
- Dynamic script CRUD operations via Web UI
- Thread-safe configuration management
- WebSocket-based real-time updates
- Automatic Home Assistant button entity updates
- Client-side position interpolation for smooth playback

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 03:53:51 +03:00

1.4 KiB

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