F5

---
name: f5
description: |
  Humanization Quality Verifier - Ensures transformation integrity and quality
  Validates that humanization preserves meaning, citations, and academic standards
  Use when: after G6 transformation, before final export, for quality assurance
  Triggers: verify humanization, check transformation, validate changes
version: "12.0.1"
---

# Humanization Verifier

**Agent ID**: F5
**Category**: F - Quality
**VS Level**: Low (Verification-focused)
**Tier**: Support
**Icon**: ✅
**Model Tier**: LOW (Haiku)

## Overview

Verifies that humanization transformations maintain academic integrity, preserve critical elements, and improve overall writing quality. This is the final quality gate before improved content is exported.

## Core Functions

### 1. Citation Integrity Check

Verifies all citations remain intact and accurate:

```yaml
checks:
  - count_match: "Same number of citations before/after"
  - format_preserved: "(Author, year) format maintained"
  - content_accurate: "No citation content changed"
  - placement_logical: "Citations still support correct claims"

output:
  citations_before: 15
  citations_after: 15
  all_intact: true
  issues: []
```

### 2. Statistical Accuracy Check

Ensures all numerical values are unchanged:

```yaml
checks:
  - p_values: "All p-values identical"
  - effect_sizes: "All d, r, η² unchanged"
  - sample_sizes: "All N, n unchanged"
  - test_statistics: "All t, F, χ² unchanged"
  - percentages: "All % unchanged"
  - confidence_intervals: "All CI unchanged"

output:
  statistics_before: 23
  statistics_after: 23
  all_intact: true
  issues: []
```

### 3. Meaning Preservation Check

Validates core claims are unchanged:

```yaml
checks:
  - main_findings: "Key findings preserved"
  - conclusions: "Conclusions unchanged"
  - methodology_claims: "Method descriptions accurate"
  - causal_claims: "No new causal language added"
  - hedge_appropriateness: "Hedging matches evidence"

assessment:
  meaning_preserved: true
  confidence: 95%
  flagged_changes: []
```

### 4. Writing Quality Improvement Check

Re-runs G5 analysis on transformed text:

```yaml
comparison:
  original:
    writing_quality: 33%
    patterns_detected: 18
    high_priority: 5
    medium_priority: 9
    low_priority: 4

  improved:
    writing_quality: 72%
    patterns_detected: 4
    high_priority: 0
    medium_priority: 2
    low_priority: 2

  improvement:
    quality_gain: 39%
    pattern_reduction: 78%
    effective: true
```

### 5. Academic Tone Check

Ensures scholarly voice is maintained:

```yaml
checks:
  - formality: "Appropriate formality level"
  - objectivity: "Objective tone preserved"
  - precision: "Technical precision maintained"
  - consistency: "Consistent voice throughout"

assessment:
  tone_appropriate: true
  issues: []
```

## Input Requirements

```yaml
Required:
  - original_text: "Text before humanization"
  - humanized_text: "Text after G6 transformation"
  - transformation_log: "G6 change record"

Optional:
  - section_type: "abstract/methods/discussion/etc."
  - strictness: "low/medium/high"
```

## Output Format

```markdown
## Humanization Verification Report

### Summary

| Check | Status | Details |
|-------|--------|---------|
| Citation Integrity | Pass | 15/15 citations preserved |
| Statistical Accuracy | Pass | 23/23 values unchanged |
| Meaning Preservation | Pass | Core claims intact |
| Writing Quality Improvement | Pass | 33% → 72% (+39%) |
| Academic Tone | Pass | Scholarly voice maintained |

### Overall Verdict: ✅ APPROVED

---

### Detailed Results

#### Citation Integrity
```
✅ All 15 citations preserved
✅ Format consistent
✅ Placement logical
```

#### Statistical Accuracy
```
✅ All p-values unchanged
✅ All effect sizes unchanged
✅ All sample sizes unchanged
✅ All test statistics unchanged
```

#### Meaning Preservation
```
✅ Main findings preserved
✅ Conclusions unchanged
✅ No meaning distortion detected
Confidence: 95%
```

#### Writing Quality Improvement
```
Before: 33% writing quality (18 patterns)
After:  72% writing quality (4 patterns)
Improvement: +39% quality, 78% pattern reduction
```

#### Academic Tone
```
✅ Formal register maintained
✅ Objective voice preserved
✅ Technical precision intact
```

---

### Flagged Items (Review Recommended)

None

---

### 🟡 CHECKPOINT: CP_HUMANIZATION_VERIFY (Optional)

Verification complete. Ready for export?

[A] Approve and export
[B] Review specific changes
[C] Revert to original
```

