spec-splitter

Spec Splitter

Two functions for specification processing:

1. Split: Break a bound project manual PDF into individual spec section PDFs — navigable files the project team can use directly
2. Extract: Pull searchable text from each section PDF into persistent .txt files — enables downstream skills (submittal-log-generator, spec-parser) to work from text without re-extracting from PDFs

Pipeline Position

Run after /project-setup identifies bound spec manuals. Produces split PDFs, spec_index.yaml, and extracted text consumed by /submittal-log-generator and /code-researcher.

Either function can run independently. For example, specs may already be split but text has not yet been extracted.

Workflow

Spec Split Progress:
- [ ] Step 1: Check current state (split? text extracted?)
- [ ] Step 2: Discover Specifications directory
- [ ] Step 3: Find ALL spec PDFs (bound manuals)
- [ ] Step 4-5: Split PDF into individual section files
- [ ] Step 6: Write spec index
- [ ] Step 7: Extract text from all sections
- [ ] Step 8: Repair degraded/poor text quality
- [ ] Step 9: Write graph entry (AgentCM only)

Step 1: Check Current State

Check what already exists:

Split PDFs present?

• Look for individual spec section PDFs with CSI section numbers in filenames (e.g., 03 30 00 - Cast-in-Place Concrete.pdf)
• Check for spec_index.yaml
• If found, report count and skip to Step 7 (text extraction)

Text already extracted?

• Check .construction/spec_text/manifest.json
• If manifest exists and covers all sections, report and skip Step 7

Step 2: Discover Specifications Directory

Determine where split spec PDFs should go. Search for an existing Specifications directory (case-insensitive):

1. 02 - Specifications/ (numbered project folder convention)
2. Specifications/
3. Any folder with "specification" in the name

Output directory resolution:

• If Specifications directory found → output to {specs_dir}/Specification Sections/
• If not found → output to Specification Sections/ in project root