design(app-creator): S7 — restrukturer Akashic-instans + materialiser domain-pack-snapshot + revider app-brief
- docs/domain-pack-spec.md: snapshot-materialiserings-mekanikk LÅST (S7) — 6-stegs seksjons-struktur: H1-tittel + topp-metadata + Relevante patterns + per-core-fil H2 (nedjustert ett heading-nivå) + inline OVERRIDE-blockquotes + Overrides-anvendt-tabell. Referanse-impl: Akashic 00-context/domain-pack-ios-app.md. - prototype-run/friksjon.md: ny #10 — app-brief sprenger 500-ord-grensen (Akashic 01-app-brief.md revision 1 = 1830 ord etter bevisst-ikke-oppblåst revisjon). Foreslår per-artefakt-lengde-tabell ved neste phase-design-draft.md-revisjon (app-brief ~2000 ord; andre ≤500; snapshots/transcripts/examples unntatt). + Ny friksjon oppstått i S7-seksjon med 3 prosess-/spec-merknader (snapshot-mekanikk-detaljer LÅST, pack-overrides [STATUS]-konvensjon foreslått formalisert, app.md frontmatter-form konvergert til spec). Akashic-side endringer i eget repo: 00-context/ (snapshot + pack-overrides), features/ (med README.md), app.md, state.json, 01-app-brief.md rev 0→1 inkl. iOS-versjons-korreksjon (friksjon #9). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
2011507ea1
commit
347271aff9
2 changed files with 51 additions and 2 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# Domain-pack-spec (app-creator)
|
||||
|
||||
<!-- Skrevet: 2026-05-11 (S5). Revidert: 2026-05-12 (S6) — pack.json `components`-felt + status; core/supplementary-merking låst til pack.json; checklist-splitt-konvensjon; D7 oppdatert (pakkene forfattet); iOS-versjons-korreksjon (iOS 26, ikke "iOS 18/19"); restrisiko-lista oppdatert. -->
|
||||
<!-- Skrevet: 2026-05-11 (S5). Revidert: 2026-05-12 (S6) — pack.json `components`-felt + status; core/supplementary-merking låst til pack.json; checklist-splitt-konvensjon; D7 oppdatert (pakkene forfattet); iOS-versjons-korreksjon (iOS 26, ikke "iOS 18/19"); restrisiko-lista oppdatert. Revidert: 2026-05-13 (S7) — snapshot-materialiserings-mekanikk LÅST mot Akashics faktiske materialisering. -->
|
||||
<!-- Status: ANDREUTKAST. Domene-nøytral spec. Referanse-pakkene (ios-app komplett, claude-code-plugin som stub) er forfattet i `../domain-packs/` (S6). Spec-en er fortsatt hypotese inntil den første referanse-pakken faktisk er konsumert av en pipeline-fase (S8+). -->
|
||||
<!-- Begrunnelse / research-grunnlag: prototype-run/research/research-brief.md § 5 (D1–D7), prototype-run/research/C-domain-packs.md § 5, friksjon #5, #7, #9. -->
|
||||
|
||||
|
|
@ -181,7 +181,15 @@ app-creator shipper to referanse-pakker som eksempel-implementasjoner i [`../dom
|
|||
|
||||
## Åpne spørsmål / restrisiko
|
||||
|
||||
- **Snapshot-materialiserings-mekanikk.** Nøyaktig hvordan `00-context/domain-pack-{name}.md` genereres fra `domain-packs/{name}/` — låses når den første pakken faktisk materialiseres i **S7**. S6-presisering: generatoren leser `pack.json` → `components`, slår sammen alle `"core"`-filene i den rekkefølgen `components` lister dem (`conventions.md`, `gotchas.md`, `checklist.md` + evt. `checklist-{tema}.md`), skriver pack-navn + `version` + materialiserings-dato i toppen, anvender `00-context/pack-overrides.md` på slutten. `supplementary` tas *ikke* med — lastes on-demand. Eksakt trimming/seksjonering avgjøres i S7 mot den faktiske `ios-app`-pakken.
|
||||
- **Snapshot-materialiserings-mekanikk — LÅST (S7, 2026-05-13).** Generatoren leser `pack.json` → `components`, slår sammen alle `"core"`-filene i den rekkefølgen `components` lister dem, og produserer ett markdown-dokument med følgende seksjons-struktur:
|
||||
1. **H1-tittel:** `` `{pack-name}` domain-pack snapshot — {app-slug} ``.
|
||||
2. **Topp-metadata-blokk:** pack-navn + `version` + materialiserings-dato + pack-kilde-sti + pack `verified`-dato/-mot + snapshot-disclaimer ("endringer i pakken forplanter seg ikke hit automatisk; re-materialiser ved pack-bump") + overrides-disclaimer ("se `pack-overrides.md` og inline `[OVERRIDE-N]`-markører") + supplementary-disclaimer.
|
||||
3. **`## Relevante patterns for denne appen`** — pekere (én linje per pattern: navn + én-linjes formål + Akashic-relevans), aldri full pattern-tekst. Bestemmes per app — hvilke patterns appen faktisk bruker.
|
||||
4. **`## {core-fil-1}` … `## {core-fil-N}`** — én H2 per core-fil, i `components`-rekkefølge. Originale headings nedjusteres ett nivå (orig H1 → snapshot H2, orig H2 → snapshot H3, osv.) for å gi konsistent dokument-hierarki. Inline `> **[OVERRIDE-N]** ...`-blockquotes der en override gjelder, med peker til `pack-overrides.md` § [OVERRIDE-N]. En `<!-- Fra `{filnavn}` -->`-kommentar over hver seksjon for sporbarhet.
|
||||
5. **`## Overrides anvendt`** — tabell (ID, pack-fil/regel, status, sammendrag) + peker til `pack-overrides.md` for full begrunnelse.
|
||||
6. **Sluttnotat** — én linje som bekrefter at `core` er inkludert og `supplementary` lastes on-demand.
|
||||
|
||||
`supplementary` (patterns, scaffold, examples, glossary) tas *ikke* med i body — pekere ja, innhold nei. Snapshotet er unntatt 500-ord-lengdegrensen (det er en sammenslåing av eksisterende filer, ikke ny prosa — jf. `examples/`-unntaket i § D2). Referanse-implementasjon: `/Users/ktg/repos/akashic-intelligence/00-context/domain-pack-ios-app.md` (S7).
|
||||
- **`core` vs `supplementary`-merking — LÅST (S6).** Ligger i `pack.json` → `components` (map fil-sti → `"core"`/`"supplementary"`). Fil-headere har en redundant kommentar for menneske-lesere, men `components` er kilden. Se § D2 / § D3 / § D4.
|
||||
- **`pack.md` med YAML-frontmatter som alternativ til `pack.json` — LUKKET (S5/S6).** `pack.json` valgt og brukt; ingen grunn til å revurdere. Tatt ut av risiko-lista.
|
||||
- **Når en fase trenger en `patterns/`-fil som ikke er i `phases`-lista.** Skal pakken da utvides, eller skal fasen klare seg uten? Sannsynlig: utvid pakken (en pattern relevant for en fase hører i pakken) — men det er en per-tilfelle-beslutning. Ikke truffet i S6 (ingen fase ble kjørt).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue