1
0
Fork 0
portfolio-optimiser-commons/docs/plan
Kjell Tore Guttormsen 3f18ca7c27 docs(plan): B1/D4 operator question — nav-golden's normative status, four costed options
The question turned out not to be binary. Three distinct reference shapes are
already in use across the specs, with different binding force:

  A  artifact-name-as-ground-truth   method-spec §7 :332-333
  B  directory convention + entries  ingest-spec §11 :259-267
  C  informative catalogue link      README :19

nav-golden has none of them. Verified: 0 hits in all five normative files
(method-spec, ingest-spec, CONCEPT, README, SKILL).

Two findings that constrain the option space:

- method-spec never names a repo path at all (`grep -c 'examples/'` -> 0; the
  ten `/`-bearing tokens are in-bundle link syntax). A shape-B reference would
  be the first one in that document.
- Elevating to §7 ground truth (O3) means rewriting two counting claims, not
  adding a sentence: §7 "two JSON files ... the only ground truth" and the §1
  conformance clause 2 "on the shared example bundle" (singular).

Also surfaced: nav-golden's serialization is not byte-pinned
(nav-golden-hierarchy/README.md:31-33 says MAY) while the sister class
ingest-golden is (:267, :280). Two conforming gates can disagree on the same
fixture today, independent of whether the spec names the class.

No normative text changed; no new text proposed. Ratification is the operator's.

Amendment-underlag §8: corrected the verification-log check, which cited
`grep -rn 'nav-golden' *.md` -> 0 hits. That command now returns 3 (all in the
gitignored, non-normative STATE.md). The claim holds; the check was too wide.
Re-aimed at the five normative files, and cross-linked to the new document.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XYkLsRfSBBUjULS219Fy8X
2026-07-25 20:29:33 +02:00
..
2026-07-16-llm-ingestion-guard-adoption.md docs(plan): guard adoption plan pins no version — v0.2 header was stale 2026-07-25 15:06:07 +02:00
2026-07-20-f1-freetext-connector-direction.md docs(plan): F1 direction — free-text sources belong in ingest-spec door A 2026-07-20 07:26:02 +02:00
2026-07-20-q3-bundle-shape-navigation-conflict.md docs(plan): Q3 finding — method-spec §3 silently forbids hierarchical bundles 2026-07-20 08:53:33 +02:00
2026-07-23-d2-register-form-fix.md docs(plan): D2 register-form fix — two-output model resolves ÅS#5 2026-07-23 22:14:00 +02:00
2026-07-23-d3-status-vocabulary.md docs(plan): D3 ratified — status vocabulary landed in coord register 2026-07-24 01:25:55 +02:00
2026-07-25-amendment-underlag.md docs(plan): B1/D4 operator question — nav-golden's normative status, four costed options 2026-07-25 20:29:33 +02:00
2026-07-25-b1-nav-golden-normative-status.md docs(plan): B1/D4 operator question — nav-golden's normative status, four costed options 2026-07-25 20:29:33 +02:00
2026-07-25-ordering-axes-ruling.md docs(plan): ordering-axes ruling — three distinct axes, as an interpretation record 2026-07-25 15:28:33 +02:00