Ny mappe ops/ med repeterbare vedlikeholdsjobber: - ryddejobb.md — full prosjektrevisjon - doc-audit.md — docs vs kode - drift-sjekk.md — prod vs lokal vs docs Ny mappe docs/retninger/ med arkitektoniske teser: - status_quo.md — hva Sidelinja er i dag - rom_ikke_forum.md — opplevelse-først, to-lags-modell, administrativ opplevelse - universell_input.md — tre primitiver (input, mottak, kommunikasjon), noder+edges - maskinrommet.md — Rust-orkestrator, edge-drevet ressursorkestrering, CAS+pruning - bruker_ikke_workspace.md — brukeren er sentrum, workspaces er samlings-noder - datalaget.md — PG+Apache AGE, SpacetimeDB som sanntidslag, lagmodell Oppdatert CLAUDE.md og proposals/README.md med referanser. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.7 KiB
2.7 KiB
Ryddejobb — Full prosjektrevisjon
Hva
Systematisk gjennomgang av hele prosjektet for å oppdatere fremdrift, tette hull, fjerne utdaterte referanser, og sikre at dokumentasjon stemmer med virkeligheten.
Når
- Annenhver uke som rutine
- Etter store implementeringsjobber
- Når prosjektet føles uoversiktlig
Sjekkliste
1. CLAUDE.md — stemmer instruksjonene?
- Er stack-beskrivelsen oppdatert?
- Er doc-treet komplett (alle filer i
docs/er listet)? - Er reglene fortsatt relevante?
- Finnes det nye konvensjoner som bør inn?
2. Docs vs virkelighet
- Gå gjennom
docs/concepts/— stemmer beskrivelsene med hva som finnes i koden? - Gå gjennom
docs/features/— er det features beskrevet som ikke er påbegynt? Marker dem. - Gå gjennom
docs/infra/— stemmer infrastruktur-docs meddocker-compose.dev.ymlog prod? - Gå gjennom
docs/setup/— fungerer oppsettinstruksjonene fortsatt? - Gå gjennom
docs/retninger/— er tesene fortsatt relevante? Har noen modnet til beslutninger? - Er det docs som refererer til filer, routes eller komponenter som ikke eksisterer?
3. Kode-hygiene
- Ubrukte SvelteKit-routes (mapper i
web/src/routes/uten innhold eller med stub) - Ubrukte komponenter (filer i
web/src/lib/components/som ikke importeres) - Ubrukte Rust-moduler i worker
- Ubrukte SpacetimeDB-reducere eller tabeller
- Gamle migrations som bør dokumenteres eller konsolideres
package.json/Cargo.toml— ubrukte dependencies
4. Fremdriftsstatus
- Hva er faktisk implementert og fungerer?
- Hva er påbegynt men ufullstendig?
- Hva er kun planlagt (kun docs)?
- Oppdater en kort statusoversikt (kan legges i
ops/status.mdved behov)
5. Asynkron tilstand — prod vs lokal vs docs
- Stemmer
docker-compose.dev.ymlmed det som faktisk kjøres lokalt? - Er prod-server oppdatert med siste push?
- Er det migrasjoner som er kjørt lokalt men ikke i prod (eller omvendt)?
- Er miljøvariabler (.env) synkronisert mellom miljøer?
6. CLAUDE.md minne
- Gå gjennom
~/.claude/projects/-home-vegard-server/memory/MEMORY.md - Fjern utdaterte minner
- Oppdater minner som har blitt unøyaktige
- Er det ny kunnskap fra nylige samtaler som bør lagres?
7. Erfaringslogg
- Er det gjort arbeid nylig som mangler erfaringsdokumentasjon i
docs/erfaringer/? - Er eksisterende erfaringsdokumenter fortsatt relevante og korrekte?
8. dev.sh og utviklermiljø
- Fungerer
./dev.shfra scratch? - Er alle nødvendige tjenester dekket?
- Er det nye quirks eller workarounds som bør inn i scriptet?
Sist kjørt
Ikke kjørt ennå.