Ib Check Deck

# IB Terminology Reference

## Casual to Professional Replacements

| Casual/Informal | IB Standard |
|-----------------|-------------|
| "a lot of growth" | "significant growth" or "X% growth" |
| "pretty good margins" | "attractive margins" or "margins of X%" |
| "they bought the company" | "the company was acquired" |
| "big deal" | "transformative transaction" |
| "cheap valuation" | "attractive valuation" or "valuation discount" |
| "expensive" | "premium valuation" |
| "make more money" | "enhance profitability" or "drive margin expansion" |
| "getting bigger" | "pursuing growth" or "expanding operations" |
| "cut costs" | "implement cost optimization" or "drive operational efficiencies" |
| "good fit" | "strategic fit" or "compelling strategic rationale" |
| "help with" | "support" or "facilitate" |
| "a bunch of" | "multiple" or "numerous" |
| "kind of" / "sort of" | [remove or be specific] |
| "really" / "very" | [remove or quantify] |
| "tons of" | "substantial" or quantify |
| "huge" | "significant" or quantify |
| "pretty much" | [remove or be precise] |
| "basically" | [remove or clarify] |

## Language Patterns to Avoid

- **Contractions**: Don't → Do not, won't → will not
- **Exclamation points**: Generally inappropriate for IB materials
- **First-person**: "We think..." → "Management believes..." or passive voice
- **Superlatives without evidence**: "best-in-class" requires supporting data
- **Vague quantifiers**: "some", "many", "several" → specific numbers

## Preferred Phrasing Patterns

**Growth narratives**:
- "Demonstrated track record of X% revenue CAGR"
- "Consistent margin expansion over [period]"
- "Proven ability to generate organic growth"

**Market position**:
- "#X player in [specific segment]"
- "Leading provider of [specific offering]"
- "Differentiated positioning through [specific attribute]"

**Strategic rationale**:
- "Compelling strategic fit driven by..."
- "Attractive value creation opportunity through..."
- "Synergy potential of $Xm from [specific sources]"


# Deck Check Report Format

## Report Template

```markdown
# Deck Check Report: [Presentation Name]

## Summary
- Total issues: X
- Critical: X (number mismatches, factual errors)
- Important: X (narrative-data alignment, language)
- Minor: X (formatting)

## Critical Issues

### Number Consistency
1. **[Issue name]** (Slides X, Y)
   - Slide X: [value]
   - Slide Y: [value]
   - Action: [recommendation]

### Data-Narrative Alignment
1. **[Issue name]** (Slides X, Y)
   - Claim: "[quoted text]"
   - Data shows: [contradiction]
   - Action: [recommendation]

## Important Issues

### Language Polish
1. **[Issue type]** (Slide X)
   - Current: "[quoted text]"
   - Suggested: "[replacement]"

## Minor Issues

### Formatting
1. **[Issue type]** (Slide X)
   - [Description and fix]

## Final Checklist
- [ ] Numbers reconciled
- [ ] Narrative matches data
- [ ] Language meets IB standards
- [ ] Charts sourced
- [ ] Formatting consistent
```

## Issue Severity Classification

**Critical** (must fix before client delivery):
- Number mismatches across slides
- Calculation errors
- Factual inaccuracies (names, titles, dates)
- Data contradicting narrative

**Important** (should fix):
- Casual/informal language
- Vague claims without specificity
- Terminology inconsistency
- Missing chart sources

**Minor** (polish items):
- Font/color inconsistencies
- Date format variations
- Spacing/alignment issues
- Orphaned text


#!/usr/bin/env python3
"""
Extract numerical values from presentation content for consistency checking.

Usage:
    python extract_numbers.py presentation-content.md
    python extract_numbers.py presentation-content.md --output numbers.json

This script parses markdown-formatted presentation content (from markitdown)
and extracts all numerical values with their context and slide references.
"""

import argparse
import json
import re
import sys
from collections import defaultdict
from dataclasses import dataclass, asdict
from p