add ref and AGENTS.md

This commit is contained in:
Thorsten Bus 2026-03-01 14:40:50 +01:00
parent e00fda595d
commit b26eebe908
171 changed files with 18 additions and 0 deletions

18
AGENTS.md Normal file
View file

@ -0,0 +1,18 @@
Analyze a file format of a song.
## Spec
File: ./Test.pro (file ext are always .pro)
- every song contains parts (name group here) (here: Verse 1, Verse 2, Chorus, ...) but could be any name
- every group contains 1-x slides
- every song contains different arrangements (here normal and test2) that defines the existence and the order of the groups
- every slide CAN have another textbox which contains a translated version of the first textbox
## ToDo
1. analyse the file structure and find all of the described specs.
2. test and verify if the definition is correct - there is a `all-songs` directory with lot of examples.
3. describe the structure for future AI prompts to use these files in `spec/pp_song_spec.md` and describe the usage in the `AGENTS.md` (replace obsolet commands)
4. write a PHP module (is later used in laravel) in `./php` which can parse a song and let get/set every aspect of structure. Use Objects here (Song, Group, Slide, Arrangement, etc)
5. create a simple PHP cli tool, which receive a param with a song file and show the structure of the song.

BIN
ref/Test.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Bei dir.pro Normal file

Binary file not shown.

BIN
ref/all-songs/Bei mir.pro Normal file

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Breathe.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Ewigkeit.pro Normal file

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Frei!.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Gratitude.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Größer.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Hosanna.pro Normal file

Binary file not shown.

BIN
ref/all-songs/Höher.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

BIN
ref/all-songs/Ich warte.pro Normal file

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Some files were not shown because too many files have changed in this diff Show more