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

47 lines
4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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".