{
 "schema": "aiblocks-page/1",
 "id": "agency-testing-performance-benchmarker",
 "type": "agent",
 "name": "Performance benchmark planner",
 "summary": "Plan a repeatable speed and load test for your site or API. Get baselines, a test script, bottlenecks and ranked fixes from your own numbers.",
 "headline": "Performance benchmark planner",
 "subhead": "Name the page, API or user path to test and the speed goal. The agent builds a baseline table, a load test plan and a ready-to-adapt test script. Paste your results back and it ranks the bottlenecks and the fixes.",
 "job": {
  "id": "test-and-fix-code",
  "name": "Test and fix code"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "What to test, such as a page link, an API endpoint or a path like login then dashboard.",
  "Your speed goal, such as \"95 percent of requests under 500 ms\" (optional). Without one it proposes a goal and marks it as a proposal.",
  "Where you will test (staging or production) and who owns that system.",
  "Past numbers, such as a Lighthouse report, k6 output or server logs (optional).",
  "How many users you expect at peak (optional)."
 ],
 "you_get": [
  "A baseline table of what to measure, the number today (or MISSING) and the target.",
  "A test plan with load, stress, spike and endurance scenarios, and how many runs to do.",
  "A k6 test script to adapt for your path, with notes on what to change first.",
  "A ranked list of bottlenecks, drawn only from results you paste.",
  "Ranked fixes with the effort and the likely gain, marked as an estimate.",
  "A status against your goal: MEETS, FAILS or NOT DETERMINED, with the reason."
 ],
 "use_when": [
  "You are about to launch, run a sale or send a big email, and need to know if the site will hold.",
  "Pages or an API feel slow and you want numbers before you pay for fixes.",
  "You made a speed fix and want proof that it helped.",
  "Your developer asks for \"a performance budget\" and you need one you can check each release."
 ],
 "skip_when": [
  "You want to run a load test on a live production site without the owner's okay: stop, and test a staging copy instead.",
  "You want to read a Shopify speed report in plain words: use the Store speed report analyst.",
  "You want code changes that make one page faster: use the Website speed tuner.",
  "You want to check that an API returns the right answers: use the API test planner.",
  "You have test results to sort by failure cause: use the Test results analyst."
 ],
 "output_sample": {
  "input": [
   "The page, API or path to test",
   "Your speed goal, if you have one (optional)",
   "Where you will test and who owns it",
   "Past numbers such as a Lighthouse report, k6 output or logs (optional)"
  ],
  "prerequisites": [
   "A staging copy of your system, so a load test cannot hurt real customers",
   "k6 or another load test tool, or an AI that can run code (to run the test itself)"
  ],
  "output": [
   {
    "name": "Baseline",
    "contains": "What to measure, today's number or MISSING, and the target for each."
   },
   {
    "name": "Test plan",
    "contains": "Load, stress, spike and endurance scenarios, with users, length, runs and pass rules."
   },
   {
    "name": "Test script",
    "contains": "A k6 script draft with checks and limits, and the lines you must change first."
   },
   {
    "name": "Results read",
    "contains": "Each number you pasted, set against the baseline and the goal."
   },
   {
    "name": "Bottlenecks",
    "contains": "The layers the numbers point to, with the evidence for each."
   },
   {
    "name": "Fixes, ranked",
    "contains": "Fixes ordered by gain and effort, and the re-test that would prove each one."
   },
   {
    "name": "Status",
    "contains": "MEETS, FAILS or NOT DETERMINED against your goal, and the checks still needed."
   }
  ]
 },
 "output_shape": "BASELINE\n  Metric <name> | Today <number or MISSING> | Target <goal> | Source <tool>\n\nTEST PLAN\n  Scenario <load, stress, spike, endurance> | Users <ramp> | Length <time> | Runs <count> | Pass rule <rule>\n\nTEST SCRIPT\n  <k6 script with checks and thresholds, plus what to change first>\n\nRESULTS READ\n  <metric> | <your number> | <vs target> | <meaning>\n\nBOTTLENECKS\n  1. <layer> | Evidence <your number> | Likely cause <cause, marked as a guess if unproven>\n\nFIXES, RANKED\n  <fix> | Effort <low, medium, high> | Likely gain <estimate> | Proof <which re-test result>\n\nSTATUS\n  <MEETS, FAILS or NOT DETERMINED> | Reason <one line> | Checks still needed <list>",
 "how_to_use": [
  "Download the pack. Add it to your AI as a skill, or paste SKILL.md and then references/source-agent.md into a new chat.",
  "Say what you want tested and your goal. Ask for a plan first, such as: Plan a baseline and a test for this page. Do not invent numbers.",
  "Check the baseline table. Fill in the MISSING numbers from your own tools, such as Lighthouse, your host's dashboard or your logs.",
  "Run the test yourself. You need k6 (free) and a staging copy of your system. Claude Code or Codex can run it for you if you allow it.",
  "Paste the raw results back. Ask for the bottleneck list and the ranked fixes.",
  "After each fix, run the same test again and paste the new numbers. Ask for a before and after comparison."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "Slow code fixer",
   "url": "https://useaiblocks.com/skills/slow-code-fixer",
   "why": "Slow code fixer"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/testing/testing-performance-benchmarker.md",
  "licence": "MIT",
  "original_name": "Performance Benchmarker",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Performance Benchmarker",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/testing/testing-performance-benchmarker.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-testing-performance-benchmarker",
  "markdown": "https://useaiblocks.com/agents/agency-testing-performance-benchmarker.md",
  "json": "https://useaiblocks.com/agents/agency-testing-performance-benchmarker.json",
  "instructions": "https://useaiblocks.com/skills/agency-testing-performance-benchmarker/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-testing-performance-benchmarker.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-testing-performance-benchmarker",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-testing-performance-benchmarker",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
