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>
65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# 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å._
|