## Verification Strictness Levels

### Low Strictness
- Basic citation count match
- Statistical value presence check
- Major meaning changes only

### Medium Strictness (Default)
- Full citation verification
- Statistical value comparison
- Meaning preservation analysis
- AI reduction check

### High Strictness
- Deep citation context analysis
- Statistical formatting verification
- Sentence-level meaning comparison
- Tone consistency analysis
- Academic style guide compliance

## Error Handling

### Critical Failures (Auto-Reject)

```yaml
critical_failures:
  - citation_missing: "Any citation removed"
  - citation_altered: "Citation content changed"
  - statistic_modified: "Any number changed"
  - meaning_reversed: "Claim direction changed"

action: "REJECT transformation, revert to original"
```

### Warnings (Flag for Review)

```yaml
warnings:
  - hedge_changed: "Hedging level modified"
  - emphasis_shifted: "Emphasis moved"
  - structure_altered: "Sentence structure significantly changed"
  - quality_improvement_low: "Less than 20% writing quality improvement"

action: "FLAG for user review"
```

### Acceptable Changes

```yaml
acceptable:
  - vocabulary_substitution: "AI words replaced"
  - phrase_simplification: "Verbose phrases shortened"
  - punctuation_normalization: "Em dashes, quotes normalized"
  - transition_variation: "Transition words varied"
```

## Prompt Template

```
You are an academic writing quality verifier.

Compare the original and humanized texts to verify transformation quality:

[Original Text]: {original}
[Humanized Text]: {humanized}
[Transformation Log]: {log}
[Section Type]: {section_type}

Perform the following verification checks:

1. **Citation Integrity**
   - Count citations in both versions
   - Verify each citation is preserved
   - Check format consistency
   - Confirm logical placement

2. **Statistical Accuracy**
   - Extract all numerical values from original
   - Verify identical values in humanized
   - Flag any discrepancies

3. **Meaning Preservation**
   - Identify main claims in original
   - Verify claims preserved in humanized
   - Check for unintended meaning changes
   - Assess hedge appropriateness

4. **Writing Quality Improvement**
   - Estimate writing quality score (before/after)
   - Count remaining patterns
   - Calculate improvement percentage

5. **Academic Tone**
   - Assess formality level
   - Check objectivity
   - Verify consistency

Output a verification report with:
- Pass/Fail status for each check
- Specific issues found
- Overall recommendation (Approve/Review/Reject)
```

## Integration with Pipeline

```
G6-AcademicStyleHumanizer
        │
        ▼
┌───────────────────────────────────────┐
│  F5-HumanizationVerifier (THIS AGENT) │
│  ┌─────────────────────────────────┐  │
│  │ 1. Citation Integrity    ✅/❌  │  │
│  │ 2. Statistical Accuracy  ✅/❌  │  │
│  │ 3. Meaning Preservation  ✅/❌  │  │
│  │ 4. AI Pattern Reduction  ✅/❌  │  │
│  │ 5. Academic Tone         ✅/❌  │  │
│  └─────────────────────────────────┘  │
│                 │                     │
│                 ▼                     │
│         All Pass? ──Yes──> Export    │
│              │                        │
│             No                        │
│              │                        │
│              ▼                        │
│     🟡 CP_HUMANIZATION_VERIFY        │
│     User review required              │
└───────────────────────────────────────┘
```

## Commands

```
"Verify humanization"
→ Full verification report

"Quick verification check"
→ Summary only

"Check citation integrity"
→ Citation-specific check

"Verify statistics preserved"
→ Statistical-specific check

"Compare meaning before/after"
→ Meaning preservation check
```

## Related Agents

- **G5-AcademicStyleAuditor**: Provides AI pattern analysis
- **G6-AcademicStyleHumanizer**: Creates text this agent verifies
- **G2-PublicationSpecialist**: Related quality checks (absorbed F1)
- **X1-ResearchGuardian**: Related integrity checks (absorbed F4)

## References

- **Humanization Pipeline**: `../../research-coordinator/core/humanization-pipeline.md`
- **G5 Agent**: `../G5-academic-style-auditor/SKILL.md`
- **G6 Agent**: `../G6-academic-style-humanizer/SKILL.md`
- **User Checkpoints**: `../../research-coordinator/interaction/user-checkpoints.md`