app-creator/docs/roadmap.md
Kjell Tore Guttormsen daaadb4a15 docs(a1): dok-resync mot verifisert virkelighet per review-2026-07
Sesjon A1 i docs/masterplan.md § Fase A. Fjerner utdaterte/usanne premisser
fra normativ tekst, med docs/review-2026-07.md som fasit. Ingen nye
design-beslutninger (de hører i A2/A5/C2); domain-packs urørt (A3).

- R-01: «v4.3 Plugin Playground» merket historisk overalt (flaten slettet i
  Voyage v5.0.0, 2026-05-12; mønstrene er arven). Drill-down redefinert til
  feature-ens voyage_run_dir-artefakter + annotate-HTML. Handover 8 og
  /trekrevise fjernet som gjeldende mønster — S5-beslutningen om «to
  gate-nivåer» faller bort; det er én, den lette.
- R-05: død annotate-/kontrakt-sti (plugins/marketplaces/…) erstattet med
  cache-sti-regel + oppslag av nyeste versjon. Sidecar-fila
  <artefakt>.review.md korrigert: den finnes ikke — annotasjoner lever i
  localStorage; eksport-til-fil er D7.
- R-09: § Flersesjons-protokoll omskrevet til STATE.md-konvensjonen;
  prototype-run/README-tabellen rettet.
- R-13: iOS-versjonseksempler gjort domene-nøytrale; HTML-invarianten
  avklart til WCAG 2.2 AA.
- R-14: fase 2s pack-input strøket (motsa pack-manifestets phases).
- R-15: max-3-regelen redefinert — snapshot = én lasting, maks 3
  supplementary utover; fase 5-inputlista rettet.
- R-16: runtime-asymmetrien omformulert til skjema-asymmetri (ingen
  runtime-kobling, Handover 1 eneste kobling, ingen privilegert produsent).
- R-06 (delvis): phase_status samlet i én autoritativ enum-tabell,
  pending-review lagt til i frontmatter-enumen; kjente avvik henvist til C2.
- R-04/R-02: § Fase 7 merket STALE (2.0-pin, stale verifikasjonsnote,
  «round-trip PASS» = mental simulering, ikke kjøring).
- R-17: CHANGELOG-referansene rettet + Unreleased-entry for denne resyncen.
- R-20: «6-tema-intervju» → «8-tema» (sjekklisten lister 8).

Verifisering: iOS 19 → 0; iOS 18 → 0; 6-tema-intervju → 0; WCAG 2.1 i
CLAUDE.md → 0; «ROADMAP, TODO» → 0; pending-review → 7; Handover
8/trekrevise og plugins/marketplaces kun i eksplisitt historisk-merkede
eller advarende treff.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TJ99ZtNvvxaDPfNTED7gnC
2026-08-10 20:48:01 +02:00

4 KiB
Raw Permalink Blame History

app-creator — roadmap

Erstattet 2026-07-10: Gjeldende plan til v1.0.0 er masterplan.md (promotert fra kryssmodell-reviewen; funn i review-2026-07.md). v0.4.0-milepælen under står som milepæl underveis i masterplanen.

Revidert 2026-08-10 (sesjon A1): drill-down-formuleringene er rettet — «Voyage Plugin Playground» er en historisk flate (slettet i Voyage v5.0.0, 2026-05-12), og drill-down peker nå til feature-ens voyage_run_dir-artefakter + annotate-HTML (R-01). Selve HTML-spesifikasjonen skrives i masterplan E1. Milepæl-boksene under er fortsatt ukrysset og eies av masterplanens fase CF.

Gjeldende status og aktiv oppgave: se ../STATE.md (gitignored). Invarianter og scope-grenser: se ../CLAUDE.md.

Dette dokumentet er planer — fremtidige milepæler og deliverables. Det er ikke state og ikke invarianter.

Forutsetninger før implementering starter

Pre-design-fasen låses opp først når alle disse er reelle (ikke designet):

  • Én reell iOS-app drevet manuelt gjennom hele app-creator → Voyage-pipelinen — håndholdte fase-artefakter, briefer skrevet for hånd, Voyage konsumerer dem
  • Friksjons-data fra prototypen er sammenstilt og dokumentert i ../prototype-run/friksjon.md
  • Brief-handover-format mot Voyage er observert i praksis (round-trip-testet på reell brief), ikke bare designet
  • App-state-format er observert i bruk
  • Pre-brief skrevet basert på det observerte mønsteret

iOS er det konkrete testtilfellet, ikke et tilfeldig domene-valg — det er der friksjonen som rettferdiggjør app-creator faktisk oppstår (Xcode-prosjekter, simulator, code-signing, TestFlight, App Store-constraints, HIG-baserte designsystem-beslutninger).

v0.4.0-milepæl (kontrakt-låsing)

v0.4.0 låser kontraktene som krysser lag-grenser (se ../../app-factory/docs/alignment-brief.md Funn 2-4). Definisjonen er fastsatt nå (intensjon, ikke implementering — innholdet låses når prototypen viser hva som faktisk fungerer):

  • Brief-handover-format mot Voyage låst og dokumentert (Voyage-kompatibel brief.md med frontmatter, round-trip-testet)
  • App-state-eksport-schema låst og dokumentert (fase-status, feature-backlog, brief-pipeline-status, Voyage-runs-status)
  • Per-app HTML klar (renderer alle fase-artefakter, fase-progress, attention per app, og drill-down til feature-ens Voyage-run-artefakter (voyage_run_dir) og annotate-HTML)
  • Minst én iOS-app drevet til shipping gjennom systemet (≥5 features fra brief til ferdig)
  • Friksjons-data fra produksjons-bruk dokumentert som forutsetning for app-factory-design

Disse er forutsetninger, ikke deadlines. Hvis prototypen tar lengre tid blir milepælen stående — den skal ikke presse fram låsing før kontraktene er reelle.

Senere (post-v0.4.0)

Deliverables som hører til app-creator-implementeringen når forutsetningene er oppfylt:

  • Fase-engine som sekvenserer intervju → research → arkitektur → designsystem → constraints → features → briefer
  • Fase-artefakter med eksplisitt kontrakt mellom fasene (output fra én er input til neste)
  • Brief-generator som produserer Voyage-kompatibel brief.md med riktig frontmatter (Handover 1)
  • Per-app HTML (single-file, polling, vendored DS — gjenbruker mønstrene fra v4.3 Plugin Playground, som er historisk forfar): fase-progress, alle artefakter, attention per app, drill-down til feature-ens Voyage-run-artefakter (voyage_run_dir) og annotate-HTML. Se ../../app-factory/docs/architecture-brief.md Tier 2.
  • Levende arkitektur-fil som oppdateres når Voyage-kjøringer avslører nye constraints
  • Feature-backlog med dependency-pekere mellom features (output fra fase 6)
  • App-state-eksport: hvor er vi i fase-pipelinen, hvilke briefer er sendt til Voyage, hvilke har returnert, hvilke venter på menneske-beslutning — strukturert slik at app-factory kan aggregere

Scope-grenser (hva app-creator ikke skal absorbere): se ../CLAUDE.md § "Hva app-creator IKKE skal absorbere" og § "Den sentrale arkitektur-grensen".