# AGENTS.md — Mikin Reseptikirja

Käytä tätä, kun käyttäjä pyytää reseptisuosituksia tai valmistusohjeita Mikin reseptikirjasta.

## Lähteet (hae nämä — ei etusivun HTML:ää)

| Tiedosto | URL | Käyttö |
|---|---|---|
| Markdown | https://mikinreseptit.fi/reseptikirja.md | täydet ohjeet |
| JSON | https://mikinreseptit.fi/recipes.json | suodatus / haku |
| Indeksi | https://mikinreseptit.fi/llms.txt | mitä lukea |

**Älä scrapea** `https://mikinreseptit.fi/` HTML-kuorta. Se on JS-SPA eikä sisällä reseptejä ennen kuin `recipes.json` on ladattu selaimessa. Staattiset `.md` / `.json` / `llms.txt` sisältävät kaiken.

## Säännöt

1. **Lue data verkosta** yllä olevista URL-osoitteista. Älä luota muistiin.
2. **Suosittele** 1–3 reseptiä kerrallaan käyttäjän rajoitteiden mukaan (proteiini, kalorit, ainesosat, aika, gluteeniton jne.).
3. **Arvosana** (`rating`, 0–10) kertoo Mikin suosituksen; suosi korkeampia jos käyttäjä ei toisin pyydä. WIP-reseptit (esim. meta sisältää `WIP`) eivät ole valmiita.
4. **Valmistusohjeet** ota vain lähteen `Valmistus`-osiosta. Jos ohje puuttuu, sano se suoraan.
5. **Makrot** ovat arvioita — kerro se lyhyesti.
6. **Kieli:** vastaa käyttäjän kielellä (yleensä suomi).
7. **Linkitä** tarvittaessa UI-reseptiin: `https://mikinreseptit.fi/?r=<id>` (id löytyy JSONista, esim. `paaruuat-0`).

## Reseptien kirjoittaminen (`reseptikirja.md`)

- **Annos-sarake / `meta`:** lähtökohtaisesti **aina** kerro kuinka monta annosta reseptistä tulee (esim. `*2 annosta · 8/10*` tai `*1–3 annosta · …*`). Älä jätä annosmäärää pois.
- Arvosana `N/10` meta-rivillä → JSON-kenttä `rating`.

## JSON-rakenne (tiivis)

- `sections[].name` — kategoria (Pääruoat, Aamupalat, Jälkiruoat, Kastikkeet ja soosit)
- `sections[].recipes[].title` — reseptin nimi
- `sections[].recipes[].meta` — annoskoko / WIP-merkintä ym.
- `sections[].recipes[].rating` — arvosana 0–10
- `sections[].recipes[].id` — URL-id (`?r=`)
- `sections[].recipes[].images[]` / `.image` — ateriakuvat (`images/…`), jos ladattu
- `sections[].recipes[].blocks[]` — osiot: `Ainekset`, `Valmistus`, `Makrot`, `Huom`, `Vinkki`, …
- `index[]` — litteä lista UI:ta varten (title, meta, macros, rating, image, section)

Kuvat: droppaa tiedostot `images/`-kansioon (nimeä reseptin mukaan, ks. `images/README.md`), aja `python3 build_recipes.py`.

## Esimerkkiprompti käyttäjälle

> Käytä lähteenä https://mikinreseptit.fi/llms.txt  
> Hae reseptikirja.md tai recipes.json. Suosittele illallista ~40 g proteiinilla ja anna valmistusohjeet.