performance

Documents measured optimization techniques, negative results, and benchmark evidence for the Strata JSON engine.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/PrimeLab-Foundation/strata --skill performance-primelab-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance
Source: https://github.com/PrimeLab-Foundation/strata/tree/main/docs/performance
Command: npx skills add https://github.com/PrimeLab-Foundation/strata --skill performance-primelab-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Performance work on a C++/CPython JSON engine often repeats failed experiments or accepts unmeasured changes. This Skill records every optimization that won (with commits and measured effects), every negative result, and ranked salvageable work, so engineers do not retry rejected ideas or accept changes without evidence. ## Core Features & Use Cases - Win catalog: Chronological tables of accepted techniques (hybrid SAX parsing, PGO+ThinLTO, SIMD escape scans, schema caches) with commits and measured effects. - Negative-results ledger: Failed experiments (schema recovery, file-newline writes, nested-mappings dispatch) preserved as patches with the exact gates they failed, preventing rework. - Measurement protocol: Rules of engagement requiring before/after make bench-small runs, ABBA blocks, A/A floors, and canonical regression gates before any optimization is accepted. - Use Case: Before attempting to speed up Strata's serializer, load this Skill to check whether the idea was already tried, what the measured outcome was, and which evidence gates a new candidate must pass. ## Quick Start Load the performance playbook before starting any optimization work on the Strata JSON engine and check the negative-results table for prior attempts.

Frequently Asked Questions about performance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start performance optimization work on the Strata JSON engine?

Load the performance playbook first and check the negative-results table so failed ideas are not retried. Measure before and after with make bench-small at minimum, and trust PGO-build interleaved comparisons over single runs.

What evidence is required to accept a Strata optimization?

Acceptance requires six serial ABBA blocks with 60 samples per row, a matching identical-binary A/A floor, canonical regression checks across small, medium, and large tiers, and full correctness plus ASan/UBSan gates. Gains must clear the measured uncertainty floor.

Which optimization techniques improved Strata serialization speed?

Measured wins include thread-local output buffers, homogeneous array batching, a three-tier dtoa path, SIMD escape scanning, per-depth schema caches, and PGO with ThinLTO. Each entry lists its commit and measured effect on specific datasets.

Why was the schema recovery or file-newline prototype rejected?

Both prototypes passed correctness and sanitizer tests but failed canonical regression gates, and six-block ABBA controls found no resolved gain above the noise floor. They are preserved as patch experiments and must not be revived as accepted optimizations.

Does a passing CI benchmark run mean an optimization is accepted?

No. Successful workflow jobs only confirm builds and tests pass; performance acceptance requires resolved effects above A/A floors plus passing canonical regression gates. Identical-binary controls have shown apparent gains without any code change.