POC2: Robust Quality & Reliability
Version 1.2 by Robert Schaub on 2025/12/22 14:38
POC2: Robust Quality & Reliability
Phase Goal: Prove AKEL produces high-quality outputs consistently at scale Success Metric: <5% hallucination rate, all 4 quality gates operational == 1. Overview == POC2 extends POC1 by implementing the full quality assurance framework (all 4 gates), adding evidence deduplication, and processing significantly more test articles to validate system reliability at scale. Key Innovation: Complete quality validation pipeline catches all categories of errors What We're Proving:
- All 4 quality gates work together effectively
- Evidence deduplication prevents artificial inflation
- System maintains quality at larger scale
- Quality metrics dashboard provides actionable insights == 2. New Requirements == === 2.1 NFR11: Complete Quality Assurance Framework === Add Gates 2 & 3 (POC1 had only Gates 1 & 4) ==== Gate 2: Evidence Relevance Validation ==== Purpose: Ensure AI-linked evidence actually relates to the claim Validation Checks:
- Semantic Similarity: Cosine similarity between claim and evidence embeddings ≥ 0.6
2. Entity Overlap: At least 1 shared named entity between claim and evidence
3. Topic Relevance: Evidence discusses the claim's subject matter (score ≥ 0.5) Action if Failed:
- Discard irrelevant evidence (don't count it)
- If <2 relevant evidence items remain → "Insufficient Evidence" verdict
- Log discarded evidence for quality review Target: 0% of evidence cited is off-topic ==== Gate 3: Scenario Coherence Check ==== Purpose: Validate scenarios are logical, complete, and meaningfully different Validation Checks:
- Completeness: All required fields populated (assumptions, scope, evidence context)
2. Internal Consistency: Assumptions don't contradict each other (score <0.3)
3. Distinctiveness: Scenarios are meaningfully different (similarity <0.8)
4. Minimum Detail: At least 1 specific assumption per scenario Action if Failed:
- Merge duplicate scenarios
- Flag contradictory assumptions for review
- Reduce confidence score by 20%
- Do not publish if <2 distinct scenarios Target: 0% duplicate scenarios, all scenarios internally consistent === 2.2 FR54: Evidence Deduplication (NEW) === Priority: HIGH Fulfills: Accurate evidence counting, prevents artificial inflation Purpose: Prevent counting the same evidence multiple times when cited by different sources Problem:
- Wire services (AP, Reuters) redistribute same content
- Different sites cite the same original study
- Aggregators copy primary sources
- AKEL might count this as "5 sources" when it's really 1 Solution: Content Fingerprinting
- Generate SHA-256 hash of normalized text
- Detect near-duplicates (≥85% similarity) using fuzzy matching
- Track which sources cited each unique piece of evidence
- Display provenance chain to user Target: Duplicate detection >95% accurate, evidence counts reflect reality === 2.3 NFR13: Quality Metrics Dashboard (Internal) === Priority: HIGH Fulfills: Real-time quality monitoring during development Dashboard Metrics:
- Claim processing statistics
- Gate performance (pass/fail rates for each gate)
- Evidence quality metrics
- Hallucination rate tracking
- Processing performance Target: Dashboard functional, all metrics tracked, exportable == 3. Success Criteria == ✅ Quality:
- Hallucination rate <5% (target: <3%)
- Average quality rating ≥8.0/10
- 0 critical failures (publishable falsities)
- Gates correctly identify >95% of low-quality outputs ✅ All 4 Gates Operational:
- Gate 1: Claim validation working
- Gate 2: Evidence relevance filtering working
- Gate 3: Scenario coherence checking working
- Gate 4: Verdict confidence assessment working ✅ Evidence Deduplication:
- Duplicate detection >95% accurate
- Evidence counts reflect reality
- Provenance tracked correctly ✅ Metrics Dashboard:
- All metrics implemented and tracking
- Dashboard functional and useful
- Alerts trigger appropriately == 4. Architecture Notes == POC2 Enhanced Architecture: Input → AKEL Processing → All 4 Quality Gates → Display (claims + scenarios (1: Claim validation + evidence linking 2: Evidence relevance + verdicts) 3: Scenario coherence 4: Verdict confidence) Key Additions from POC1:
- Scenario generation component
- Evidence deduplication system
- Gates 2 & 3 implementation
- Quality metrics collection Still Simplified vs. Full System:
- Single AKEL orchestration (not multi-component pipeline)
- No review queue
- No federation architecture See: Architecture for details == Related Pages == * POC1 - Previous phase
- Beta 0 - Next phase
- Roadmap Overview
- Architecture Document Status: ✅ POC2 Specification Complete - Waiting for POC1 Completion Version: V0.9.70