POC2: Robust Quality & Reliability

Version 1.1 by Robert Schaub on 2025/12/23 16:15

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:

  1. 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:

  1. 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)

Importance: 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)

Importance: 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

Document Status: ✅ POC2 Specification Complete - Waiting for POC1 Completion  
Version: V0.9.70