# Expanded Explore Report

**Project:** D&D SRD Coverage Dashboard  
**Stage:** Explore  
**Status:** Approved  
**Exploration date:** September 20, 2026

## Purpose of this stage

This stage establishes what data is available, how the sources relate, and which quality problems must be resolved before the dashboard makes coverage claims. It does not treat absence from the SRD as a legal conclusion. The dashboard's practical rule is:

- **Name matched in SRD 5.2.1:** a corresponding named option was verified in the licensed SRD. Reuse must be based on the SRD's own content and comply with its attribution requirements.
- **No SRD 5.2.1 name match:** no corresponding option was verified under this method. Investigate another basis or exclude non-SRD content from an SRD-only product.

## Source inventory

| Source | Role | Authority for this project | Main limitation |
|---|---|---|---|
| `SRD_CC_v5.2.1.pdf` | Defines the comparison baseline | Primary source for SRD presence | Untagged PDF; its text layer contains encoding, column-order, and heading-merging errors |
| D&D Beyond SRD page | Confirms the current SRD version and licensing context | Official supporting source | It is guidance rather than the complete structured dataset |
| D&D Beyond Creator FAQ | Explains creator pathways and cautions | Official contextual source | It does not classify every game term |
| D&D Beyond 5.5e/2024 Player's Handbook articles and indexes | Defines the current Player's Handbook comparison universe | Official source for counts and named options that are publicly listed | Default indexes mix editions, settings, partner content, and other books; some lists are dynamic and paginated |
| `5E_CharacterSheet_Fillable.pdf` | Earlier reference supplied with the project | Excluded from the comparison dataset | It is a 2014 character sheet, uses older terminology, and does not define reusable content |

## What the sources establish

The current Player's Handbook comparison universe has:

| Category | Current Player's Handbook | SRD 5.2.1, verified so far | Exploration result |
|---|---:|---:|---|
| Classes | 12 | 12 | Stable, direct comparison is feasible |
| Subclasses | 48 (4 per class) | 12 (1 per class) | Stable parent-child comparison is feasible |
| Species | 10 | 9 | Stable, direct comparison is feasible |
| Backgrounds | 16 | 4 | Stable, direct comparison is feasible |
| Feats | 75 | 16 | SRD list visually/textually verified; full PHB list still needs controlled extraction |
| Spells | 391 | Pending validated extraction | Public index is dynamic and paginated; automated PDF heading extraction is not yet trustworthy |
| Equipment | No single official total found | Pending category definition and validated extraction | “Equipment” contains several different kinds of records |

### Verified SRD inventory for smaller categories

- **Classes:** Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin, Ranger, Rogue, Sorcerer, Warlock, Wizard.
- **Subclasses:** Path of the Berserker, College of Lore, Life Domain, Circle of the Land, Champion, Warrior of the Open Hand, Oath of Devotion, Hunter, Thief, Draconic Sorcery, Fiend Patron, Evoker.
- **Backgrounds:** Acolyte, Criminal, Sage, Soldier.
- **Species:** Dragonborn, Dwarf, Elf, Gnome, Goliath, Halfling, Human, Orc, Tiefling.
- **Feats:** Alert, Magic Initiate, Savage Attacker, Skilled, Ability Score Improvement, Grappler, Archery, Defense, Great Weapon Fighting, Two-Weapon Fighting, Boon of Combat Prowess, Boon of Dimensional Travel, Boon of Fate, Boon of Irresistible Offense, Boon of the Night Spirit, Boon of Spell Recall, and Boon of Truesight.

The official Player's Handbook article identifies all 16 current backgrounds: Acolyte, Artisan, Charlatan, Criminal, Entertainer, Farmer, Guard, Guide, Hermit, Merchant, Noble, Sage, Sailor, Scribe, Soldier, and Wayfarer.

## How the data relates

The central unit is a named game option. Each option belongs to one category and can appear in one or both source universes.

```mermaid
erDiagram
    CATEGORY ||--o{ ITEM : contains
    CLASS ||--o{ SUBCLASS : has
    ITEM ||--o{ SOURCE_ASSERTION : supported_by
    SOURCE ||--o{ SOURCE_ASSERTION : provides
    CLASS ||--o{ CLASS_SPECIES_COMBINATION : participates_in
    SPECIES ||--o{ CLASS_SPECIES_COMBINATION : participates_in
```

The class-species matrix is derived. A combination is marked as having both component names matched only when both its class and species are present in the SRD. It is not a separate rule or license grant.

## Proposed normalized record

Each dashboard item should contain:

| Field | Purpose |
|---|---|
| `id` | Stable internal identifier |
| `category` | Class, subclass, species, background, feat, spell, or equipment |
| `name` | Display name from the source |
| `normalized_name` | Comparison key after conservative normalization |
| `parent_id` | Links a subclass to its class when applicable |
| `in_current_phb` | Whether the option belongs to the selected Player's Handbook universe |
| `in_srd_5_2_1` | Whether the option appears in SRD 5.2.1 |
| `status` | `matched_in_srd`, `no_srd_name_match`, `ambiguous`, or `unresolved` |
| `source_url_or_file` | Provenance |
| `source_page` | SRD page when available |
| `retrieved_or_verified_at` | Version-control date for changing web sources |
| `verification_state` | Automated, visually checked, or manually resolved |
| `notes` | Rename, ambiguity, or matching caveat |

