Skip to content

docs(investigation): LLM model quality audit for DatasetUpdater (#299) - #466

Merged
jsboige merged 1 commit into
masterfrom
docs/299-llm-quality-investigation
Jun 13, 2026
Merged

docs(investigation): LLM model quality audit for DatasetUpdater (#299)#466
jsboige merged 1 commit into
masterfrom
docs/299-llm-quality-investigation

Conversation

@jsboige

@jsboige jsboige commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

What

DOC-ONLY investigation for #299 — a grounded audit of LLM model quality in the DatasetUpdater translation pipeline. New file: docs/investigations/2026-06-14-llm-model-quality-datasetupdater.md.

Every technical claim cites a file:line and is tagged VÉRIFIÉ (read in code/git) / RAPPORTÉ (issue/PR) / SUPPOSÉ (deduction). No code/CSV/prompt changes.

Key findings (VÉRIFIÉ)

Doc sections

  1. Résumé exécutif · 1. Architecture d'appel · 2. Inventaire modèles par tâche (table 47 lignes sourcée + synthèse par langue + provider) · 3. Prompts — état réel · 4. Défauts fix(i18n): cosmetic translation residual defects - ES accent, EN punctuation, PT register, FA style, ZH ambiguity #411 corrélés au modèle/prompt · 5. Recommandations feat(translations): multi-pass quality improvement for EN/RU/PT (beyond initial translation) #192 · 6. Limites · 7. Références

Top 3 recommendations for #192

  1. Promote RU/PT initial translate from gpt-5.4-mini to gpt-5.5 (tasks images famille 1 #5,Bump acorn from 6.1.1 to 6.4.1 in /DNNPlatform/Portals/0-System/Skins/Bootstrap 4 Instant #6,Bump node-sass from 4.12.0 to 4.13.1 in /DNNPlatform/Portals/0-System/Skins/Bootstrap 4 Instant #9,Bump dot-prop from 4.2.0 to 4.2.1 in /DNNPlatform/Portals/0-System/Skins/Bootstrap 4 Instant #10,Bump System.Net.Http from 4.3.0 to 4.3.4 in /DNNPlatform/DesktopModules/ToSIC_SexyContent #15,Bump System.Net.Http from 4.3.0 to 4.3.4 in /DNNPlatform/DesktopModules/ToSIC_SexyContent/2sxc Dnn #16), as EN already is (feat(dataset-updater): multi-provider API + gpt-5.5 for EN translations #302); the highest-value 2nd pass is PT cell-by-cell via the mature PromptScenariiPtRefineUser pattern.
  2. Cover fix(i18n): cosmetic translation residual defects - ES accent, EN punctuation, PT register, FA style, ZH ambiguity #411 Cat A — either a strict "typo-only" gpt-5.5 task with AutoCompare, or (safer for the 2 known PKs) a deterministic CSV fix; no LLM needed for 2 cells.
  3. Resolve the 2 prompt inconsistencies before any PT relance — decide pt-PT vs pt-BR once (a single register, per fix(i18n): cosmetic translation residual defects - ES accent, EN punctuation, PT register, FA style, ZH ambiguity #411 §3), and align the cosmetic few-shot with function-calling.

Note

Created amid heavy concurrent-worker activity on the shared working tree; the branch was assembled via git plumbing onto c9197f15 so it contains only the doc (verified git diff --stat c9197f15..HEAD = 1 file, 234 insertions). CRLF preserved to match existing investigation docs.

Closes #299 (investigation deliverable; live benchmark already in the #299 comment).

🤖 Generated with Claude Code

Grounded inventory of the 47 DatasetUpdater task-configs: model per
task/language (33 gpt-5.5, 10 gpt-5.4-mini, 4 gpt-5.4), no BaseUrl set
(OpenAI direct), and the prompt set. Correlates #411 cosmetic defects to
producing model/prompt and flags concrete gaps (ES/EN Cat A uncovered,
pt-PT vs pt-BR register conflict, cosmetic JSON-vs-function-calling
mismatch). Actionable recommendations for #192 multi-pass.

DOC-ONLY: no code/CSV/prompt changes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jsboige
jsboige merged commit fd261ec into master Jun 13, 2026
3 checks passed
@jsboige
jsboige deleted the docs/299-llm-quality-investigation branch June 13, 2026 23:32
jsboige added a commit that referenced this pull request Jun 13, 2026
…, #299 follow-up) (#467)

Enforce the standing gpt-5.5-only translation mandate: the eco-tier
gpt-5.4-mini is banned for translations. Flips every gpt-5.4-mini
occurrence (12 translation tasks) to gpt-5.5 in DatasetUpdaterRootConfig.cs.

Follows the #466 DOC-ONLY investigation
(docs/investigations/2026-06-14-llm-model-quality-datasetupdater.md),
which flagged the gpt-5.4-mini residue as drift from the mandate (note:
the working-tree file actually carries 12 such tasks, not the 10 stated
in the doc's pre-edit table — the doc undercounted; all are translations
and all move up).

The 4 gpt-5.4 (non-mini) tasks are intentionally left untouched: they are
FR-native generation/refinement (Virtues taxonomy FR, Fallacies FR
description, Fallacies FR example, multi-lang cleanup review), not
translation. The mandate concerns translation only — flagged as a
separate decision for jsboige.

All 47 tasks remain Enabled=false, so there is no runtime or cost effect
until a deliberate run is enabled.

Validation: dotnet test green (159 pass / 0 fail / 5 skip); EOL attribute
preserved (i/lf w/crlf); git diff is exactly 12 Model= line changes,
file otherwise byte-identical.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
jsboige added a commit that referenced this pull request Jun 14, 2026
…t 155->159 (#469)

The v0.9.0 validation brief (PR #462) was written from a pre-#460 reading
and flagged doc discrepancies that #460 had already resolved, plus it
under-reported the test count.

Corrections (3 files, docs-only):

1. release-v0.9.0-validation-brief.md - reframe §3.1/§3.2 as RESOLVED by
   PR #460 (36124be): MindMap SVGs correctly state FR/EN/RU/PT committed
   (21) + ES/AR/FA/ZH pending (CHANGELOG L16, RELEASE-NOTES L25/L35/L92);
   Generated Assets counts reconciled to 64 (Tarot 24 + Poker 16 + Web 24).
   Simplifies jsboige's residual decision to: regenerate MindMaps 8-lang
   (Track 1a, option A) vs status quo (option B, already applied by #460).
   Also fixes a structural duplication in the prior commit (stale §3.1 RED
   / §3.2 YELLOW sections that should have been removed) and adds §3.4.

2. §3.4 (new) - test-count drift: CHANGELOG L70 + RELEASE-NOTES L46 said
   155 tests, but dashboard reports 159 after #465/#28. Verified by grep
   [Fact]/[Theory]: Issue28TargetDissociationTests.cs = 4 tests; #466/#467
   /#468 are doc-only / Enabled=false config -> 0 runtime tests. 155+4=159.

3. CHANGELOG.md L70 + RELEASE-NOTES-v0.9.0.md L46 - 155 -> 159 tests
   ("+4 from #465/#28 front/back dissociation").

Only §3.3 trivial date placeholders remain (normal, pre-tag). Gate release
unchanged - no tag/launch/merge.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Investigate LLM model quality for DatasetUpdater translations

1 participant