vegard/synops
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
synops/ops/ryddejobb.md
vegard 0a467066ba Synops v2: arkitektur, retninger og dokumentasjon 
Nystart basert på arkitektonisk innsikt fra Sidelinja v1.
Koden er ny, visjon og primitiver er validert gjennom tidligere arbeid.

Inneholder:
- Komplett arkitekturdokumentasjon (docs/arkitektur.md)
- 6 vedtatte retninger (docs/retninger/)
- Alle concepts, features, proposals og erfaringer fra v1
- Server-oppsett og drift (docs/setup/)
- LiteLLM-konfigurasjon (API-nøkler via env)
- Editor.svelte referanse fra v1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 06:43:08 +01:00

2.7 KiB
Raw Blame History

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å.