server/ops/ryddejobb.md
vegard 8ca9832248 Legg til ops/ (vedlikeholdsjobber) og docs/retninger/ (arkitektoniske teser)
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>
2026-03-17 04:54:17 +01:00

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 med docker-compose.dev.yml og 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.md ved behov)

5. Asynkron tilstand — prod vs lokal vs docs

  • Stemmer docker-compose.dev.yml med 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.sh fra 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å.