Ledger amendment package from the #188 role-model pass #192

New Issue

2026-07-03T16:28:15+02:00

Brummel commented

2026-07-03 16:28:15 +02:00

The deliberate, named ledger amendments the #188 design pass ratified (all content settled there; this is production, not design):

A role-model contract entry in docs/design/INDEX.md: the nine roles cut by artifact + surface + iteration cost (1 system programmer, 2 extension dev, 3 toolchain dev, 4 data curator, 5 methodology designer, 6a strategy designer, 6b campaign designer, 7 player, 8 operator/auditor), the recognizability test (named artifact type, addressed surface, entry path, boundary-enforced invariants), the 6a/6b split on invariant 12's tier boundary with ids as the interface, and the text-first/headless-first invariant (visual surfaces = stateless projections; Blockly litmus test as vocabulary acceptance criterion).
C20: re-read the 'experiment matrix is ordinary Rust control flow, not a config schema' clause under #188 fork 1 — the generator may stay Rust, but experiment INTENT is campaign-document data (P1 constructs), and the forbids-clause 'declarative experiment mini-DSL' must not be misread against closed-vocabulary data artifacts.
C22: reconcile 'never a scene editor' with the stateless-projection formulation (read-only projections rank above write editors; any future editor is a projection of the canonical text form). Also the glossary playground entry still says egui-native — align with the settled web-from-disk face.
CLAUDE.md domain invariant 10: clarify that a closed-vocabulary data artifact (op-script, process/campaign document) is NOT the forbidden DSL — what failed (RustAst) was an open logic-bearing language; logic escalation stays role-2 Rust.

depends on: nothing (cycle 0106 shipped the artifact layer the entries describe)
context: #188 'What the design pass must still produce' — the amendment package is the durable-record half; role homes in the project layout and docs-by-role restructuring stay separate later work.

The deliberate, named ledger amendments the #188 design pass ratified (all content settled there; this is production, not design): 1. A role-model contract entry in docs/design/INDEX.md: the nine roles cut by artifact + surface + iteration cost (1 system programmer, 2 extension dev, 3 toolchain dev, 4 data curator, 5 methodology designer, 6a strategy designer, 6b campaign designer, 7 player, 8 operator/auditor), the recognizability test (named artifact type, addressed surface, entry path, boundary-enforced invariants), the 6a/6b split on invariant 12's tier boundary with ids as the interface, and the text-first/headless-first invariant (visual surfaces = stateless projections; Blockly litmus test as vocabulary acceptance criterion). 2. C20: re-read the 'experiment matrix is ordinary Rust control flow, not a config schema' clause under #188 fork 1 — the generator may stay Rust, but experiment INTENT is campaign-document data (P1 constructs), and the forbids-clause 'declarative experiment mini-DSL' must not be misread against closed-vocabulary data artifacts. 3. C22: reconcile 'never a scene editor' with the stateless-projection formulation (read-only projections rank above write editors; any future editor is a projection of the canonical text form). Also the glossary playground entry still says egui-native — align with the settled web-from-disk face. 4. CLAUDE.md domain invariant 10: clarify that a closed-vocabulary data artifact (op-script, process/campaign document) is NOT the forbidden DSL — what failed (RustAst) was an open logic-bearing language; logic escalation stays role-2 Rust. - depends on: nothing (cycle 0106 shipped the artifact layer the entries describe) - context: #188 'What the design pass must still produce' — the amendment package is the durable-record half; role homes in the project layout and docs-by-role restructuring stay separate later work.

Brummel added this to the Research artifacts — process & campaign documents milestone 2026-07-03 16:28:15 +02:00

Brummel added the feature label 2026-07-03 16:28:15 +02:00

Brummel referenced this issue from a commit

2026-07-04 10:53:53 +02:00

docs(ledger): #188 amendment package — C25 role model, C20/C22 refinements, invariant-10 clarification

Brummel closed this issue

2026-07-04 10:53:53 +02:00

claude referenced this issue

2026-07-21 10:36:43 +02:00

Role-model design pass: nine user roles, two missing artifact types (process, campaign), text-first invariant #188

Sign in to join this conversation.