>Agent Skill

@fountain-coach/spec-pdf-to-schema

skilldevelopment

Ensure protocol facts derived from MIDI spec PDFs are reflected in canonical JSON schema/OpenAPI sources.

apm::install

$apm install @fountain-coach/spec-pdf-to-schema

apm::skill.md

apm::badge

[![APM](https://img.shields.io/endpoint?url=https%3A%2F%2Fapm-p1ls2dz87-atlamors-projects.vercel.app%2Fapi%2Fbadge%2F%40fountain-coach%2Fspec-pdf-to-schema&style=flat-square)](https://apm-p1ls2dz87-atlamors-projects.vercel.app/packages/@fountain-coach/spec-pdf-to-schema)

# Spec PDF to Schema Mapping

## Purpose
Ensure protocol facts derived from MIDI spec PDFs are reflected in canonical JSON schema/OpenAPI sources.

## When to Use
- Implementing protocol details sourced from PDF specifications
- Updating schema or OpenAPI definitions

## Steps
1. Render the relevant PDF pages to images for inspection.
2. Validate the bit layout or field definitions against the images.
3. Update `midi2.full.closed.schema.json` and `midi2.full.openapi.json` with the verified facts.
4. Implement code and tests only after schema/OpenAPI updates.
5. Document the source page/section in related notes or audit docs.

## Output Contract
- Canonical JSON schema/OpenAPI reflect the PDF-derived facts.
- Code/tests align with the updated canonical sources.