chore: establish standards in AGENTS.md

README.md

@@ -0,0 +1,41 @@
+# discovery-by-llm
+
+Muziekontdekking met een LLM als aanbevelingsmotor, op de Spotify Web API.
+
+**These:** Spotify heeft zijn aanbevelings- en audio-intelligentielaag uit de
+API verwijderd (recommendations en audio features zijn weg voor nieuwe apps).
+Deze proof-of-concept beantwoordt de vraag of een LLM die rol kan overnemen,
+met Spotify teruggebracht tot resolver, verifier, personalisatiebron en
+afspeeloppervlak. Een naïeve-zoekbaseline maakt het antwoord meetbaar.
+
+> Werk in uitvoering — dit bestand wordt gevuld tijdens de bouw.
+> Chronologisch verslag: [docs/logboek.md](docs/logboek.md).
+
+## Demo
+
+*(volgt: gehoste instantie + lokale `docker compose up --build`, met en zonder
+API-sleutels)*
+
+## Hoe het werkt
+
+*(volgt: pipeline-diagram en module-overzicht)*
+
+## Keuzes
+
+*(volgt)*
+
+## Performance en optimalisaties
+
+*(volgt)*
+
+## Waar te kijken
+
+*(volgt)*
+
+## Werkwijze
+
+*(volgt)*
+
+## Wat ik heb geschrapt / wat ik hierna zou doen
+
+*(volgt)*