CR-README-03 Pass 1: hierarchy only — trim, demote, filter, de-correlate

[quantamixsol]

Pass 1 of 2 — hierarchy only, no new claims

Public port of private PR #347 (merged 2026-09-19, merge commit 2959ce98). Both files are byte-identical to the merged private/master.

Implements the Research Team README Update Brief (2026-09-19) under the strategy-review §20 constraint: reorder truthful content, add no new claims.

---

⚠️ Scoped deliberately to two files

private/master currently diverges from public by 196 files, including the entire DAG-2026 stack (PR-012b gate vocabulary + trace schema v3, PR-012c hygiene, PR-012d activation fail-visible) and several workflow files. None of that is ready for public release and none of it rides along here.

$ git diff --name-only
README.md
README_PYPI.md

That is the whole change.

---

What changed

§2.3 Correlated judges — an accuracy fix, not cosmetics

"How it works" step 4 said "Multiple agents debate" with no qualification. Agents sharing a model family, a prompt template or a source document are correlated, so their agreement is not independent confirmation. Now stated inline:

Debate is a reasoning mechanism, not a proof of truth: agents sharing a model family, a prompt template or a source document are correlated, so their agreement is not independent confirmation.

README twin of the CR-014 correlation-discount amendment.

§2.4 Regulated deployments: 33 → 15 lines

Every ADR-MARKETING-001 locked marker survives — the aligned badge, the literal Articles 6, 9, 12, 13, 14, 15, 25, 50 scope string, both NOT-claims. Every link kept. The graq compliance CLI block moves to docs/compliance/eu-ai-act/, where the complete nine-article set already lives. No engineering deleted.

§2.5 Token economics → "What you actually get back"

Durable ROI leads: less context reconstruction, fewer architectural mistakes, faster change validation, retained team knowledge, easier model switching, safer autonomy. Token cost follows as supporting evidence. The −88% year-two figure is dropped; the case-study link carries the full math.

§2.6 Recent releases filtered

Four user-facing entries, 0.84.0 leading. The EU AI Act layer entry moves to CHANGELOG.md.

§3.1 PyPI: compatibility above the fold

"Will it work with my stack" is now answerable on the first screen; the downstream section is de-duplicated to the config example + graq init.

---

Held for Pass 2

The model-dependent vs model-independent paragraph, the trusted-state chain, and the PyPI enterprise-trust paragraph — all add claims, which §20 forbids mixing with a hierarchy change.

§2.7 (Evidence & benchmarks, Research roadmap) is blocked entirely: all seven roadmap docs are absent, and the brief forbids linking before the file exists.

---

Verification on this public tree

Check	Result
Both files vs merged private/master	hash-identical
README lock gate + eu_ai_act_docs_present	62 passed
Every graq command vs graq --help	0 invalid
Forbidden-word scan	0 violations
Stale counts (76+/74/14/Azure OpenAI)	0
git diff --name-only	exactly 2 README files

---

No version bump

pyproject.toml, __version__.py and CHANGELOG.md are untouched. PyPI still serves 0.84.0, and that page is frozen at its version's metadata — this copy reaches PyPI at the next release, not on merge.

🤖 Generated with Claude Code

[github-actions]

🛡️ GraQle PR Guardian

💥 Blast Radius: 2 modules affected

Module	Files Changed	Risk Level	Impact Radius
README.md	1	🟡 T2	1
README_PYPI.md	1	🟡 T2	1

Total blast radius: 2

---

🏛️ Governance Verdict

⚠️ WARN

• T2: Advisory warnings detected. Review recommended.

---

🔍 SHACL Violations

No SHACL violations detected. ✅

---

🔐 Approval Requirements

This PR requires approval from: T2

• A Senior Engineer or above must approve.

❌ Approval requirement NOT yet satisfied.

---

Metric	Value
Blast Radius	2
Files Analyzed	2
Blocked	0
SHACL Violations	0
Verdict	WARN

---

_{🔬 Powered by GraQle PR Guardian v0.1.0 · Scan completed 2026-09-19T10:16:06.421653+00:00}