ingesting-spec

name	ingesting-spec
description	Guide for ingesting the latest OpenAI TypeSpec specification into the openai-dotnet SDK. Use this when asked to update or ingest OpenAI API specs, copy base TypeSpec files from upstream, fix client TSP compile errors, or run code generation for new API areas.

Spec Ingestion

Overview

This skill describes how to ingest the latest OpenAI TypeSpec specification (from the upstream microsoft/openai-openapi-pr repository) into the openai-dotnet SDK, area by area.

The process involves:

1. Copying updated base specs from upstream
2. Reporting any compile errors in the base TSP
3. Fixing compile errors in the client TSP layer
4. Preserving custom C# code (renames, stubs)
5. Running code generation
6. Verifying the output

Skill Documents

This skill is split across multiple files for easier navigation:

Document	Description
steps.md	Step-by-step process — the full 9-step workflow from copying spec to post-generation verification
file-locations.md	Key file locations — quick reference for all upstream and local paths, area mappings
patterns-and-gotchas.md	Common patterns & gotchas — lessons learned, pitfalls, and conventions to follow
checklist.md	Checklist — a task-by-task checklist for tracking progress during an ingestion
references.md