app-creator/README.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

38 lines
2 KiB
Markdown

# app-creator
Tier 2 i et tre-tier HTML-system: en pipeline fra app-konsept til feature-klare briefer som Voyage konsumerer, med tynn per-app HTML for review og navigasjon.
> **Status:** Pre-design. Ingen kode er skrevet ennå. Implementering venter på en manuell prototype gjennom hele app-creator → Voyage-pipelinen for én reell iOS app. Se [CLAUDE.md](CLAUDE.md) for full kontekst.
## Tre-tier-systemet
| Tier | Plugin | Spørsmål den svarer på |
|------|--------|------------------------|
| 1 | Voyage | Hvordan utfører vi denne oppgaven riktig? |
| 2 | app-creator | Hva trenger appen, og hva er neste brief? |
| 3 | app-factory | Hvilken app trenger meg nå, og hvilken handling er nødvendig? |
## Hva app-creator skal gjøre
Drive én app fra idé til feature-backlog gjennom syv faser: intervju → research (valgfri) → arkitekturavklaringer → designsystem → constraints → feature-derivasjon → brief per feature. Hver fase produserer en artefakt på filsystemet. Brief-fasen genererer Voyage-kompatible markdown-filer som Voyage `/trekplan` konsumerer uten endringer.
Per-app HTML rendrer alle artefakter, viser fase-progress og attention, og lar deg drille ned til artefaktene fra hver features Voyage-kjøring (`voyage_run_dir` + annotate-HTML). Mønstrene er arvet fra Voyages v4.3 Plugin Playground — en historisk forfar; selve flaten ble slettet i Voyage v5.0.0.
app-creator eksekverer ikke Voyage. Briefer overleveres som filer.
## Hva app-creator ikke skal gjøre
- Utføre tasks (Voyages jobb)
- Eksekvere Voyage runtime (briefer er filhandover, ikke runtime-kall)
- Aggregere flere apper (app-factorys jobb)
- Erstatte Linear/Jira eller forutsette eksterne PM-verktøy (verktøy-agnostisk)
- Koordinere team
- Kjøre autonomt uten human-in-the-loop
## Posisjonering
Solo-maintained, fork-and-own. Primært for forfatterens eget arbeid. Issues som signaler — ingen pull requests. Ingen backward compatibility-garantier før v1.0.0.
## Lisens
TBD ved første utgivelse.