include info about asset sources file
This commit is contained in:
@@ -34,6 +34,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
- Currently supports English and Russian
|
||||
- New translations: Add to `project.godot` internationalization section
|
||||
|
||||
### Asset Management
|
||||
- **CRITICAL**: Every asset must be documented in `assets/sources.yaml` before committing
|
||||
- Include source, license, attribution, modifications, and usage information
|
||||
- Verify license compatibility with project requirements
|
||||
- Commit asset files and sources.yaml together in the same commit
|
||||
|
||||
## Key Development Guidelines
|
||||
|
||||
### Scene Management
|
||||
@@ -82,6 +88,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
1. Check `docs/MAP.md` for architecture understanding
|
||||
2. Review `docs/CODE_OF_CONDUCT.md` for coding standards
|
||||
3. Understand existing patterns before implementing new features
|
||||
4. If adding assets, prepare `assets/sources.yaml` documentation
|
||||
|
||||
### Testing Changes
|
||||
- Run project with F5 in Godot Editor
|
||||
@@ -112,3 +119,22 @@ DebugManager.log_error("Failed to load audio resource: " + audio_path, "AudioMan
|
||||
print("debug") # Use structured logging instead
|
||||
push_error("error") # Use DebugManager.log_error() with category
|
||||
```
|
||||
|
||||
### Asset Management Workflow
|
||||
```yaml
|
||||
# ✅ Required assets/sources.yaml entry format
|
||||
audio:
|
||||
music:
|
||||
"background_music.ogg":
|
||||
source: "https://freesound.org/people/artist/sounds/123456/"
|
||||
license: "CC BY 4.0"
|
||||
attribution: "Background Music by Artist Name"
|
||||
modifications: "Converted to OGG, adjusted volume"
|
||||
usage: "Main menu and gameplay background music"
|
||||
|
||||
# ✅ Proper commit workflow
|
||||
# 1. Add asset to appropriate assets/ subdirectory
|
||||
# 2. Update assets/sources.yaml with complete metadata
|
||||
# 3. git add both files together
|
||||
# 4. Commit with descriptive message including attribution
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user