scale-prior-art-survey

Surveys published scaling evidence and synthesizes schema-validated scale envelope indexes for architecture decisions.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill scale-prior-art-survey-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scale-prior-art-survey
Source: https://github.com/bm629/agent-skills/tree/main/skills/scale-prior-art-survey
Command: npx skills add https://github.com/bm629/agent-skills --skill scale-prior-art-survey-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, jsonschema, and includes scripts (resource) and references (resource) components.

What problem does it solve? Before committing to a scaling approach, teams need to know how comparable systems actually behaved under load, but that evidence is scattered across engineering blogs, post-mortems, benchmarks, and papers with no consistent way to collect, date, or compare it. ## Core Features & Use Cases - Four-wave survey pipeline: builds a scale vocabulary map, executes one search angle's coverage grid, extracts one source's episodes, and synthesizes a scale envelope index, each as schema-validated YAML. - Deterministic validation gate: every artifact is checked by scripts/validate_scale_prior_art.py against JSON schemas, with queue-to-record reconciliation and derived load-band and confidence checks. - Evidence discipline: every measurement is recorded with its configuration, date, and load band; undated claims are refused because hardware generations age underneath them. - Use Case: Before writing an ADR for a high-concurrency ingest tier, dispatch the survey to gather dated production episodes and benchmarks, then read the resulting scale envelope index for hard limits, failure modes, and migration triggers. ## Quick Start Use scale-prior-art-survey to survey prior art on tail latency and capacity limits for our ingest tier before we commit to a scaling design.

Frequently Asked Questions about scale-prior-art-survey

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

FAQPage Schema
How do I run a scale prior-art survey before writing an ADR?

Dispatch the skill for one of four artifacts: the wave-0 vocabulary map, one angle's search output, one source's episode extract, or the wave-3 scale envelope index. Each artifact is YAML validated by running scripts/validate_scale_prior_art.py with the matching subcommand.

What evidence sources does a scaling prior-art search cover?

The survey covers ten search angles spanning engineering narratives, systems literature, the operational canon, tail-latency and consistency evidence, incidents, capacity envelopes, benchmarks, inference serving, and multi-tenancy, driven by a 32-row source registry.

Why are undated scaling claims refused by the validator?

A scale claim without a stated date is not re-checkable because what ages is the hardware and managed-service generation underneath it. Candidates enter the extract queue only with both a resolvable URL and a stated date.

How does the scale envelope index relate to the extraction queue?

The gate reconciles the frozen extract-queue.yaml against the extract records in both directions: a queue row with no record fails, and a record no row asked for fails. The index must cite episode ids that resolve to extracted records.

What are the limitations of the deterministic validation gate?

The gate never fetches anything, so it cannot verify that a URL resolves, that an evidence quote supports its claim, or that a quality score is defensible. A clean gate run is necessary but not sufficient; those checks belong to the reviewing twin.