heady-load-forge

Launch phi-ramped load tests and collect p50, p95, and p99 metrics.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/HeadyAI/heady-context --skill heady-load-forge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heady-load-forge
Source: https://github.com/HeadyAI/heady-context/tree/main/heady-skills/heady-load-forge
Command: npx skills add https://github.com/HeadyAI/heady-context --skill heady-load-forge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a scalable framework to validate CSL-gated latency thresholds under phi-ramped loads, ensuring systems meet performance commitments before release.

Core Features & Use Cases

  • Fibonacci-based load stages with phi-driven ramps to simulate realistic traffic patterns.
  • Per-stage latency profiling (p50, p95, p99) across all pipeline segments and providers.
  • CSL performance gates evaluation and coherence scoring to detect regressions.
  • Rich reporting with phi-spaced histograms and bottleneck analysis for capacity planning.

Quick Start

Provide a target URL and tier to start a phi-ramped load test and receive a comprehensive performance report.

Frequently Asked Questions about heady-load-forge

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

FAQPage Schema
How do I run a phi-ramped load test to validate latency thresholds?

To run a phi-ramped load test, provide a target URL and tier to launch Fibonacci-based traffic stages that validate CSL latency gates. You receive a structured payload with per-stage metrics and gate results.

What is phi-ramped load testing and how does it simulate real traffic?

Phi-ramped load testing uses Fibonacci-based stages with phi-driven ramps to simulate realistic traffic patterns against a target service. This approach progressively increases load to accurately profile performance under varying conditions.

Can I collect p50, p95, and p99 latency metrics across all pipeline segments?

Yes, you can collect p50, p95, and p99 latency metrics across all pipeline segments and providers. The test returns per-stage latency profiling and phi-spaced histograms for comprehensive bottleneck analysis.

What's the best way to generate a bottleneck-rich report for capacity planning?

The best way to generate a bottleneck-rich report is executing a phi-ramped load test that evaluates CSL performance gates and coherence scoring. It produces histogram data and detects regressions for capacity planning.

Does load testing with CSL gates require any dependencies or external components?

Load testing with CSL gates requires no external dependencies or components. You simply provide a target URL and tier to launch the test and receive a structured payload suitable for dashboards.