# IDEA.md – ett eget arkadspel i webbläsaren Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg), gärna tillsammans med ett designpaket från Claude Design, för att bygga ett eget spel. Den bygger på Ironfang, en action-plattformare i Black Tigers anda som designades i Claude Design, byggdes i Claude Code och fick sin ikon av Codex. ## 1. Vad som ska byggas En 2D action-plattformare i webbläsaren med de klassiska arkadspelens mekanik och ett helt eget innehåll: värld, figurer, namn, grafik och text. I Ironfang: - **åtta djup** med egna teman, ett tidsur per djup och en boss längst ner i varje - **en hjälte** som går, hoppar (med kortare hopp när knappen släpps), klättrar, slår med kedjeslaga (även snett uppåt och i huk), kastar knivar och släpper igenom plankor - **nio sorters fiender**, **pilgrimer** att befria (dialog och belöning), **hemligheter** bakom spruckna murar, **kistor** med nycklar, **urnor**, och en **butik** där valutan byts mot rustning och slaga – och varje uppgradering byter hjältens utseende - **poäng, liv, game over och continue**, en slutsekvens och en topplista - **tangentbord, handkontroll och pekskärm**, med ombindning av tangenterna - **musik och ljudeffekter**, syntetiserade - **en installerbar webbapp** som går att spela offline **Inte i första versionen**: två spelare, handritade kartor för alla djup, inspelad musik. ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **TypeScript och Vite, ren Canvas 2D, ingen spelmotor.** Intern upplösning 384 × 216, heltalsskalad med letterbox, fast tidssteg 60 Hz och rendering per bildruta. - **Viktigt: grafiken som kod.** Designpaketets skript ritar figurer, rutor och scener till canvas. Då ger palettbyten, teman och alla kombinationer av utrustning sig själva, och inga bildfiler behöver skickas med. Baka alla ritningar under laddningen, så att första fienden på skärmen inte kostar ett hack. - **Viktigt: kopiera designpaketets skript oförändrade**, och märk varje ändring du måste göra i kopian. Då kan en ny version av designen kopieras in och ändringarna läggas på igen. - **Banlogik utan webbläsarberoenden** (grammatik, kollision, banbygge, nåbarhet), så att verktygen kan köra den direkt med node. - **Topplistan**: ett litet PHP-API som sparar i en JSON-fil utanför webbroten under exklusivt lås, med rimlighetskontroll av poängen per djup och en spärr per adress (adresserna sparade som hash och rensade efter en timme). `localStorage` som reserv. Ingen databas. - **Service worker** som genereras vid bygget, med en version som är en hash över allt bygget levererar. ## 3. Beslut som visade sig avgörande **Design först.** Ett designpaket med grafikbibel (palett, teman, typsnitt, pixelregler), alla figurer med ankare och hitbox, en handritad första bana, flöden för de andra banorna, alla skärmar och en överlämning som beskriver fysik, ekonomi, bossmönster och ljud. **Deterministiska banor.** Första djupet är handritat. De andra byggs ur flöden: ett rum per cell, varje rum en ram runt en mall för sin rumstyp (start, korridor, schakt, pilgrim, butik, kista, hemlighet, fara, boss), och grannar i flödet blir öppningar. Inget slumpas vid körning – samma djup är samma karta för alla på topplistan. Bossrummet får bara en ingång. **Ett nåbarhetstest för varje bana.** Räkna ut med hjältens verkliga gränser (två rutor hög, hopp tre rutor upp och fyra ut, stegar åt båda hållen, plankor ovanifrån) att bossrummet, butiken, varje pilgrim och varje kista nås från start, att varje djup har sina pilgrimer och minst en hemlighet, och att alternativa vägar verkligen är alternativ – mura igen den ena och se att den andra räcker. **Ett speltest som stegar exakt.** Exponera en krok i spelet som fryser loopen, stegar exakt n tick och låter testet styra input. Då beror utfallet inte på hur snabb datorn är. Testa springfart, hopphöjd, attackfönster, butik, kista, boss, game over och continue, och kör genom varje rum på alla djup med bossen besegrad. **Använd signaturrummen som stilreferens, inte ordagrant**, om de inte håller sig inom hjältens gränser. ## 4. Fallgropar - **Hitboxar måste nås av hjältens attacker.** Mät var bossens träffyta hamnar i spelet mot slagets och knivens räckvidd. En boss som stiger ur en vätska kan hamna utom räckhåll. - **Vätskor ändrar hoppet.** Ett lägre hopp i vatten gör bassänger till fällor. Låt hopp i vatten vara simtag, och låt nåbarhetstestet behandla vätska som det den faktiskt är. - **Hemligheter får inte synas.** Rita inte föremål ovanpå murar, och låt inte föremålsrutor ärva murens grafik. - **Pixeltypsnitt flyter ihop.** Lägg till en pixel mellan tecknen och mät layouter med den bredden. - **Rita inte text innan typsnittet laddats** – en cache av text ritad med reservtypsnittet sitter kvar. - **iOS 26+ lägger ett sudd över överkanten** i en webbapp från hemskärmen. Lägg allt i en fast, ogenomskinlig behållare över hela skärmen, med statusradens höjd som en ram i bakgrundsfärgen, och använd inte de gamla `apple-mobile-web-app`-taggarna. - **Service workern måste få en ny version när vad som helst ändras**, även sidan själv. Ladda upp den sist, efter allt den listar. Cacha aldrig topplistans API. - **Lita inte på poäng från klienten.** Kontrollerna stoppar bara det uppenbara. ## 5. Krav och mätningar - Springfart runt 90 px/s, hopphöjd runt 64 px, kortare hopp när knappen släpps. - Skarp bild i 2×–5× skalning, 60 bildrutor i sekunden i telefonen. - Alla djup nåbara enligt testet; speltestet grönt genom varje rum och varje boss. ## 6. Så verifieras det - Typkontroll före bygget; ett typfel stoppar bygget. - Nåbarhetstestet för alla banor, och speltestet i en headless webbläsare mot det byggda spelet. - Pekskärmsläget med emulering, och sedan på riktiga telefoner. - Spelkänsla och ljud provspelas av en människa. ## 7. Arbetssätt - **Milstolpar i ärenden**: motor (skalning, tidssteg, input, text), första djupet spelbart, fiender och ekonomi, boss och spelflöde, resten av djupen, ljud, topplista, mobil. - **Öppna frågor blir beslutsärenden med ett förval**, så att bygget kan fortsätta medan frågan står öppen. - **Ett ärende i taget**, med mätningen i den avslutande kommentaren. ## 8. Prompten > Bygg en 2D action-plattformare i webbläsaren i [TypeScript och Vite på ren Canvas 2D], med [Black Tiger] som förebild för mekaniken men med helt eget innehåll. [Åtta] djup med en boss i varje, en hjälte med [kedjeslaga och kastknivar], fiender, hemligheter, en butik och en topplista. Den ska fungera med tangentbord, handkontroll och pekskärm och gå att installera och spela offline. > > Läs hela IDEA.md nedan först, och designpaketet om det finns. > > Arbeta så här: > 1. Dela upp bygget i milstolpar och fråga mig om de öppna besluten – lägg ett förval på varje. > 2. Håll banlogiken fri från webbläsaren och skriv ett nåbarhetstest för varje bana. > 3. Lägg in en krok som stegar spelet exakt, och testa det byggda spelet i en webbläsare. > 4. Lämna spelkänslan och ljudet åt mig att provspela. > > [klistra in IDEA.md här]