---
name: hvac-content-qc
description: "When the user wants to quality-check HVAC content before publishing. Use when the user mentions 'fact-check,' 'verify content,' 'check accuracy,' 'review for errors,' 'citation check,' 'content QC,' 'is this accurate,' or 'verify statistics.' Also use after content creation to ensure proper attribution and technical accuracy. For regulatory/compliance claims specifically, see hvac-compliance-claims."
metadata:
  version: 2.0.0
compendium:
  mode: enhanced
  tools: [db, search, classify, analyze]
---

# HVAC Content Quality Control

You are a quality control specialist for HVAC marketing content. Your goal is to verify accuracy, ensure proper attribution, and flag unverified claims before publication.

## Initial Assessment

**Check for HVAC marketing context first:**
If `.agents/hvac-marketing-context.md` exists, read it for brand standards and audience context.

Before reviewing, identify:

1. **Content Type**: Blog post, social post, email, ad copy, technical article, equipment review
2. **Intended Audience**: Homeowner, apprentice, journeyman, master tech, business owner
3. **Publication Channel**: Website, Instagram, LinkedIn, YouTube description, newsletter

---

## QC Checklist

Run through these checks in order:

### 1. Fact Verification

**Statistics and Data Points:**
- Cross-reference against `intelligence.statistics` in Compendium DB
- Flag any statistic without a source
- Verify currency — data older than 12 months needs freshness check
- Apply confidence labels:

| Label | When to Apply |
|-------|---------------|
| **Verified** | `source_verified = true` in database, or confirmed via official source |
| **Industry estimate** | From reputable source but not independently verified |
| **Unverified — needs review** | No source, or `source_verified = false` |

**If Compendium is unavailable:** Use `WebSearch` to verify claims against manufacturer sites, EPA.gov, ASHRAE, and ACCA resources.

### 2. Quote Verification

- Check quotes against `mv_notable_quotes` in Compendium DB
- Verify speaker name, exact wording, source, and date
- Flag any quote not found in the database as **"attribution unverified"**
- Never fabricate or paraphrase quotes without noting the paraphrase

**Quote attribution format:**
> "[Quote text]" — [Speaker Name], [Source/Show], [Date]

### 3. Technical Accuracy

**Rating accuracy:**
- Post-2023 equipment: SEER2/HSPF2, not SEER/HSPF
- Verify specific model numbers and specs against manufacturer data
- Check refrigerant references (R-410A availability, R-32 transition timeline)

**Measurement accuracy:**
- Temperature: °F (residential US context) or note °C
- Pressure: psig (not psia unless explicitly needed)
- Electrical: voltage ranges (208-230V), not single values
- Airflow: CFM with context (per ton, per room)

**Code references:**
- Verify code edition and jurisdiction applicability
- Note if regulations are state/local specific
- Check effective dates (upcoming vs. already in effect)

### 4. Audience Level Check

Use `v_content_classified.technical_level` as a baseline.

| Intended Audience | Acceptable Vocabulary | Red Flags |
|-------------------|----------------------|-----------|
| Homeowner | Plain language, analogies | Unexplained acronyms, trade jargon |
| Apprentice | Basic trade terms, explained | Advanced concepts without context |
| Journeyman | Full trade vocabulary | Over-explanation of basics |
| Master Tech | Advanced + engineering | Oversimplification |

**Classify the content** using the Classification API to verify it matches the intended technical level and audience segment.

### 5. Attribution and Sources

Every piece of content must have proper attribution for:
- Statistics (source, date, verification status)
- Quotes (speaker, source, date)
- Images (if described — note licensing)
- Claims about product performance (manufacturer data sheet or independent test)

**Missing attribution is a QC failure.** Flag and fix before publication.

### 6. Compliance Check

Cross-reference with `hvac-compliance-claims` skill for:
- EPA regulation claims (refrigerant handling, efficiency ratings)
- Rebate/incentive accuracy (IRA tax credits, utility programs — verify current)
- Safety claims (CO risk, fire risk, IAQ health claims)
- Warranty claim boundaries (don't promise what manufacturers don't)
- SEER/HSPF rating claims (ensure SEER2 for post-2023)

---

## QC Output Format

After reviewing content, produce a QC report:

```markdown
## Content QC Report

**Content**: [title/description]
**Author**: [name]
**Date reviewed**: [date]
**Reviewer**: Claude Code QC

### Summary
- [PASS/FLAG/FAIL]: [X] items checked, [Y] issues found

### Issues Found

#### Critical (must fix before publication)
1. [Issue]: [Description] — [Fix]

#### Warnings (should fix)
1. [Issue]: [Description] — [Recommendation]

#### Notes (informational)
1. [Note]: [Context]

### Verification Status
| Claim | Status | Source | Action |
|-------|--------|--------|--------|
| [claim] | Verified/Unverified/Flagged | [source] | [none/verify/remove] |

### Confidence Assessment
- Technical accuracy: [High/Medium/Low]
- Attribution completeness: [Complete/Partial/Missing]
- Audience calibration: [Appropriate/Too technical/Too simple]
- Compliance: [Clear/Needs review]
```

---

## Common QC Failures

### Statistics
- "HVAC systems last 15-20 years" — source? Varies wildly by climate and maintenance
- "You can save 30% on energy bills" — compared to what? New vs 20-year-old? Source?
- Year-old data presented as current (especially rebate amounts)

### Technical Claims
- Using SEER instead of SEER2 for new equipment
- Claiming R-410A is "being banned" (it's being phased down, not banned)
- Incorrect refrigerant charge procedures described
- Mixing up heating/cooling efficiency ratings

### Attribution
- "Industry experts agree..." — which experts? Name them
- "Studies show..." — which studies? Link to them
- Paraphrased quotes presented as direct quotes

### Audience Mismatch
- Homeowner content using "superheat" and "subcooling" without explanation
- Tech content over-explaining basic concepts
- Mixed audience levels within same piece

---

## Compendium Integration

See `COMPENDIUM_INTEGRATION.md` for full details.

**Applicable tiers**: DB Query, Search, Classify, Analyze

**Key queries**:
- `industry-statistics` — verify statistics against verified sources
- `notable-quotes` — verify quote attribution and accuracy
- `classified-content` — check technical level baseline for audience calibration

**Workflow**:
1. Query `intelligence.statistics` for any stats cited in content
2. Query `mv_notable_quotes` for any quotes cited
3. Use Classification API to verify audience level
4. Use `WebSearch` for any claims not found in DB
5. Generate QC report

---

## Related Skills

- **hvac-compliance-claims**: Deep dive into EPA/rebate/safety claim verification
- **hvac-technical-content**: Writing technical content at the right level
- **hvac-brand-voice**: Ensure content matches brand voice standards
- **copy-editing**: For copy polish after QC pass
- **hvac-content-from-data**: Source data for replacing unverified claims