METHODIK.md distils the methodological core of MACHBARKEITS-
STUDIE.md §3 + §6 into a Beirats-ready, PDF-able document that
stands on its own without Ch∆In implementation context.
Structure follows the eight non-negotiable methodological
decisions in the Studie:
1. Pflicht, nicht Gesetz, ist die Bewertungseinheit
2. 6-Schichten-Architektur (S1 Korpus, S2 Norm-Graph,
S3 Pflicht-Extraktion, S4 Bewertung, S5 Roll-up &
Attribution, S6 Heatmap-Output)
3. typisierter Norm-Graph mit Coupette-2021-Kanten-Schema
4. hybride Pflicht-Extraktion (regex + LLM, Cohen's κ ≥ 0,7)
5. Shapley-artige Attribution entlang Ketten
6. 4-Tier-Evidenz-Modell mit Regel-der-niedrigsten-Stufe
7. LLMs sind Mörtel, nicht Datenstein (RAG + Zitat-Pflicht)
8. Engpass-Variable h motiviert Verbands-Vorlauf
Includes Vorbilder-Tabelle (Coupette, QuantGov, NKR, REFIT,
RPC, ATR, Akoma Ntoso, LegalRuleML, ELI, Hohfeldian) und die
methodische Selbstbeschränkungs-Liste.
Versionierung: jede Methodik-Version markiert Altbewertungen
re-bewerten — historischer Wert bleibt, fließt aber nicht in
den aktuellen Heatmap-Stand ein, bis re-bewertet.
Lizenz: Apache-2.0 (gleiche wie Repo).
Signed-off-by: flemming-it <sf@flemming.it>
NOTICE lists the three SIL-OFL fonts the Flutter client bundles
(Space Grotesk, Inter, JetBrains Mono — fetched by app/setup.sh
from the upstream google/fonts repo) and the methodological
attributions that anchor the Studie: SKM (Normenkontrollrat),
the Coupette-2021 graph schema, QuantGov / RegData, Akoma Ntoso,
LegalRuleML, EU Better Regulation Toolbox, OECD iREG, UK RPC.
The Phase-0 demonstration corpus (five pilot norms in
lib/data/fixtures.dart) is also called out as plausibility-
graded approximation that is not NKR- or Beirats-validated —
the in-app banner shows T4 on every figure.
Signed-off-by: flemming-it <sf@flemming.it>
First end-to-end-buildable cut of the pflicht-/graph-basierte
Wirkungsanalyse von Rechtsnormen, running on Ch∆In. Demo runs
without external dependencies and without a hub connection so
the methodology + UI stack can be reviewed before any Verbands-
Kooperation or Beirats-Validierung kicks in.
Tree layout
MACHBARKEITSSTUDIE.md v0.3 — pflicht-basierte Methodik,
4-Tier-Evidenz, 8 law*-Module
auf Ch∆In statt der alten F∆I-
Plattform.
RUN.md one-page how-to-run.
flows/durchstich-gewo-14.yaml
vertical Phase-0 flow: pull →
normalize → duties → citations →
cohort → skm → frust → benefit →
attribution → system.approval.
app/ Flutter macOS client, design
language pulled from fai_web
(ink #08090A, paper #F4F3EF,
petrol signal #2E8F9E). Mock
repository ships five fixture
norms with real source URLs and a
permanent T4 demo-banner so no
figure can be mistaken for a
validated one.
Module repos (separate, see chain-modules*/):
text-akoma-normalize, text-deontic-extract, graph-citation-
extract, text-readability-score, stats-cohort-size, graph-
shapley-attribution, econ-skm-score, law-benefit-score.
What runs today
- flutter analyze: 0 issues
- flutter test: 2/2 (landing + nav-to-shell smoke)
- flutter build macos (via app/build-macos.sh) and ad-hoc
codesign, app launches and the Dart VM service comes up
- native cargo test green on every module
- cargo build --release --target wasm32-wasip2 produces a
130 KiB artefact for text-akoma-normalize
What is deliberately mock / stub
- gRPC wire from the client to a chain serve hub (Repository
abstraction is in place; live impl is the next step)
- NKR Bürokratiekosten-Datenbank ingestion (for the canonical
h-Werte that close out the Engpass per Studie §6.7)
- DESTATIS GENESIS-API adapter for stats.cohort_size
License: Apache-2.0. Author/contact in MACHBARKEITSSTUDIE.md.
Signed-off-by: flemming-it <sf@flemming.it>
