# IDEA.md – en egen nyhetslista där varje tung nyhet vägs mot en ljus Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen implementation. Den bygger på Good News Morning, en svensk nyhetslista som designades i Claude Design, byggdes med Claude Code och fick sin ikon av Codex. ## 1. Vad som ska byggas En morgonutgåva med två kolumner, det tunga och det ljusa, där varje tung nyhet står bredvid en ljus. Innehållet är bara det som nyhetssajterna själva publicerar i sina RSS-flöden: rubrik, ingress, datum, länk och bild. Artikeltexten hämtas aldrig. I Good News Morning: - **en morgonutgåva per dag**, byggd två gånger om dagen, med permanent adress per morgon och ett arkiv - **par i fem nivåer**: samma händelse, samma ämne, samma plats eller grupp, närliggande ämne och dagens ljuspunkt, med nivån synlig på mittlinjen - **trendkort**: en långsiktig siffra med källa som motvikt när ingen färsk ljus artikel finns i samma ämne - **åtta ämnen** med filter, och "morgonens våg": hur tungt flödet var mot balansen hos oss - **"Så väger vi nyheterna"**, en öppen förklaring av nivåerna - ljust och mörkt tema, hemskärmsapp, RSS och sitemap - **inget JavaScript krävs**, och inget laddas från andra värdar ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **PHP 8.3 utan ramverk, MariaDB och Apache.** Server-renderade sidor, cachade hela till nästa bygge. - **Viktigt: en pipeline i tre steg**, var och en ett CLI-verktyg som körs av cron: hämta (villkorad GET mot alla flöden), klassa (bara oklassade artiklar) och bygg (para ihop dagens utgåva och töm cachen). En lås-fil hindrar två körningar samtidigt. - **Viktigt: klassning med Claude, parning i PHP.** Claude klassar varje artikel en gång med strukturerat svar enligt ett schema, flera artiklar per anrop. Matcharen är deterministisk och testbar. - **Ett gemensamt ordförråd** i en fil: ämnena, vilka som är närliggande, vilka som är ljusa och nivåerna med sina namn. Klassaren, matcharen och vyerna läser samma fil. - **En reservklassare** utan API-nyckel, så att allt går att köra lokalt. - **Källregistret i databasen**: namn, flöde, om källan bara skriver ljusa nyheter, och en ämnesledtråd. ## 3. Beslut som visade sig avgörande **AI där den gör skillnad, kod där det ska gå att förklara.** En textalgoritm (TF-IDF och cosinuslikhet) hittar artiklar om samma sak men kan inte avgöra tonen – "cancerfallen ökar" och "cancerdöden minskar" ligger nästan på samma ställe. Låt språkmodellen klassa ton (−2…+2), ämne, snävare etikett, platser, grupper och en normaliserad händelseetikett. Skicka med de senaste dygnens händelseetiketter, så att samma händelse får samma etikett mellan körningarna. **Var ärlig om reserven.** Finns ingen nära motvikt, visa dagens ljuspunkt och säg det rakt ut. Ljusa nyheter får vara upp till 30 dagar gamla och används en gång per utgåva. **Ett par hör till båda sidornas ämnen.** Annars får ett ämne som nästan bara har ljusa nyheter (vetenskap) aldrig något par. **Juridiken styr formen.** Länka alltid till originalet och kreditera källan synligt. Korta ingressen till hela meningar under 240 tecken. Bilderna är den största risken: bygg lägena egen miniatyr, källans bild eller ingen bild, och lägg sajten bakom en spärr om bilderna inte får visas publikt. **Spärren utan konton.** Utan en nyckelcookie svarar varje sida 401 med bara loggan. En egen adress visar en knapp; klicket (ett POST-formulär, inte en länk) sätter cookien, så en länkförhandsvisning släpper inte in någon. `robots.txt` säger `Disallow: /`. ## 4. Fallgropar - **Girig tilldelning lämnar nyheter utan motvikt.** Lägg till ett reparationssteg där en tung nyhet med ett ledigt trendkort lämnar ifrån sig sin artikel. - **Samma historia i flera flöden delar ofta bara ett egennamn.** Bilda grupper också på egennamn i rubriken, inom samma ämne. - **Ordstammar** måste matcha på ordets början och väljas med omsorg: "kris" träffar "Kristersson", "fred" "fredag", "hot" "hotell", "val" "valet". - **Flöden skiljer sig**: RSS 2.0 och Atom, bilden i `enclosure`, `media:content` eller som `` i beskrivningen – eller inte alls (hämta då sidans `og:image`). Ett flöde kan vara gzippat. Spårningsparametrar i länkar ger dubbletter. - **Aggregatorer återger andras artiklar** under egna adresser. Fånga dubbletter på rubriken. - **Hemskärmsappen på iOS** delar inte cookies med Safari, och iOS håller kvar gamla ikoner. Länka ikoner och manifest med filens tid i adressen. - **iOS 26 lägger ett sudd** över överkanten i en hemskärmsapp; ett fast, ogenomskinligt lager över hela skärmen tar bort det. - **Kostnaden för klassningen**: mät antalet nya artiklar per dygn och räkna innan modellen väljs. Klassa bara det som inte är dubbletter. ## 5. Krav och mätningar - Varje sida fungerar utan JavaScript. - Inga resurser från andra värdar. - En cookie och bara en: spärrens nyckel. Temat sparas i webbläsaren. - Ingressen högst 240 tecken, i hela meningar. ## 6. Så verifieras det - `php -l` på alla filer. - Enhetstester utan nät och utan databasskrivningar: flödestolkning, klassning och matchning mot fixturer. - Ett rökprov som besökare: statuskoder, cachen, bassökvägen, att inget laddas från andra värdar. - Utseendet i en riktig webbläsare mot designen, på desktop och i mobil. ## 7. Arbetssätt - **Research först**: vilka flöden som finns och fungerar, juridiken, och om matchningen ska vara AI eller textalgoritm. Skriv ner resonemangen. - **Design först** i ett designverktyg, med flera alternativ att välja mellan. - **En ärendebräda**, med beslut som egna ärenden. ## 8. Prompten > Bygg en nyhetslista på [svenska] där varje tung nyhet står bredvid en ljus: hämta rubrik, ingress, datum, länk och bild från [nyhetssajternas RSS-flöden], låt [Claude] klassa ton och ämne, och para ihop nyheterna i nivåer med en deterministisk matchare. [PHP utan ramverk med MariaDB], cachade sidor, inget JavaScript. > > Läs hela IDEA.md nedan först. > > Arbeta så här: > 1. Gör research på källorna och juridiken och skriv ner resonemangen. > 2. Dela upp bygget i ärenden och fråga mig om besluten. > 3. Testa flödestolkningen, klassningen och matchningen mot fixturer. > > [klistra in IDEA.md här]