Anonymous search analytics should use a separate event record containing only a normalized query, selected category, returned status, zero-result flag, and coarse time bucket. It should not store an account, IP address, user agent, source code, database content, or a persistent identifier.

## Data-quality findings

1. **Default D&D Beyond indexes are not a clean Player's Handbook dataset.** They include legacy, setting-specific, partner, and other-book content. Every imported record needs an explicit source-edition assertion.
2. **Web lists can change.** Store the retrieval date and source URL, and regenerate deliberately rather than silently updating production data.
3. **The SRD PDF is readable but not machine-clean.** A trial heading extractor merged `Boon of Truesight` with `Boon of Fate` and misread spell metadata as names. Those automated spell results were rejected.
4. **Name matching alone can produce false differences.** Unicode apostrophes, punctuation, spacing, renamed options, and legacy/current duplicates require conservative normalization and a manual exceptions table.
5. **Absence has a narrow meaning.** “Not found” means the option was not matched in SRD 5.2.1 under the documented method. It does not by itself prove infringement or prohibit every use.
6. **Descriptions should not be copied for non-SRD Player's Handbook options.** The comparison needs names and classifications, minimizing use of protected book text.
7. **Equipment needs a defined unit.** Weapons, armor, tools, adventuring gear, ammunition, mounts, vehicles, services, lifestyle costs, and magic items are not interchangeable record types.
8. **Counts are useful controls.** The final import should reconcile with 12 classes, 48 subclasses, 10 species, 16 backgrounds, 75 feats, and 391 spells for the selected Player's Handbook edition before analysis begins.

## Why the SRD version must be explicit

The official SRD FAQ confirms that SRD 5.1 and SRD 5.2 are different rules universes, rather than interchangeable editions of the same list. SRD 5.2 uses the updated 5.5e wording and mechanics. Compared with 5.1, it adds three backgrounds and two species, removes Half-Elf and Half-Orc because they are not in the 5.5e core rules, adds 15 feats and 20 spells, and adds equipment content including weapon masteries, the Musket, the Pistol, potion brewing, and spell-scroll scribing.

This affects the dashboard in four concrete ways:

- Every assertion must carry `rules_edition` and `srd_version`; a bare label such as “free” is too ambiguous.
- The first dashboard release should compare the current 5.5e Player's Handbook only with SRD 5.2.1. SRD 5.1 remains outside this proof of concept.
- A future compatibility view may show SRD 5.1 and 5.2.1 side by side, because the official FAQ says creators may use either or both with the proper attribution.
- The exceptions table must support renamed equivalents. The FAQ says some SRD names intentionally differ from the core books while retaining the same function. Exact name matching would incorrectly mark those as absent.

The FAQ supports factual coverage labels: Wizards says some content is excluded for brand identity, licensing strategy, and intellectual-property reasons, while creators are encouraged to design and name original equivalents. An absent item should therefore be labeled `no_srd_name_match`, with an optional “create an original alternative” suggestion, rather than receive a legal label.

## Recommended extraction and verification workflow

1. Create a current-Player's-Handbook manifest containing names, categories, parent relationships, source URL, and retrieval date.
2. Extract SRD candidates by category and page range.
3. Normalize only Unicode, whitespace, case, and clearly equivalent punctuation.
4. Exact-match the normalized names.
5. Send all unmatched, duplicate, and renamed candidates to a manual exceptions table.
6. Visually verify every small-category record and a controlled sample plus all exceptions for spells and equipment.
7. Reconcile category counts and preserve a machine-readable validation report.
8. Generate dashboard data from the verified manifest, never directly from a live web page.

## Approved equipment scope for the proof of concept

Use **named nonmagical equipment records** from the current Player's Handbook: weapons, armor, tools, adventuring gear, ammunition, mounts, and vehicles. Exclude currencies, lifestyle expenses, lodging, food, hireling/service price rows, and magic items. This creates a consistent “thing a VTT might store as an item” unit and keeps magic items outside the approved character-creation scope.

**Decision:** Approved by the project owner on September 20, 2026.

## Explore stage gate

The source relationships, category boundaries, and major risks are understood. The equipment scope is approved. The expanded Explore stage is complete, and the project can proceed to constructing the current-Player's-Handbook manifest and SRD inventory with validation reports.

## Evidence used

- Wizards of the Coast, *System Reference Document 5.2.1*, especially pages 28–175.
- D&D Beyond, [What's New in the 2024 Player's Handbook?](https://www.dndbeyond.com/posts/1810-updates-in-the-players-handbook-2024).
- D&D Beyond, [The Backgrounds and Origin Feats in the 2024 Player's Handbook](https://www.dndbeyond.com/posts/1785-the-backgrounds-and-origin-feats-in-the-2024).
- D&D Beyond, [System Reference Document](https://www.dndbeyond.com/srd).
- D&D Beyond, [Creator FAQ](https://www.dndbeyond.com/creator-faq).
