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>
