docs: skriv README gjennomfort engelsk (ORDRE 52, AAA+ runde 4)

README-LANGUAGE-funnet: 24 norske markorord mot 5 engelske i et repo som er
deklarert engelsk. Brodteksten oversatt, ikke bare ordene -- pre-design-
avsnittets substans (manuell prototype gjennom hele app-creator -> Voyage-
pipelinen for en reell iOS app) er bevart, og det samme er v4.3-Plugin-
Playground-forbeholdet om at flaten ble slettet i Voyage v5.0.0.

Uendret med vilje: H1 (linje 1) og tagline (linje 3) er byte-identiske, sa
README-DESC-matchen mot forge-beskrivelsen fra af921a2 overlever. Headingene
## Install og ## Non-goals er beholdt ordrett -- de er maskin-sjekkede
strenger, lagt til i af921a2 for a lukke org-ops-ERROR.

Ingen release laget. Begrunnelse i STATE.md (local-only): konsumpsjons-
mekanismen for domain-packs/ios-app er snapshot-kopi med absolutt lokal sti
og pack.json-versjon, ikke git-ref, sa en repo-tag tilforer ingenting til den
ene reelle konsumenten; masterplan F2 gjor v0.4.0 til forste tag; og repoet
har null kjorbart innhold (46 filer, alle markdown/data).
This commit is contained in:
Kjell Tore Guttormsen 2026-08-17 13:35:40 +02:00
commit dec8048766

View file

@ -2,41 +2,41 @@
Pre-design pipeline from app concept to Voyage-ready feature briefs — interview, research, architecture, design, constraints, feature derivation, and a per-app HTML status view.
> **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.
> **Status:** Pre-design. No code has been written yet. Implementation waits on a manual prototype run — one real iOS app driven through the entire app-creator → Voyage pipeline by hand — before any of this is built. See [CLAUDE.md](CLAUDE.md) for the full context.
## Install
Ingen kode finnes ennå (pre-design, se Status over) — det er ingenting å installere. Dette avsnittet fylles med reelle install-steg når implementering starter etter roadmap-forutsetningene i [CLAUDE.md](CLAUDE.md).
No code exists yet (pre-design, see Status above) — there is nothing to install. This section gets real install steps when implementation starts, after the roadmap preconditions in [CLAUDE.md](CLAUDE.md) are met.
## Tre-tier-systemet
## The three-tier system
| 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? |
| Tier | Plugin | Question it answers |
|------|--------|---------------------|
| 1 | Voyage | How do we carry out this task correctly? |
| 2 | app-creator | What does the app need, and what is the next brief? |
| 3 | app-factory | Which app needs me now, and what action does it require? |
## Hva app-creator skal gjøre
## What app-creator is meant to do
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.
Drive a single app from idea to feature backlog through seven phases: interview → research (optional) → architecture decisions → design system → constraints → feature derivation → one brief per feature. Each phase produces an artifact on the filesystem. The brief phase generates Voyage-compatible markdown files that Voyage `/trekplan` consumes without modification.
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.
The per-app HTML renders every artifact, shows phase progress and attention, and lets you drill down into the artifacts from each feature's Voyage run (`voyage_run_dir` + annotate HTML). The patterns are inherited from Voyage's v4.3 Plugin Playground — a historical ancestor; the surface itself was deleted in Voyage v5.0.0.
app-creator eksekverer ikke Voyage. Briefer overleveres som filer.
app-creator does not execute Voyage. Briefs are handed over as files.
## Non-goals
- 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
- Carrying out tasks (that is Voyage's job)
- Executing the Voyage runtime (briefs are a file handover, not a runtime call)
- Aggregating multiple apps (that is app-factory's job)
- Replacing Linear/Jira, or assuming any external PM tool (tool-agnostic is a hard invariant)
- Coordinating teams
- Running autonomously without a human in the loop
## Posisjonering
## Positioning
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.
Solo-maintained, fork-and-own. Primarily for the author's own work. Issues welcome as signals — no pull requests. No backward compatibility guarantees before v1.0.0.
## Lisens
## License
MIT — se [LICENSE](LICENSE).
MIT — see [LICENSE](LICENSE).