research(app-creator): S10 — friksjon #11 (OVERRIDE-numbering-kollisjon) + #12 (constraints-brief lengde)
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).
This commit is contained in:
parent
2e10a4ed7b
commit
6e72fa2e10
1 changed files with 82 additions and 0 deletions
|
|
@ -242,3 +242,85 @@ Prosess-/spec-merknader fra S8 (ikke nummererte friksjons-poeng):
|
||||||
- **Token-budsjett:** sesjonen holdt seg godt under 250K — hovedkontekst-belastning var lavt fordi research-bulk levde i agent-kontekstene (kombinert ~95K der). Hovedkontekst-skrivinger: research-brief (~1278 ord), state.json (~50 linjer), SESSION-LOG S8-seksjon (~3000 ord), NEXT-SESSION-PROMPT-S9 (~3500 ord forventet), SESSION-ROADMAP-edit (mindre).
|
- **Token-budsjett:** sesjonen holdt seg godt under 250K — hovedkontekst-belastning var lavt fordi research-bulk levde i agent-kontekstene (kombinert ~95K der). Hovedkontekst-skrivinger: research-brief (~1278 ord), state.json (~50 linjer), SESSION-LOG S8-seksjon (~3000 ord), NEXT-SESSION-PROMPT-S9 (~3500 ord forventet), SESSION-ROADMAP-edit (mindre).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## #11: OVERRIDE-numbering-kollisjon mellom `state.json` `attention` og `pack-overrides.md`
|
||||||
|
|
||||||
|
**Fase:** 5 (observert under S10 constraints-syntese)
|
||||||
|
**Type:** kontrakt-/konvensjons-friksjon
|
||||||
|
**Observert:** 2026-05-13 (S10) — under lukking av "tekstsitater i feature #6"-beslutningen som var merket `[OPEN] OVERRIDE-3` i Akashic state.json `attention`
|
||||||
|
|
||||||
|
**Beskrivelse:** S8 la til en `attention`-entry merket `[OPEN] OVERRIDE-3: tekstsitat-overlay i feature #6 — fase 5-beslutning` (avledet av research-brief § Restrisiko). Numbering brukte neste-ledige-i-prosessen-rekkefølge uten å sjekke `pack-overrides.md`, hvor `[OVERRIDE-3]` allerede var i bruk for **MASVS-AUTH N/A** (LUKKET siden S7). Resultat: to forskjellige beslutninger med samme navn "OVERRIDE-3", én i hvert dokument. S9 NEXT-PROMPT for S10 refererte begge versjonene om hverandre uten å resolvere kollisjonen ("§ OVERRIDE-3 (MASVS-AUTH N/A, allerede LUKKET — gjenbruk begrunnelsen)" + "Lukk OVERRIDE-3 (tekstsitater)"). S10-constraints-brief må håndtere kollisjonen ad hoc.
|
||||||
|
|
||||||
|
**Hva som ble gjort i S10:** "Tekstsitater"-beslutningen behandles som en **ny app-spesifikk constraint** i `05-constraints-brief.md` § Feature #6 mediekildebruk-policy, IKKE som en pack-override (den deviates ingen pack-default-regel — pack-snapshotet sier ingenting om tredjeparts-tekstsitater). `pack-overrides.md` får ingen ny entry. `state.json` `attention` fjerner OVERRIDE-3-entryen (lukket av S10). Friksjons-merknad i constraints-briefen forklarer kollisjonen.
|
||||||
|
|
||||||
|
**Lærdom for app-creator-designet:** `state.json` `attention`-konvensjonen tillater fritekst-beskrivelser, men når en entry navngir "OVERRIDE-N" implisitt forventes det at den korresponderer med en entry i `pack-overrides.md`. Når den ikke gjør det (fordi det er en ny app-spesifikk beslutning, ikke pack-deviasjon), bør den navngis annerledes.
|
||||||
|
|
||||||
|
**Foreslått revisjon:** `phase-design-draft.md` § Cross-cutting state.json får en regel:
|
||||||
|
- `attention`-entries som refererer pack-overrides bruker `[OVERRIDE-N]` (matcher `pack-overrides.md` § [OVERRIDE-N]).
|
||||||
|
- `attention`-entries som er nye app-spesifikke beslutninger som ikke deviates pack-defaults bruker **ikke** OVERRIDE-N. Foreslåtte alternative prefikser: `[DECISION-NN]` (per fase nummerert; bærer beslutnings-id som er fase-stabilt) eller bare beskrivende ID-løs entry med `phase` + `description`-felt.
|
||||||
|
- Når en `attention`-entry navngis, sjekk eksisterende `pack-overrides.md`-numbering først — håndhevbar via en pre-commit-sjekk hvis nødvendig (lav prioritet — forfatter-disiplin er nok i prototype-fasen).
|
||||||
|
|
||||||
|
Avgjøres ved neste `phase-design-draft.md`-revisjon. Lav prioritet — én observasjon i en levende prototype, ikke et systematisk problem ennå. Hvis flere kollisjoner dukker opp i fase 6/7: hev prioritet og formaliser.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## #12: Constraints-brief er den tyngste fase-artefakt-typen — sprenger lengde-grensen sterkere enn andre
|
||||||
|
|
||||||
|
**Fase:** 5 (observert under S10)
|
||||||
|
**Type:** design-friksjon (lengde-grense, bekreftelse av #10-mønster)
|
||||||
|
**Observert:** 2026-05-13 (S10) — under skriving av `05-constraints-brief.md`
|
||||||
|
|
||||||
|
**Beskrivelse:** S10 constraints-brief målte **3497 ord** (inkl. frontmatter). Sammenlignet med tidligere fase-briefer:
|
||||||
|
| Brief | Ord | Fase |
|
||||||
|
|-------|-----|------|
|
||||||
|
| `01-app-brief.md` (rev 1) | 1830 | 1 |
|
||||||
|
| `02-research-briefs/01-sadhguru-copyright.md` | 1278 | 2 |
|
||||||
|
| `03-architecture-brief.md` (rev 0) | 1827 | 3 |
|
||||||
|
| **`05-constraints-brief.md` (rev 0)** | **3497** | **5** |
|
||||||
|
|
||||||
|
Constraints-briefen er nær 2× alle andre. Innholdet er ikke fyllstoff: ISO 25010 (6 karakteristikker med Akashic-constraints) + WCAG 2.2 AA (4 nye + 14 bærende + 5 iOS-røyktest = 23 items) + MASVS 2.1 (8 kontroll-grupper, hver med 2–4 sub-constraints) + `PrivacyInfo.xcprivacy`-utfylling + App Privacy Details-beslutning (lukker OVERRIDE-2) + Feature #6 mediekildebruk-policy (5 enforce) + `.timeSensitive`-entitlement (5 enforce) + App Store-plattform-regler (A 8, B 4, C 11, D 3, E 4 = 30 items) + governance (8 enforce) + test-strategi (9 items) + konflikt-håndtering (6 reelle konflikter) + Referanser. Hver constraint er kortfattet; problemet er at constraints-fasen er anvendelsen-mot-flere-standarder-pluss-app-spesifikke-regler, ikke én fokusert beslutning.
|
||||||
|
|
||||||
|
**Hva som ble gjort i S10:** Brukte `length_review_flag` med ærlig begrunnelse. Ikke splittet briefen i sub-filer denne sesjonen — vurdert, men droppet fordi sammenhengen mellom MASVS-PRIVACY → App Privacy Details → Feature #6-policy → governance leses best i én fil. Splitting til `05-constraints-brief/{quality,accessibility,security-privacy,platform,governance,test,conflict}.md` er en framtidig kandidat hvis briefen vokser ytterligere (lite sannsynlig — det meste er nå dokumentert).
|
||||||
|
|
||||||
|
**Lærdom for app-creator-designet:** Per-artefakt-lengde-tabellen fra #10 må oppdateres med en eksplisitt rad for constraints-brief:
|
||||||
|
| Artefakt | Foreslått grense |
|
||||||
|
|----------|------------------|
|
||||||
|
| `01-app-brief.md` | ~2000 ord (review-flagg ved >2500) |
|
||||||
|
| `02-research-briefs/NN-*.md` | ~1500 ord (review-flagg ved >2000) |
|
||||||
|
| `03-architecture-brief.md` (full, med 4+ ADR-er) | ~2000 ord (review-flagg ved >2500) |
|
||||||
|
| **`05-constraints-brief.md`** | **~3500 ord (review-flagg ved >4500)** — eller splitting-konvensjon ved >4000 |
|
||||||
|
| `06-features-brief.md` | ≤500 ord *intro* + ≤8 linjer per feature-entry |
|
||||||
|
| `features/{NN}-{slug}/brief.md` (fase 7) | ≤500 ord |
|
||||||
|
| `features/{NN}-{slug}/context.md` (fase 7) | ≤500 ord |
|
||||||
|
| `01-interview-transcript.md`, `00-context/domain-pack-*.md`, `examples/*` | unntatt |
|
||||||
|
|
||||||
|
Bekrefter at fase 5 er **bredde-fase** (alle standarder + plattform + governance + test-strategi i ett dokument) mens fase 3 er **dybde-fase** (ADR-er — fokusert per beslutning). Bredde-faser sprenger grenser; dybde-faser holder seg mer kontrollert.
|
||||||
|
|
||||||
|
**Foreslått revisjon:** Oppdater `phase-design-draft.md` § Hard lengde-grense med differensiert tabell over (en konkretisering av #10-mønsteret). Eller introdusér en `[breadth-phase]`-merking på fase 5 (og potensielt fase 1, app-brief) som signaliserer at ~3000–4000 ord er normal-tilstand, ikke avvik. Avgjøres ved neste `phase-design-draft.md`-revisjon (etter fase 6/7 også er kjørt, slik at hele lengde-mønsteret er empirisk).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ny friksjon oppstått i S9
|
||||||
|
|
||||||
|
Ingen ny nummerert friksjon. Bekreftelser + prosess-merknader:
|
||||||
|
- **#10 (per-artefakt-lengde-grense) bekreftes igjen.** Arkitektur-briefen målte 1827 ord — mellom app-brief (1830) og research-brief (1278). 6 ADR-er à ~150–180 ord + Problem-gate + Stack-sammendrag + Requirements + AQ + Patterns + Integrasjoner = nær 2000. Per-artefakt-lengde-tabell-forslaget fra #10 må justeres: arkitektur-briefer med 4+ ADR-er er ~1500–2000 ord, ikke <500. (Tabell-revisjons-forslag levert i #12 over.)
|
||||||
|
- **AQ-NNN i brief overlap med state.json `attention`.** AQ-002 lever i `03-architecture-brief.md` § Uavklarte arkitektur-spørsmål **og** i `state.json` `attention`. Det er ikke duplisering per se — briefen er sannheten, state.json gir bare app-factory en pekepost. Kontrakten "når en AQ også fortjener en attention-entry" er implisitt: vurderingen som driver senere faser (AQ-002 driver fase 6) → ja, attention-entry; AQ-001 driver implementering (ikke fase) → nei, ingen attention-entry. Bør formaliseres i `phase-design-draft.md` § Cross-cutting state.json ved neste revisjon (lav prioritet).
|
||||||
|
- **Fase 4-skipping første gang i bruk.** `phase_status."4": {"status": "skipped", "reason": "..."}` brukt for første gang per `phase-design-draft.md` § Cross-cutting state.json. Spec-kompatibelt, ingen friksjon — skip-mekanikken funker som tiltenkt.
|
||||||
|
- **Token-budsjett:** sesjonen holdt seg godt under 250K-grensen. Ingen sub-agent-bulk å outsourcs til; hovedkontekst bar all syntese — likevel ikke nær grensen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ny friksjon oppstått i S10
|
||||||
|
|
||||||
|
To nye nummererte friksjons-poeng: #11 (OVERRIDE-numbering-kollisjon, over) og #12 (constraints-brief sprenger lengde-grensen sterkere enn andre, over).
|
||||||
|
|
||||||
|
S10-bekreftelse på eksisterende friksjon:
|
||||||
|
- **#10 (lengde-grense):** Bekreftes for fjerde fase-artefakt (1, 2, 3, 5 alle sprenger). Lengde-mønsteret er nå empirisk klart: 1500–3500 ord er normal for fase-briefer i Akashic-kjøringen. Tabell-revisjons-forslag konsolidert i #12.
|
||||||
|
|
||||||
|
Prosess-/spec-merknader fra S10 (ikke nummererte friksjons-poeng):
|
||||||
|
- **Constraint-eierskap/testbar-form-stress-testen funket.** Per S10-prompt Steg 2: "bekreft for deg selv at hvert constraint i briefen har en avklart eier og en testbar form". Praktisk konsekvens: WCAG 2.5.7 Dragging Movements ble eksplisitt N/A (ingen drag i Akashic v1), 1.4.13 Content on Hover or Focus ble droppet (ikke relevant — appen har ingen popovers/tooltips), MASVS-CRYPTO ble eksplisitt N/A (ingen krypto i appen). Briefen er Akashic-tilpasningen, ikke uttømmende-pack-checklist-kopi — testen tvinger denne disiplinen.
|
||||||
|
- **Apple App Privacy Details FAQ var entydig nok til strict-correct posisjon.** Operativ konsekvens: ADR-002 + ADR-003 har tvunget bort all telemetri-SDK-overflate; ADR-004 har tvunget bort all location-off-device. Apple-kriteriet "collected = transmitted off-device" er da entydig oppfylt → "Data Not Collected" vinner over pack-pattern-konservativ ("Location → App Functionality"). Pack-pattern-konservativisme er gyldig som *default* når man ikke vet; her vet vi. Bekrefter app-brief § Eierskap "konservativ vinner ved tvil" — *ved tvil*, ikke som permanent retning.
|
||||||
|
- **Constraints-eieren-vinner-løsning på donasjons-konflikt.** App-brief § Constraint-signaler sier "ikke-affiliering" (enforce), § Release-modell sier "7 % donasjon kommuniseres i App Store-beskrivelse" (constraint). Hvis disse plasseres uforsiktig kan teksten *implisere* affiliering ("vi gir til Isha" = "vi er nær Isha"). Løsning lever i briefen § Konflikt-håndtering: distinkt formulering ("uavhengig tredjepart-app + frivillig donasjon som anerkjennelse av kilden"). Ikke en ny friksjon — operatør-løsning under syntese fungerer.
|
||||||
|
- **Token-budsjett:** sesjonen holdt seg under 250K. Hovedkontekst-belastning: 4 fase-briefer (app, research, architecture, constraints i full lesing) + pack-snapshot relevante seksjoner + pack-overrides.md + state.json + SESSION-LOG S8/S9 + phase-design § Fase 5. Skrivinger: constraints-brief (3497 ord — største fase-artefakt-skriving så langt), state.json (~75 linjer), pack-overrides.md-edit (~30 linjer), friksjon.md-tilskudd (denne + #11 + #12), SESSION-LOG S10-seksjon (kommer), SESSION-ROADMAP-edit (mindre), NEXT-SESSION-PROMPT-S11. Hovedkontekst-belastning er tyngst i S10 så langt fordi ingen sub-agent å outsourcs til OG fordi syntese-output er nær 2× tidligere — men fortsatt ikke nær 250K-grensen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue