- All playbooks
- Validate shared declarations once without losing file boundaries
Validate shared declarations once without losing file boundaries
Validate shared declarations in one pass, and keep each file's own syntax check.
Company examples
How OpenAI used this technique
Read what OpenAI changed and follow the original sources.
Validate shared declarations once without losing file boundaries
The Ruby SDK parses each of its 1,209 RBS files on its own, then runs one consolidated Steep pass for semantics. If any file has NUL bytes or file-scoped directives, the whole job takes the per-file path, and any error in the fast path reruns the original files for exact diagnostics.
Complete local validator: per-file Steep run 52.38s to 6.22s consolidated Source
- Use it when
- A declaration validator analyzes the same reopened namespaces again for every file.
- Before applying it
- Concatenation can make invalid files look valid together or leak file-scoped directives. Keep the per-file fallback with exact diagnostics.
Company Playbooks
- Read Anthropic’s playbookRun only affected tests
- Read DoorDash’s playbookRun build and test in parallel, sharded across CI agents
- Read Linear’s playbookBenchmark the same job on faster hardware
- Read Mastra’s playbookStarSling runners for the slowest test workflow
- Read OpenAI’s playbookRank CI fixes by the minutes they save
- Read Ramp’s playbookMove a CPU-bound test suite to a faster CPU
- Read Shopify’s playbookLet an agent iterate against one CI metric
- Read Spotify’s playbookBuild arm64 on native arm64 runners
- Read Stripe’s playbookRun only the tests a change can reach
- Read Uber’s playbookBuild the merge-queue speculations most likely to be needed