app-creator/README.md
Kjell Tore Guttormsen 2e941dd785 feat(app-creator,app-factory): lock three-tier HTML architecture, tool-agnostic invariant
Tre-tier HTML-modell låst som endelig arkitektur:
- Tier 1: Voyage Plugin Playground (per-feature, v4.3+)
- Tier 2: app-creator per-app HTML (per-app, fase-progress + alle artefakter + attention)
- Tier 3: app-factory portefølje-HTML (per-portefølje, alle apper + klikk-til-terminal)

Hver tier har samme arkitektoniske form: AI skriver state i filer, tynt HTML
rendrer, menneske handler i terminal. Ingen backend, ingen RPC, ingen vendor-
låsing.

Verktøy-agnostisk lagt inn som HARD invariant: app-factory må fungere uten
Linear/Jira/Asana/etc. Tredjeparts sync-plugins er opt-in og additivt.
Tidligere Linear-overlag-modell forkastet.

Ny: app-factory/docs/architecture-brief.md (~190 linjer) som låser
arkitektur-invariantene og dokumenterer tekniske spørsmål som må avklares
ved /trekbrief.

Oppdatert i begge plugins:
- CLAUDE.md med tier-language, verktøy-agnostisk-grense, HTML-invarianter
- README.md med tre-tier-pitch
- ROADMAP.md med per-app HTML / portefølje-HTML i Later, sync-plugin-arkitektur
- CHANGELOG.md med arkitektur-låsing dokumentert
- alignment-brief.md: Funn 5 oppdatert (klikk-til-terminal er manuell, ikke autonom),
  ny non-goal om eksterne PM-verktøy som kjerne-avhengighet

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-10 16:16:20 +02:00

38 lines
1.8 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 hver features Voyage Plugin Playground.
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.