design(app-creator): S13 oppdatering — adoptér Voyage annotate.mjs 1:1

Etter at operatør pekte på at Voyage allerede løser review-gate-mekanikken
i scripts/annotate.mjs (claude-code-100x-mønster — pencil-toggle, Fiks/Endre/
Spørsmål-intent, popover-form, localStorage-persistens, Copy Prompt-eksport):
forkastet egen-spec'd sidecar-format, adopterte Voyage 1:1.

phase-design-draft.md § Cross-cutting: Review-gate omskrevet:
- Forenklet fra fem-tier fast taksonomi (approved/revise/defer/drop/question)
  til Voyages tre-tier fri-form intent (Fiks/Endre/Spørsmål med fri kommentar).
- Mønsteret matcher hvordan operatør faktisk tenker — 'drop F-006' er en
  Endre-annotasjon med kommentar, ikke en separat drop-status.
- Konkret CLI-kall: node ~/.claude/.../voyage/scripts/annotate.mjs <brief.md>
  → produserer <brief>.html ved siden av kilde.
- Eksempel-flow for operatør (fase 6 review).
- Applisering-mekanikk på AI-side: parse Copy Prompt-format, applisere Fiks/
  Endre, svare på Spørsmål, bump revisjon, skriv revisjons-logg.

friksjon.md #15 utvidet med adopsjon-note:
- Bekrefter app-creator-invariant 'Voyage v4.3 er arkitektonisk forfar — gjenbruk
  disse 1:1' fra app-creator/CLAUDE.md.
- Pedagogisk friksjon: første utkast bygde egen-spec uten å sjekke Voyage først.
  Loggført som lærdom — sjekk Voyage-mønster FØR egen-spec for review-/audit-/
  annoterings-mekanikk.

Akashic-side (separat repo, separat commit): slettet sidecar-maler, generert
.html via annotate.mjs, oppdatert index.html med HTML-knapper, .gitignore,
state.json, attention-entries.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-14 10:55:54 +02:00
commit eba584515a
2 changed files with 45 additions and 49 deletions

View file

@ -478,6 +478,8 @@ Prosess-/spec-merknader fra S12 (ikke nummererte friksjons-poeng):
**Drahjelp fra Voyage-mønster:** `~/.claude/plugins/marketplaces/ktg-plugin-marketplace/plugins/voyage/commands/trekrevise.md` (kommando-spec) og `voyage/docs/HANDOVER-CONTRACTS.md` § "operatør-annotert brief/plan/review back into source artifact" — bør leses og adopteres strukturelt. App-creator implementerer ikke `trekrevise`-kommando, men adopterer mønsteret (anchored comments + canonical annotation_digest + revision in-place).
**Adopsjon i S13 (oppdatert 2026-05-14):** Etter at operatør pekte på at Voyage `scripts/annotate.mjs` (921 linjer, claude-code-100x-mønster — pencil-toggle, Fiks/Endre/Spørsmål-intent, popover-form, localStorage-persistens, Copy Prompt-eksport) **allerede løser** review-gate-mekanikken: forkastet egen-spec'd sidecar-format (`<artefakt>.review.md` med approved/revise/defer/drop/question-vokabular per anker), adopterte Voyage `annotate.mjs` 1:1 i stedet. Konsekvens for `phase-design-draft.md` § Cross-cutting: Review-gate: forenklet fra fem-tier fast taksonomi til tre-tier fri-form intent (Fiks/Endre/Spørsmål med fri kommentar). Voyage-mønsteret matcher bedre hvordan operatør faktisk tenker — "drop F-006" er en Endre-annotasjon med kommentar "drop fra v1", ikke en separat `drop`-status. Generering: `node ~/.claude/.../voyage/scripts/annotate.mjs <brief.md>` produserer `<brief>.html` ved siden av kilde-fila. HTML-filer er gitignored i Akashic-repoet (regenererbare, annotasjoner lever i localStorage). Dette er konkret anvendelse av app-creator-invarianten "Voyage v4.3 Plugin Playground er arkitektonisk forfar — app-creator gjenbruker disse 1:1" fra `app-creator/CLAUDE.md`.
**Fase-overhead-implikasjon:** Hvert fase-overgang får +1 review-runde (estimert 20-40 min operatør-tid + 10-20 min applisering-tid). For Akashic: 6 ferdige fase-artefakter (1, 2, 3, 5, 6, 7 F-001) → ~2-3 t retroaktiv review-arbeid hvis alle skal gjennomgås. Fremover: hver ny fase 7-feature får én review-gate (~30-60 min ekstra per feature × 12 gjenværende = 6-12 t). Dette er reell kost — men feilen av å hoppe over review (bygge på u-validert backlog) er større.
---