alexei.dolgolyov
980c3bbaf9
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>
57 lines
1.4 KiB
Markdown
57 lines
1.4 KiB
Markdown
# 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
|