chore: restore wrapped chips, trim unused scopes, and complete env docs

This commit is contained in:
Justin Visser 2026-08-11 09:31:39 +02:00
parent 401a0ddea7
commit 5080e9a609
6 changed files with 74 additions and 57 deletions

View file

@ -26,10 +26,9 @@ api -> pipeline -> ports <- adapters domain imports nothing app-level
- Spotify JSON never escapes `adapters/spotify/mapping.py`.
- Pipeline tunables (counts, thresholds, budgets, model id, effort, TTLs) live
in `app/config.py` (pydantic-settings). No magic numbers in code.
- LLM prompts are versioned template files under `app/prompts/`, not inline
strings.
- `eval/scenarios.yaml` is one source of truth for three consumers: golden
eval queries, demo fixture keys, and UI suggestion chips.
- LLM prompts live as constants in `app/prompts.py`, not inline in adapters.
- `eval/scenarios.yaml` defines golden eval queries and fixture-recording keys.
UI suggestion chips live in `frontend/src/lib/suggestions.ts`.
## Naming