docs(analytics): restore explicit Analytical Judge gate after findings (#357) - #359
Merged
Merged
Conversation
#357) Adds a compact post-findings orchestration checkpoint — findings -> Analytical Judge -> pass / revise / blocked -> final findings -> memo — that challenges the analytical conclusion before narrative packaging. It reuses the existing controls and introduces no second QA framework, taxonomy, method, or intent. - ANALYTICAL_REASONING_STANDARD.md: new §8 "Analytical Judge gate" (seven semantic checks mapped to TASK_PROFILE / METHOD_PLAN / CLAIM_EVIDENCE_REGISTRY / explanation challenge / FINAL_EVIDENCE_SUFFICIENCY / material synthesis; ANALYTICAL_JUDGE output record; bounded revise/rerun; quick-mode collapse). §8->§9 (Runtime collapse), §9->§10 (Stop/escalation) renumbered; full-path block updated. - ANALYTICS_WORKFLOW.md: canonical workflow + Step 9 make the gate explicit before memo/report. - QA_CHECKLIST.md: post-findings Analytical Judge gate block (orchestration, not a second framework). - ACCEPTANCE_CRITERIA.md: criterion 12, analytical_judge_status field, blocked status entry. - GOVERNANCE_AND_ANTI_PATTERNS.md: gate principle, blocker, and anti-pattern rows (no autonomous retry loop, no second framework, blocked != executed). - SMOKE_QA_FOR_ANALYTICS.md: case forcing an over-strong "root cause" claim to revise; quick-mode collapse case. - CHANGELOG.md entry; regenerated ANALYTICS_01/03/05 bundles + provenance. Enforced invariants unchanged: claim strength <= final evidence sufficiency; driver != root cause; correlation != causation; blocked != executed; manual_review_required governed by the reasoning standard; AES canonical. Checks: 6 canonical + provenance + pytest (231) pass. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #357.
Summary
Restores an explicit
Analytical Judgegate directly afterfindingsin the[Analytics]reasoning/workflow docs — a compact orchestration checkpoint that challenges the analytical conclusion itself before narrative packaging. Docs-only. It reuses the existing controls and adds no second QA framework, taxonomy, method, or intent.Changes
ANALYTICAL_REASONING_STANDARD.mdTASK_PROFILE/intent,METHOD_PLAN+registry,CLAIM_EVIDENCE_REGISTRYlineage, explanation challenge,CONTRADICTING_EVIDENCE+method-disagreement,FINAL_EVIDENCE_SUFFICIENCY+claim ladder, material management synthesis);ANALYTICAL_JUDGEoutput record; bounded revise/rerun rule;quickruntime collapse. §8→§9 (Runtime collapse), §9→§10 (Stop/escalation) renumbered; full-path block updatedANALYTICS_WORKFLOW.mdfindings → Analytical Judge → pass/revise/blocked → final findingsexplicit before memo/reportQA_CHECKLIST.mdACCEPTANCE_CRITERIA.mdanalytical_judge_status: pass/revise/blocked/not_applicable; blocked-status entryGOVERNANCE_AND_ANTI_PATTERNS.mdblocked != executedSMOKE_QA_FOR_ANALYTICS.mdrevise(the issue's suggested test);quick-mode collapse caseCHANGELOG.mdANALYTICS_01/03/05bundles + provenance auditAcceptance criteria (issue #357)
findings → Analytical Judge → pass/revise/blocked → final findingsclaim strength <= final evidence sufficiencyremains mandatorydriver != root cause/correlation != causationremain enforcedblocked != executedremains enforcedmanual_review_requiredstill governed by the reasoning standard (§1); Judge only surfaces itquickmode stays compact — no full Judge record without a material triggerrevisecaseNon-goals respected: does not replace Memo Judge or deterministic QA; the 22-method registry, analytical intents, and AES execution governance are untouched; no autonomous agent / self-improvement loop.
Checks
6 canonical scripts +
audit_bundle_provenance.py --check+pytest tests/ -q(231 passed).Rollback
git revertthis commit — docs-only; bundles + provenance regenerate from the reverted sources.🤖 Generated with Claude Code