brief_version 2.0 → 2.2 (framing + phase_signals + ## TL;DR), re-verifisert
mot voyage/5.9.1 HANDOVER-CONTRACTS.md + trekbrief-template.md 2026-08-11.
Framing-avledningsregel (preserve/refine + operatør-overstyring), phase_signals
med begrunnet "standard"-default (ikke phase_signals_partial — fase 7 har intet
intervju å avbryte), TL;DR-generatorregel.
Handover-mekanikk (R-03) definert og verifisert mot kildekode, ikke antatt:
masterplanens anbefalte "loose-modus konsekvent" er ikke teknisk mulig —
/trekresearch har intet --brief-flagg og krever en pre-eksisterende --project
<dir>. app-creator standardiserer derfor project_dir på
features/{NN}-{slug}/voyage/ med et eksplisitt materialiserings-steg
(mkdir+cp) foran konsekvent --project-bruk for research/plan/execute — fikser
R-03s BRIEF_NOT_FOUND-feilscenario. research.md-rollen avklart ærlig som
app-creator-internt underlagsmateriale, ikke Voyage-input (R-04) — konsum
IKKE verifisert, avgjøres i B1.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EmQGwa3dQ36fjRGfZS7wmS
b59928b (2026-05-15) rettet to MCP-toolchain-gotchas i ios-app-pakken
men bumpet aldri pack.json. Manifestet har derfor pastatt 0.2.0 siden da,
mens innholdet var 0.2.1 (commit-meldingen sa til og med "(v0.2.1)").
Alle nedstroms-pins (Akashic state.json, brief-frontmatter, app.md,
00-context-snapshot) peker paa en versjon som ikke lenger beskriver
pakken. Dette er A3s "en sann pack-versjon overalt".
- version 0.2.0 -> 0.2.1
- changelog-entry som beskriver b59928b-innholdet: 'mcp'-subkommandoen
til XcodeBuildMCP + mcpbridge-kravet om aktivt workspace-prosjekt
Patch-bump per domain-pack-spec.md D5: retting av eksisterende gotcha +
scaffold-template, ingen nye komponenter, ingen betydningsendring.
Verifisert: b59928b er eneste commit mot domain-packs/ios-app/ etter
0.2.0-manifesteringen (9c3c85b) - `git log -- domain-packs/ios-app/`.
`grep '"version"' pack.json` -> 0.2.1; JSON validerer.
Akashic-halvdelen (re-materialisering + pin-oppdatering) gaar via
coord-send; skrives ikke herfra.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RXg1SVb2RQuMpVwGWdfe94
Erstatter den flate ≤500-ords-grensen med friksjon #14-tabellen (ni
artefakt-typer, target + review-flagg + driver). Den flate grensen ble
brutt av samtlige åtte artefakter Akashic-prototypen produserte, hver
gang av en driver som ikke var seremoni.
Operatør-beslutning (A2, alternativ a + full rekkevidde): revisjons-
historikk flyttes ut av kilde-artefakten til en sidecar —
<artefakt>.revisions.md for fase 1-6, features/{NN}-{slug}/revisions.md
for fase 7. Driver: F-001 brief.md var 4523 ord der ~740 var kontrakten
Voyage skal lese; resten var norsk beslutningshistorikk som ellers
overleveres til planneren. Alternativene context.md og strip-ved-
handover ble vurdert og forkastet (context.md overleveres også;
strip gir to versjoner av samme kontraktsfil uten drift-fangst).
04-design-brief-raden er eksplisitt merket [anslag - ikke målt]: fase 4
ble hoppet over i prototypen, så tallet er ikke empirisk som de øvrige.
§ Hard lengde-grense er dermed låst; header-kommentarens IKKE LÅST-liste
er redusert til § Fase 7 (A5) + state.json-schema (C2).
Verifisering: grep "500 ord eller én skjerm" -> 0; gjenværende 500-treff
er tabellverdier + den historiske omtalen. Domain-pack-filenes egen
~500-ords-grense (domain-pack-spec.md:38) er en annen regel med annen
begrunnelse og er uendret.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TrpGFqhXDifptogGrGgVPC
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
Per ~/.claude/CLAUDE.md § Kontinuitets-system: ROADMAP.md er navngitt som
forbudt lokal påfunns-mekanisme. Konsoliderer:
- app-creator/ROADMAP.md → app-creator/docs/roadmap.md (planer hører i docs/)
STATE.md dekker "Now"; CLAUDE.md dekker "Parked". docs/roadmap.md beholder
unike deler: Forutsetninger, v0.4.0-milepæl, Senere.
- Marketplace .gitignore: fjerner REMEMBER.md og MEMORY.md.
Å gitignorere forbudte mønstre skjuler brudd — konvensjonen vil gjøre dem
synlige slik at de kan konsolideres + slettes.
- Marketplace CLAUDE.md: fjerner stale REMEMBER.md-referanse i fil-treet.
Ikke berørt (annet plugin-scope): app-factory/{TODO.md,ROADMAP.md} — flagges
for separat opprydding.
STATE.md er lokal state-of-play, ikke kildekode. Tilsvarer *.local.md /
REMEMBER.md / MEMORY.md som allerede er ignorert. Forrige commit (8eb625f)
trackte STATE.md ved en feil — untracket nå med git rm --cached.
Filen forblir på disk; bare git-tracking fjernes.
Erstatter lokale kontinuitets-mekanismer (TODO.md, NEXT-SESSION-PROMPT.local.md,
SESSION-ROADMAP.local.md, SESSION-LOG.local.md) med én STATE.md per
~/.claude/CLAUDE.md § Kontinuitets-system (2026-05-26).
STATE.md (47 linjer, innenfor ~60-grense) fanger aktiv oppgave (S15 — fase 7
fortsetter), neste konkrete steg, operatør-direktiv, parallelt manuelt arbeid
og åpne tråder. Historikk → git. Friksjons-data bevart i prototype-run/friksjon.md.
De .local.md-filene var allerede gitignorerte; sletting skjer kun på disk.
Standardize named-markdown-link guidance across all plugins so file://
references render as independently clickable links in terminals like
Ghostty (bare file:// URLs only make the first clickable).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Akashic-prototype-feilrapport (S15+1): begge MCP-servere feilet ved første
oppstart. To rotårsaker som domain-pack-templaten ikke advarte om:
1. XcodeBuildMCP krever 'mcp'-subkommando — uten den henger CLI-en ved
stdin-venting til Claude Code's 30s MCP-timeout. Symptom: 'connection
timed out after 30000ms'. scaffold/mcp.json oppdatert + presisert i
patterns/xcode-mcp-toolchain.md.
2. Apple mcpbridge trenger ikke bare Xcode KJØRENDE, men også et AKTIVT
workspace-prosjekt åpent. Bare å starte Xcode er ikke nok — server-
handshake lykkes (reconnect OK), men tool-listing timer ut. Patterns-
gotcha-tekst utvidet.
Lærdom: rasch validering med 'echo {initialize} | server-cmd' før vi
publiserer scaffold-templates i framtiden.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Materialiserer læringen fra Akashic S15 (første reelle iOS-bootstrap via
app-creator-pipelinen) tilbake i ios-app domain pack.
Spor B = MCP-stack-mønster for iOS-utvikling:
- XcodeBuildMCP (Sentry, github.com/getsentry/XcodeBuildMCP) — headless
via xcodebuild CLI, ~82 verktøy med strukturerte JSON-responser
- Apple mcpbridge (innebygd i Xcode 26.3+, /Applications/Xcode.app/Contents/
Developer/usr/bin/mcpbridge) — krever kjørende Xcode, gir tilgang til
levende editor-context
Komplementære, ikke overlappende. Begge registreres samtidig i .mcp.json.
Endringer:
- pack.json: v0.1.0 → v0.2.0, lagt til changelog-array, registrert 3 nye
components
- patterns/xcode-mcp-toolchain.md (NY): full pattern-dokumentasjon — hvorfor,
komponenter, setup, gotchas (CoreSimulator-mismatch, iOS-platform-runtime,
DEVELOPMENT_TEAM-tomt, npx vs global), forhold til Spor A
- scaffold/project.yml (NY): XcodeGen-template med iOS 17-baseline, Swift 6,
App Group-pattern, App Privacy Details-default
- scaffold/mcp.json (NY): MCP-stack-registrerings-template
Verifisert 2026-05-14 mot Xcode 26.5, XcodeBuildMCP v2.3.x-tier,
xcrun mcpbridge --help. Apple Xcode-integrasjon dokumentert via WebSearch
(blakecrosley.com sammenligningsartikkel + getsentry/XcodeBuildMCP).
Avledet fra Akashic-instans-commit dd7d876 (bootstrap S15).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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>
Operatør avslørte i S13 at app-creator-pipelinen mangler review-gate mellom faser.
Implementér mønsteret som spec + førstegangs-anvendelse på Akashic-prototypen.
phase-design-draft.md:
- Ny § Cross-cutting: Review-gate mellom faser (mellom state.json og brief-revisjon
ved backtracking) — sidecar-format, annoterings-vokabular (approved/revise/defer/
drop/question), applisering med revisjons-logg, oppstrøms-konsekvens-håndtering
(backtrack vs revision-pending), nedstrøms for fase 7 (drop→slett mappa, revise→
bump rev, defer→flytt), retroaktiv review, attention-entry-type, frekvens-regel
(obligatorisk), all-approved-shortkutt, forhold til status-merking.
- phase_status-vokabular utvidet med pending-review | revision-in-progress
- state.json-eksempelet viser ny objekt-form med sidecar-peker
- § Brief-pattern fikk peker til review-gate som hard krav
friksjon.md:
- #15: Fase-til-fase går uten review-gate (prosess-friksjon, kritisk)
- Beskriver problemet, hva som mangler, 5 strukturelle krav, S13-handling,
lærdom, anvendelse på allerede-fullførte faser, foreslått revisjon, drahjelp
fra Voyage /trekrevise-mønster, fase-overhead-implikasjon.
- S13-bekreftelse på eksisterende friksjon + prosess-merknader (operatør-
pedagogisk friksjon, omdefinert sesjons-omfang).
Akashic-side (separat repo): review-maler 06-features-brief.review.md +
features/01-sun-position/review.md, interim index.html, state.json oppdatert.
Committet i Akashic-repo separat (denne committen påvirker ikke ren instans).
Neste sesjon (S14): applisere review-annoteringer som revisjon 1, propagere
oppstrøms-konsekvenser, re-generere index.html, fortsette fase 7 hvis godkjent.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Voyage strict-mode + materialisert upstream-kontekst driver fase 7-artefakter til ~600-750 ord — over ≤500-targeten i friksjon #13-tabellen, men under naturlig grense. Konsolidert lengde-mønster over alle 7 fase-artefakt-typer skrevet så langt:
- bredde-faser (1/5/6): ~2000-3500 ord
- dybde-faser (2/3): ~1300-1800 ord
- fokus-per-feature (7-brief/context/research): ~600-750 ord per fil
Round-trip-test mot Voyage HANDOVER-CONTRACTS.md § Handover 1: PASS uten template-gap. Fase 7-templaten i phase-design-draft.md produserer Voyage strict-mode-kompatibel output første gang.
S12-bekreftelse på #5 (features/-layout funker), #10/#12/#13 (lengde-mønster konsolidert), #11 (numbering-disiplinen holder).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Logget under første ekte fase 6-kjøring i Akashic-pipelinen (S11).
#13: Fase 6-features-brief-lengde-target undervurderer Voyage-
handover-1-strukturert backlog. Friksjon #10/#12-tabellen satte fase
6 til ~500 ord intro + ≤8 linjer × ~14 entries ≈ ~1700 ord. Akashic
06-features-brief.md ble 2789 ord etter bevisst-stram syntese,
~40 % over. Driver: hver entry har 10 strekpunkter (Slug + Intent +
Goal + Non-Goals + Constraints + Preferences + Success Criteria +
Dependencies + Effort + Open) for å være Voyage-handover-1-
kompatibel — ≤8 linjer ble offer for fase-7-klar-struktur.
Stress-test-seksjonen (~280 ord) + R14-readiness-check (~270 ord) +
dependency-graf m/ mermaid (~110 ord) + kritisk sti/parallelle
grupper (~220 ord) er fase 6-spec-output, ikke fyllstoff.
Konsolidert lengde-mønster-tabell over alle 5 fase-briefer skrevet i
Akashic-kjøringen:
- Fase 1 app-brief: 1830 ord (bredde)
- Fase 2 research-brief: 1278 ord (dybde-per-tema)
- Fase 3 architecture-brief: 1827 ord (dybde, 6 ADR-er)
- Fase 5 constraints-brief: 3497 ord (bredde)
- Fase 6 features-brief: 2789 ord (bredde + Voyage-handover-1)
Mønster: bredde-faser ~2000-3500 ord, dybde-faser ~1300-1800.
Forslag for phase-design-draft.md § Hard lengde-grense ved neste
revisjon: differensiert tabell over artefakt-typer; fase 6 = ~3000
ord (review-flagg ved >4000). Vurder [breadth-phase]/[depth-phase]-
merking. Avgjøres etter fase 7 også er kjørt (empirisk grunnlag for
features/{NN}-{slug}/brief.md-grensen blir tydeligere da).
S11-bekreftelser på eksisterende friksjon:
- #10 + #12 (lengde-grenser): bekreftes for femte fase-artefakt
- #11 (OVERRIDE-numbering): ingen ny kollisjon i S11; AQ-002 var
AQ-NNN-formet, ikke OVERRIDE-N, så S10-lærdommen ble fulgt
Prosess-/spec-merknader (ikke nummererte friksjons-poeng):
- Scope-stress-test-disiplinen funket. Mage-estimat-tabell + sum +
kalender-vurdering + aksellerasjon-vurdering tvang fram konkrete
tall i § Scope-stress-test, ikke gjemt prosa. Forslag: § Scope-
stress-test bør være navngitt påkrevd seksjon i fase 6-templaten.
- R14 integrert som siste § i 06-features-brief.md vs separat
artefakt. Argumenter for integrering vant for v0. Re-vurderes
etter fase 7. Forslag: phase-design-draft.md § R14 sier
'integreres eller separat — operatør-valg'.
- Fase-overhead-tid ~1 t (lavere enn S10 ~1 t 20 min). Bekrefter
fase 6 = anvendelse-fase, smal syntese-overflate selv om absolutt
output-volum er nest størst.
Akashic 06-features-brief.md + state.json committet til Akashic-
repoet (commit b81d873). Ingen kobling — bare for sporing.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Logget under S10 Akashic-pipeline fase 5-kjøring:
#11: OVERRIDE-numbering-kollisjon mellom state.json attention og pack-overrides.md.
S8 la til 'OVERRIDE-3: tekstsitater i feature #6' i Akashic state.json attention
uten å sjekke pack-overrides.md, hvor OVERRIDE-3 = MASVS-AUTH (LUKKET). S10
løste kollisjonen ved å behandle tekstsitater som ny app-spesifikk constraint
(ikke pack-override). Foreslått revisjon: phase-design-draft.md § Cross-cutting
state.json får regel om navngiving — attention-entries som referer pack-overrides
bruker OVERRIDE-N (matcher pack-overrides.md); nye app-spesifikke beslutninger
som ikke deviates pack-defaults bruker ikke OVERRIDE-N.
#12: Constraints-brief er den tyngste fase-artefakt-typen — sprenger lengde-
grensen sterkere enn andre. S10 målte 3497 ord (~2× andre fase-briefer:
app-brief 1830, research-brief 1278, architecture-brief 1827). Bekrefter at
fase 5 er bredde-fase (alle standarder + plattform + governance + test-strategi
i ett dokument) vs fase 3 dybde-fase. Per-artefakt-lengde-tabell-revisjon
foreslått: ~3500 ord (review-flagg ved >4500) for constraints-brief, eller
introdusér [breadth-phase]-merking på fase 5 (og fase 1) som signaliserer
at ~3000-4000 ord er normal-tilstand.
Også: S9- og S10-bekreftelses-seksjoner for #10 (lengde-grense), prosess-
merknader for S10 (constraint-eierskap-stress-test funket; Apple App Privacy
Details FAQ entydig nok til strict-correct; donasjons-konflikt-løsning under
syntese).
S8 var første ekte fase 2-kjøring i Akashic-pipelinen. Selve research-
briefen ble committet i Akashic-repoet (separat git):
02-research-briefs/01-sadhguru-copyright.md (rev 0, confidence: medium,
22 kilder, 1278 ord m/ length_review_flag).
Endring i ktg-privat / plugins/app-creator:
- prototype-run/friksjon.md: la til S8-bekreftelse på #10 (lengde-grense
gjelder også for research-briefer som dekker 3+ kilde-domener; per-
artefakt-tabell-forslaget må trolig differensieres ytterligere) + ny
'## Ny friksjon oppstått i S8'-seksjon. Ingen ny formell friksjon —
research-modellen (parallell-spawning av docs- + community-researcher,
syntese i hovedkontekst) funket akkurat som S2/S3. Tre prosess-/spec-
merknader notert: confidence-vurdering trenger evt. differensiering
per sub-finding (lav prioritet), 'action-pending' er ny attention-type
i state.json (kategori-utvidelse), pre-submission-action sitter midt
mellom fase 5 og post-fase 7 (phase-felt-uklarhet — kontrakt-presisering
ved neste phase-design-draft-revisjon).
Andre app-creator-side filer (SESSION-LOG, SESSION-ROADMAP, NEXT-SESSION-
PROMPT) er .local.md (gitignored) og committes ikke.
Syntetiserer threads A-E til research-brief.md: 8 triangulerte funn med
confidence-rating, stillingstaken på default-retning-spenningen (A/B vs E),
restrisiko, revisjons-mandat R1-R17 for phase-design-draft.md, og
innholds-mandat D1-D7 for domain-pack-spec.md (skrives i S5).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Starter prototype-runet som driver app-creator-designet før implementering.
- prototype-run/friksjon.md: 6 friksjons-poeng oppdaget i Akashic fase 1
- prototype-run/README.md: forklarer oppsettet
Flersesjons-orkestrering (SESSION-ROADMAP/LOG/NEXT-SESSION-PROMPT.local.md)
ligger i plugin-roten, gitignored. Akashic-instansen ligger i eget repo.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Per-app-intervjuet manglet eksekverings-mekanisk disiplin der /trekbrief
har det. Importer fem mønstre som kjøre-disiplin (ikke kode), justert
for at app-scope er bredere og mykere enn task-scope:
1. Weakest-section-first-loop med standard prioritering
2. Anchor / Sharpen-mønster på vage svar
3. Aktiv research-tema-uthenting under dialog (Question / Confidence / Scope)
4. [ANTAKELSE]-markører for ting operatør ikke vet
5. 6 ja/nei kvalitets-sjekk-spørsmål før fase-eksit
Eksplisitt utenfor: mekanisk 1-5-scoring og dedikert reviewer-agent —
hører til per-task-kontekst der suksess-kriterier er command-checkable.
Status-merket [importert fra trekbrief, justert for per-app, hypotese] —
prototypen vil avsløre hvilke mønstre som faktisk hjelper vs er overhead.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Førsteutkast (831 linjer) som skisser app-creators 7-fase-pipeline med
unifisert brief-pattern: hver fase produserer én eller flere briefer med
felles grunnstruktur (frontmatter + phase-spesifikke seksjoner).
Brief-typer per fase:
- Fase 1: app brief (+ interview transcript som rå-kilde)
- Fase 2: research briefer (per tema, valgfri)
- Fase 3: arkitektur brief (med ADRs som seksjon)
- Fase 4: design brief (tokens + komponenter som seksjoner)
- Fase 5: constraints brief (inkl. test-dekning på app-nivå)
- Fase 6: features brief (backlog + dependency-graf, inkl.
test-infrastruktur-features)
- Fase 7: feature briefer per feature (Voyage handover, Handover 1)
Cross-cutting: state.json for app-factory-aggregering, brief-revisjon ved
backtracking, attention-heuristikker.
Eksplisitt scope-lås: app-creator dekker utviklings-prosessen.
Pre-decision (markedsanalyse) og post-shipping (TestFlight, marketing,
validation) er utenfor scope.
App-level testing: per-feature /trekreview er nødvendig men ikke
tilstrekkelig. Constraints-brief definerer test-dekningskrav på app-nivå
(E2E, A11Y, performance, regresjon); features-brief inkluderer
test-infrastruktur som features Voyage bygger.
Status-merking på alle templates: [hypotese], [arvet], [åpent]. Subject
to revision after iOS-prototype. v0.4.0 låser det som har overlevd
reell bruk.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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>
app-creator omdefinert som 7-fase pipeline (intervju → research → arkitektur
→ designsystem → constraints → features → briefer per feature) som produserer
Voyage-kompatible briefer. Brief-handover er filoverlevering, ikke
runtime-kobling.
Tidligere scope (lokal hjelper-prosess som eksekverer Voyage-kommandoer fra
HTML) er parkert — den brøt Voyages v4.3-modell (ingen kommando-utførelse
fra HTML) og var symptom av ikke-skarpt definert scope.
app-factory tilsvarende rescope: leser app-state, eksekverer ingenting.
Operatørens handling er context-switch til riktig app-creator-instans.
alignment-brief Funn 3 omskrevet fra hjelper-prosess-API til
brief-handover-format. Hard invariant lagt inn: runtime-kobling mellom
lagene er forbudt — alt går via filer.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
app-creator (lag 2): per-app-orkestrering. CLAUDE.md med Status/lag-tabell/
arkitektur-grense/scope-test/arbeidsregler. ROADMAP med v0.4.0-milepæl
som låser kontraktene app-factory bygger på. iOS som eksplisitt
testtilfelle, ikke tilfeldig domene.
app-factory (lag 3): per-portefølje state-aggregator. Allerede scaffolded
fra tidligere /repo-init; legger til docs/alignment-brief.md (174 linjer)
som identifiserer 5 kontrakter på tvers av Voyage/app-creator/app-factory:
Voyage stability promise, app-creator state-eksport schema, hjelper-
prosess-API, versjons-milepæl-konsistens, autonom-utløse-grensen.
Begge plugins er pre-design — ingen kode shipped. Implementering venter
på iOS app-prototype gjennom app-creator + Voyage som datagrunnlag.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
