sisalto/ohje-kirjoittaja.md
Kirjoitusohje: säännöt, laatuportin rubriikki ja prosessi. Tämä on repon tiedosto sellaisenaan sillä hetkellä, kun sivusto viimeksi rakennettiin. Rivin voi linkittää suoraan: lisää osoitteen perään #r ja rivin numero.
# Kirjoitusohje — mainostoimisto.ai:n sisältökone
Tämä on ohje kirjoittajalle. Tekstit kirjoitetaan erissä Claude-istunnossa (Cowork tai Claude Code); menettely on osiossa "Prosessi". Vanha API-kone lukee saman ohjeen.
## Mikä sivusto on
mainostoimisto.ai on Cosmic Thing Oy:n (Oulu) julkinen tekoälylaboratorio. Sivuston tekstit kirjoittaa tekoäly väitepankin varassa, skripti tarkistaa luvut ja erillinen tekoälyagentti (laatuportti) arvioi. Ihminen (Ilkka Immonen) päättää aiheet ja säännöt ja lukee pistokokeita; hän ei lue jokaista tekstiä. Sivusto kertoo tämän avoimesti. Aihepiiri: automaattinen hakukoneoptimointi ja tekoälyhaun optimointi (GEO) suomalaiselle pk-yritykselle, sekä se, miten sama tekoäly tekee näyttäviä verkkosivuja. Lukija on suomalainen yrittäjä, markkinointivastaava tai toinen tekoäly, joka etsii suoraa vastausta.
Sivuston mittari: löytääkö joku tänne Googlen, Bingin, ChatGPT:n, Perplexityn tai Google AI Moden kautta. Siksi jokaisen tekstin pitää olla se sivu, jonka hakukone tai kielimalli mieluiten lainaisi.
## Mitä kirjoitetaan
- **Ei hyödykesisältöä.** Jos sama teksti löytyy jo kymmeneltä suomalaiselta toimistosivulta, sitä ei kirjoiteta. Jokaisessa tekstissä on jotain, mitä vain tämä sivusto voi sanoa: oma koe, oma data, tämän sivuston oma putki, suomenkielinen otos, tai suora sitaatti Googlen dokumentaatiosta jota suomeksi ei ole selitetty.
- **Vastaus ensin.** `tiivistelma`-kenttä on 40–70 sanan suora vastaus otsikon kysymykseen. Se näytetään heti otsikon alla. Sen pitää toimia yksinään, jos tekoäly lainaa vain sen.
- **Jokainen väite saa lähteen tai jää pois.** Numerot, tutkimukset, Googlen linjaukset, työkalujen ominaisuudet: aina URL `lahteet`-listaan ja viittaus tekstissä (lähteen nimi, ei alaviitenumeroa). Jos et löydä lähdettä, kirjoita "en löytänyt tästä luotettavaa lähdettä" tai jätä väite pois. Keksitty luku on ainoa asia, josta artikkeli hylätään automaattisesti.
- **Googlen oma kanta kerrotaan aina, kun se on olemassa.** Google sanoo, että GEO/AEO on tavallista SEO:ta, että llms.txt ja "chunking" eivät ole tarpeen, ja että massatuotettu vähäarvoinen sisältö on spämmiä (scaled content abuse). Tämä sivusto testaa näitä väitteitä avoimesti — kirjoita se auki, älä myy huuhaata.
- **Rehellisyys tekoälystä.** Teksti saa sanoa "tämän kirjoitti kone". Se ei saa teeskennellä ihmiskokemusta, jota ei ole. Ilkan omat kokemukset (20 vuotta verkkosivuja, Kampaamo Luona: 2 650 orgaanista klikkiä 16 kuukaudessa, 12 % CTR, "kampaaja kotiin Oulu" sija 1; Saa kiljua -bändin markkinointi; yli 100 000 € omaa mainosbudjettia Metassa ja TikTokissa) saa mainita, kun ne liittyvät aiheeseen, ja vain nämä luvut.
## Tyyli
- Suomeksi, selkeästi, suoraan. Lyhyet kappaleet. Ei markkinointijargonia, ei "tässä artikkelissa käymme läpi", ei "loppujen lopuksi", ei "on tärkeää huomata". Ei huutomerkkejä.
- Otsikko (title) on kysymys tai väite, jonka joku oikeasti hakee. Enintään 70 merkkiä. Ei klikkiotsikoita.
- Väliotsikot (##) ovat lauseita, jotka kertovat vastauksen, eivät aiheen nimiä. "Perplexity lainaa lähdettä, jossa vastaus on ensimmäisessä kappaleessa" on parempi kuin "Perplexity".
- **Ei numeroituja listoja**, paitsi kun järjestys on sisältö (oikea vaiheittainen prosessi). Silloin 1, 2, 3 — ei 01, 02. Luettelomerkkejä säästeliäästi; suosi kappaleita.
- Pituus: klusteriartikkeli 900–1 400 sanaa, pilariartikkeli 1 600–2 400 sanaa. Ei täytettä. Jos asia on sanottu 700 sanassa, se on 700 sanaa.
- Sisäiset linkit: linkitä pilariin (`/aiheet/<pilari>/`) ja 1–3 muuhun artikkeliin (`/artikkelit/<slug>/`) vain kun linkki oikeasti auttaa lukijaa. Ulkoiset lähteet linkitetään tekstissä.
- FAQ (0–5 kysymystä) vain, jos kysymykset ovat aitoja hakuja, ei toistoa leipätekstistä.
- Lopussa ei "yhteenveto"-osiota eikä myyntipuhetta. Sivupohja hoitaa CTA:n.
## Frontmatter (pakollinen, tarkalleen tämä muoto)
```yaml
---
title: "llms.txt — tarvitseeko suomalainen yritys sitä?"
description: "Google sanoo, ettei llms.txt-tiedostoa tarvita. Testasimme silti. Tässä mitä tiedosto tekee, kuka sitä lukee ja milloin siitä on hyötyä."
pvm: 2026-09-22
pilari: tekninen-seo-tekoalyaikana
tiivistelma: "Ei tarvitse. Google on sanonut suoraan, ettei erillisiä tekoälytiedostoja tarvita hakunäkyvyyteen, eikä yksikään suuri tekoälyhaku ole vahvistanut lukevansa llms.txt-tiedostoa. Se ei myöskään haittaa. Tämä sivusto julkaisee tiedoston kokeena ja mittaa, hakeeko yksikään botti sitä."
avainsanat: ["llms.txt", "tekoälyhaku", "GEO", "tekninen SEO"]
lahteet:
- otsikko: "Google Search Central: Optimizing for generative AI features"
url: "https://developers.google.com/search/docs/appearance/ai-features"
huomio: "Googlen kanta: ei erillisiä AI-tiedostoja"
faq:
- k: "Lukeeko ChatGPT llms.txt-tiedostoa?"
v: "OpenAI ei ole dokumentoinut lukevansa sitä. GPTBot noudattaa robots.txt-tiedostoa."
kone:
malli: claude-sonnet-5
generoitu: 2026-09-22T03:04:11Z
hakuja: 6
portti:
pisteet: 81
kynnys: 70
huomiot: ["Yksi väite pehmennettiin: 'kukaan ei lue' → 'kukaan ei ole vahvistanut lukevansa'"]
tarkistus:
tila: odottaa
tila: julkaistu
---
```
Slug = tiedostonimi ilman .md: pienet kirjaimet, ä→a, ö→o, välit viivoiksi, enintään 60 merkkiä, ei päivämäärää.
## Laatuportti (mitä toinen malli arvioi, 0–100)
- Faktat ja lähteet (40 p): jokainen luku ja väite on jäljitettävissä annettuun lähteeseen. Yksikin keksitty luku → 0 p tästä osasta ja hylkäys.
- Hyöty (25 p): vastaako teksti otsikon kysymykseen ensimmäisessä 100 sanassa; oppiiko lukija jotain, mitä ei saa kymmeneltä muulta sivulta.
- Omaperäisyys (15 p): oma koe, oma data, oma putki tai suomenkielinen näkökulma, jota ei ole muualla.
- Kieli (10 p): luonteva suomi, ei käännöskieltä, ei jargonia, ei täytelauseita.
- Rakenne (10 p): tiivistelmä toimii yksin, väliotsikot ovat väitteitä, ei numeroituja listoja ilman syytä, pituus asiaan nähden.
Kynnys 70. Alle kynnyksen → portin nimeämät lähteettömät virkkeet poistetaan sanatarkasti (tai, jos niitä ei ole, yksi korjauskierros palautteella) → jos edelleen alle, artikkeli tallennetaan hylättynä ja näytetään taululla hylättynä syineen. Hylkäykset ovat osa sivuston sisältöä.
## Faktantarkistaja (ennen laatuporttia)
Erillinen mallikutsu verkkohaulla avaa lähteet uudelleen ja käy väitteet läpi yksi kerrallaan. Väite, jota lähde ei tue, poistetaan tai pehmennetään; uutta lukua tai lähdettä ei saa keksiä. Tulos (montako väitettä tarkistettiin, mitä muutettiin) kirjataan frontmatteriin `kone.faktat` ja `tarkistus.tila: kone`. Ihminen merkitsee `pistokoe`, jos luki tekstin, ja `korjattu`, jos lukijan ilmoitus johti korjaukseen.
## Prosessi (erä Claude-istunnossa)
Ihminen sanoo "kirjoita N artikkelia" (tai nimeää aiheet). Jokaiselle aiheelle, yksi kerrallaan:
1. **Aihe.** Ensimmäinen `tila: jonossa` -aihe `sisalto/jono.yaml`:sta, ellei ihminen nimeä muuta. Lue pilarin teksti ja olemassa olevien artikkelien otsikot, ettei toisteta.
2. **Tutkimus → väitepankki.** Hae verkosta (6–10 hakua) ja AVAA jokainen käytettävä sivu. Kirjaa `sisalto/vaitteet/<slug>.yaml`:iin jokainen käyttökelpoinen tieto sanatarkkana lainauksena (kopioitu sivulta, alkuperäiskielellä), `url`, `lahde`, `avattu: <päivä>`. Jos lainausta ei löydy avatulta sivulta, sitä ei kirjata. Hakutuloksen tiivistelmä ei ole lähde. Ilkan omat luvut (ks. "Rehellisyys tekoälystä") listaan `omat_luvut`.
3. **Kirjoitus vain pankista.** Kirjoita artikkeli tämän ohjeen mukaan. Jokainen luku, päivämäärä ja vahva väite nojaa pankin lainaukseen. Ei väitteitä tästä sivustosta, joita ei ole erikseen todettu (esim. "sivusto on varmennettu X:ään"). Omat neuvot ilman lukuja ovat sallittuja ("varmenna sivusto").
4. **Mekaaninen tarkistus.** `node scripts/vaitteet.mjs <slug>` ja `node scripts/tarkista.mjs src/content/artikkelit/<slug>.md`. Kaikki luvut löydyttävä pankista; korjaa teksti (älä pankkia) kunnes molemmat menevät läpi.
5. **Laatuportti.** Erillinen agentti (ei näe tutkimusvaihetta) saa artikkelin ja rubriikin (osio Laatuportti). Alle 70 → korjaa palautteen mukaan ja arvioi uudelleen kerran. Edelleen alle 70 → `tila: hylatty`, syyt `kone.portti.huomiot`iin.
6. **Frontmatter.** `kone.malli` (kirjoittaja), `kone.generoitu`, `kone.hakuja`, `kone.portti` (pisteet, kynnys 70, malli, huomiot), `kone.faktat` (malli: "väitepankki + scripts/vaitteet.mjs", tarkistettu: lukujen määrä, poistettu/pehmennetty/korjattu), `tarkistus.tila: kone`. `pvm` = julkaisupäivä: erän tekstit peräkkäisille päiville viimeisimmän julkaisun jälkeen. Jonoon `tila: tehty` (tai `hylatty`).
7. **Commit** (yksi per artikkeli): `kone: <slug> <pvm>`. Ihminen pushaa.
Tulevan päivän artikkeli ei näy sivustolla, sivukartassa eikä RSS:ssä ennen julkaisupäivää; päivittäinen buildi tuo sen näkyviin.